Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HeyGen Photo Avatars API

Photo avatar generation, training, and enhancement endpoints.

HeyGen Photo Avatars API is one of 13 APIs that HeyGen publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Photo Avatars. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 11 operations across 11 paths. It is described by OpenAPI 3.1.0, at version 4.0.8.

Requests are made against a single base URL, https://api.heygen.com.

11 operations 11 paths 0 schemas 3 GET8 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
4.0.8
Base URL
https://api.heygen.com/v3
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

HeyGen Photo Avatars API declares 2 security schemes for authenticating requests. An API key is passed in the header as x-api-key (sec0). An API key is passed in the header as X-API-KEY (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 11

Across 11 paths, the API surfaces 11 operations — 3 GET, 8 POST. Each is listed below with its method, path, parameters, and response codes.

Photo Avatars 11

Photo avatar generation, training, and enhancement endpoints.

POST
/v2/photo_avatar/photo/generate
Generate photo avatar photos
generate-photo-avatar-photos body → 200400
POST
/v2/photo_avatar/look/generate
Generate photo avatar looks
generate-photo-avatar-looks body → 200400
GET
/v2/photo_avatar/generation/{generation_id}
Check photo/look generation status
check-photolook-generation-status 1 param → 200400
POST
/v2/photo_avatar/avatar_group/create
Create photo avatar group
create-photo-avatar-group body → 200400
POST
/v2/photo_avatar/avatar_group/add
Add looks to photo avatar group
add-looks-to-photo-avatar-group body → 200400
POST
/v2/photo_avatar/train
Train photo avatar group
train-photo-avatar-group body → 200400
GET
/v2/photo_avatar/train/status/{group_id}
Get training job status
get-training-job-status 1 param → 200400
POST
/v2/photo_avatar/add_motion
Add motion
add-motion body → 200400
POST
/v2/photo_avatar/add_sound_effect
Add sound effect
add-sound-effect body → 200400
GET
/v2/photo_avatar/{id}
Photo avatar details
photo-avatar-details 1 param → 200400
POST
/v2/photo_avatar/upscale
Upscale an avatar
upscale-an-avatar body → 200400

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

heygen-photo-avatars-api-openapi.yml Raw ↑

Other APIs HeyGen publishes across the network.

HeyGen API
HeyGen Account API
HeyGen Assets API
HeyGen Avatars API
HeyGen Digital Twins API
HeyGen Folders API
HeyGen Streaming API
HeyGen Templates API
HeyGen Video Translation API
HeyGen Videos API
HeyGen Voices API
HeyGen Webhooks API