What you can build
Start from your own media
Send a prompt, photo, recording or text straight to the latest HeyGen model. Nothing to set up in HeyGen first.
Video
HeyGen Video 1. Prompt or image to video with sound.
Avatar
HeyGen Avatar 6. Photo and voice to a talking video.

Voice
HeyGen Voice 1. Speech from text or a recording.

Image
HeyGen Image 1. One identity, any scene.
Build on what you set up in HeyGen
Reuse your avatars, voices, brand kits and templates, referenced by ID.
Video
Avatar video, Video Agent, Studio, Templates.
Avatar and Voice
Your avatars and voice clones.

Brand
Brand kits and glossaries.

Realtime Video
Live, conversational avatars.

Video Translation
175+ languages with lip-sync.

Lipsync
New audio on an existing video.

Tools
Music, sound effects, clipping, cleanup.

Batches
Up to 100 requests in one call.
Start with your agent
Paste this into Claude Code, Codex, or Cursor. It reads the whole API, sets up your key, and makes your first video with you.Prompt for your agent
Your first video
Get your API key
Create a key in the API dashboard. Every request below needs it.
Try it in the Playground
Fire a real request from your browser before writing any code.
Base URL
https://api.heygen.com · Auth header X-Api-Key: <your-key>Authenticate
Create a key in the API keys page. For key rotation, see the API Key guide.
Create a video
Call a model directly. Pass public URLs for your photo and recording, or upload them and pass an
asset_id.- HeyGen Avatar 6
- HeyGen Video
A photo and a voice recording become a talking video. See HeyGen Avatar 6.
Response
Get the result
Both models return their video on
GET /v3/models/videos/{video_id}. Poll until status is completed, then download video_url.- Python
- curl
Response (completed)
Working from an agent or terminal?
Skip the raw HTTP. Both surfaces wrap the same API.MCP Server
Plug HeyGen into Claude, Cursor, or any MCP-capable agent. It handles the calls for you.
CLI
heygen video create, heygen video download. Scriptable from any shell or CI job.Build with your stack
Webhooks
Authentication
Usage Limits
Still calling v1/v2? Those endpoints passed their October 31, 2026 sunset and are being removed. Calls to them may fail intermittently, so move to v3: see the version comparison.
Troubleshooting
Video status is failed
Video status is failed
Inspect
failure_code and failure_message on GET /v3/videos/{video_id}. Full catalog in Error Codes.429 Too Many Requests
429 Too Many Requests
Rate or concurrency limit hit. Respect
Retry-After and back off. Enterprise plans get higher limits; see Usage Limits.400 download_failed
400 download_failed
A URL you passed couldn’t be fetched. It must be publicly accessible and point directly at the file.

