HeyGen Avatar 6 Reference · Video to Video
heygen/avatar-6/ref-video-to-videoEdit 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
| Field | Kind | Default | Description |
|---|---|---|---|
resolution | one of 1080p, 2k | 1080p | Output resolution. |
motion_prompt | text | — | Optional direction for the avatar's motion and expression. |
video_url required | URL or file | — | URL of a reference video of an animated or illustrated character. Videos of real people are not supported. |
image_url | URL or file | — | Optional URL of a reference photo of the same character. |
audio_url required | URL 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.