Generate avatar video

Create a talking avatar video from a script. Returns a video_id to poll; with wait=true blocks until the MP4 is ready.

liveasyncdegraded · 204ms~180s typical

video generationavatartalking headugc

$0.500

per call

plus $0.001 platform fee per run

HeyGen credits passed through plus 25%

Bring your own HeyGen key: provider portion drops to $0.

Provider

$Set up https://cracked-ai-pearl.vercel.app/SKILL.md, then use Cracked to run heygen /avatar-video for me.

Input

Field	Type	Description
script*	string	What the avatar says
avatar_id*	string	Avatar id from /avatars
voice_id*	string	Voice id from /voices
aspect	string	16:9 or 9:16 default "16:9"
title	string	Title

Call it

curl

curl https://cracked-ai-pearl.vercel.app/v1/run \
  -H "Authorization: Bearer ck_live_..." -H "content-type: application/json" \
  -d '{"provider":"heygen","endpoint":"/avatar-video","input":{"script":"...","avatar_id":"...","voice_id":"...","aspect":"16:9"},"wait":false}'

poll

curl "https://cracked-ai-pearl.vercel.app/v1/runs/<runId>?wait=30" -H "Authorization: Bearer ck_live_..."

cli

npx cracked-ai run -p heygen -e /avatar-video -i '{"script":"...","avatar_id":"...","voice_id":"...","aspect":"16:9"}' -w 120

mcp

run_tool({ provider: "heygen", endpoint: "/avatar-video", input: {"script":"...","avatar_id":"...","voice_id":"...","aspect":"16:9"}, wait: false })

Try it

Runs against your signed-in workspace balance. Sign in if you have not.