Create Avatar
Creates a new avatar from an image, video footage, or a text prompt. Supports photo, digital_twin, and prompt types. Avatar training is asynchronous — poll the parent group via Get Avatar Group until status is completed. See the Create Avatar guide.
Documentation Index
Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
HeyGen API key. Obtain from your HeyGen dashboard.
Headers
Optional client-supplied key for safely retrying mutations. Subsequent calls within 24 hours that share this key replay the original response — even if the request body differs slightly (a warning is logged). A retry that arrives while the original is still in flight gets a 409 request_in_progress. Keys must be 1–255 characters from [A-Za-z0-9_:.-]; a UUID is a safe default. Scope is per-endpoint and per-resource: the same key on a different route or path parameter is independent.
1 - 255^[A-Za-z0-9_\-:.]{1,255}$Body
- CreatePromptAvatarRequest
- CreateDigitalTwinRequest
- CreatePhotoAvatarRequest
Discriminated union for POST /v3/avatars request body.
Must be 'prompt' for AI-generated avatars.
"prompt"Name of the avatar.
Prompt for avatar generation.
1000Reference images — each as {"type": "url", "url": "https://..."} or {"type": "asset_id", "asset_id": "..."}. Max 3. Will only work with an avatar_group_id.
3Asset input via publicly accessible HTTPS URL.
- AssetUrl
- AssetId
- AssetBase64
Optional identity you would like to attach the prompted avatar to. By default it will create a new identity.
Response
Successful response

