Create Avatar 6 Video
Animates a reference image or video with driving speech audio using Avatar 6 (heygen-avatar-6 or heygen-avatar-6-turbo). Provide one reference image or one reference video, plus audio. Optionally direct the performance with motion_prompt or motion_expressiveness. Returns 202 with a video_id; poll GET /v3/models/videos/. Send an Idempotency-Key to retry safely. To have a saved avatar look speak a script, use POST /v3/videos.
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
Up to one reference video, at least 2 seconds long. A shorter video returns HTTP 400 (invalid_parameter) before a job is created.
1Asset input via publicly accessible HTTPS URL.
- AssetUrl
- AssetId
- AssetBase64

