Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable now

HeyGen Avatar 6 Reference · Video to Video

heygen/avatar-6/ref-video-to-video

Edit and transform video with HeyGen Avatar 6 Reference · Video to Video from fal through one Spiral API key. HeyGen Avatar 6 animates an animated or illustrated character from a reference video into a talking video lip-synced to a supplied speech track, with an optional reference photo of the same character. Videos of real people are not supported. Output is 1080p or 2K. It runs in the background and returns video. Pay as you go, with no subscription.

Pricing

Up to $7.80 per run at the default inputs for 60 seconds of input. resolution: 1080p (default) $7.80, 2k $11.31.

Limits

Runs
In the background
Returns
video
Longest queue wait
1 hour
Run deadline
1 hour
Longest run, end to end
930 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
resolutionone of
1080p, 2k
1080p

Output resolution.

motion_prompttext—

Optional direction for the avatar's motion and expression.

video_url requiredURL or file—

URL of a reference video of an animated or illustrated character. Videos of real people are not supported.

image_urlURL or file—

Optional URL of a reference photo of the same character.

audio_url requiredURL or file—

URL of the speech audio. It sets the video length.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "heygen/avatar-6/ref-video-to-video",
    "input": {
      "video_url": "https://v3b.fal.media/files/b/0ab2b575/0eH80do4MnO_TpIw8EtOa_Pd3QnkN8.mp4",
      "audio_url": "https://v3b.fal.media/files/b/0ab0e602/eeEMX2kTC9XI8yzGCEi1w_a.mp3"
    }
  }'

Frequently asked questions

How much does HeyGen Avatar 6 Reference · Video to Video cost?

Up to $7.80 per run at the default inputs for 60 seconds of input. `resolution`: 1080p (default) $7.80, 2k $11.31. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use HeyGen Avatar 6 Reference · Video to Video through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "heygen/avatar-6/ref-video-to-video"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use HeyGen Avatar 6 Reference · Video to Video?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use HeyGen Avatar 6 Reference · Video to Video?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.