HeyGen Video Agent API

HeyGen's flagship agent: give it a prompt and it produces a complete video end-to-end — writing the script, choosing the avatar, and composing scenes. Attach reference files (images, docs) to ground the output.

$0.126/s on Varosity credits ($0.120/s with your own key). Clips up to 600s with native audio.

Try HeyGen Video Agent Get an API key

no heygen account needed · no subscription · failed renders never billed

Best for

prompt → finished video
agent writes script, picks avatar & scenes
accepts reference files

Trade-offs

least granular control
longer render

Call it from your code

One Varosity key works for every model. Video renders are async — the response has a jobId; poll GET /api/v1/jobs/{jobId} until status is "succeeded", then read outputUrl.

curl -X POST https://varosity.ai/api/v1/video/generate \
  -H "Authorization: Bearer $VAROSITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "cinematic aerial of a coastal road at golden hour, slow push-in",
    "modelId": "heygen-video-agent",
    "aspectRatio": "16:9",
    "durationSec": 5
  }'

Or ask your agent

Connect Claude, Cursor, or any MCP client to https://varosity.ai/api/mcp with your key, then say:

"Use Varosity with heygen-video-agent to make a 5-second clip of …"

Agent setup guide