HeyGen Avatar IV Photo to Video
fal-ai/heygen/avatar4/image-to-videoTurn images into video with HeyGen Avatar IV Photo to Video from fal through one Spiral API key. Heygen Photo Avatar 4 Model. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
$0.13 per second of output video. The video is as long as the audio, or the spoken script when there is none.
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 |
|---|---|---|---|
image_url required | URL or file | — | URL of the image to animate. The image should contain a clear face. |
prompt | text | — | The text the avatar will speak |
voice | one of Warm Pro Narrator, Chill Brian, Ivy, John Doe, Monika Sogam, Hope , Archer , Brittney, Patrick, David Castlemore, Michael C, Adam Stone , Juniper, Cassidy , Jessica Anne Bogart, Arabella, Andrew, Spuds Oxley , Grace Elder, Helen, Canyon Rivers, Derya - Lifelike - Excited 🤩, Mellow Marcus, Jack Sterling - Broadcaster 🎙️, Brenda - UGC - 1.mp4, Reid, Reagan, Terry, Jenny, Radio Rick, Denise, Tim in car - Excited 🤩, Iskander, Thompson, Delicate Daisy - Excited 🤩, Kingston, George UGC 1, Bold Blake, Jane, Expressive Evan, Marianne - IA, Aaron, Modern Recipe Host - Voice 1, Willow, Cute Chloe - Friendly 😊, Rafael, June - Lifelike, Crisp Chloe, Slick Simon, Nassim - Informative, Baritone Ben, Maxwell, Ellie Faye - Excited 🤩, Milani, Feisty Fiona - Excited 🤩, Professor Dean, Rose - UGC - 1.mp4, Shona, Hudson Wilder, Ann - IA, Alastair Kensington, Oxley, Christina, Andrew Rizz , Peyton, Gerardo - Outdoor, Chloe - Lifelike, Stephanie, Anthony - IA, Signal - Voice 1, Luca, Lisa - Voice 1, T.W.Tucker, Jack Sullivan - Serious 😐, Winter, Mireia - Lifelike, Georgia, Stella, Masha - Lifelike, Charming Charles - Friendly 😊, Serenity, Annie - Excited, Ralph, Bethany, Dominic, Mason Finn, Leena, Veteran Victor, Tamara, Nik Public, Calm Chloe, Sevik, Reilly, Raul, Imposing Ian, Relaxed Ray, Dexter - Professional, Relaxed Rick, Edwin, Rupert Blackwood, Ginny, Hope | — | Name of the voice to use for the avatar |
audio_url | URL or file | — | URL of an audio file for the avatar to lip-sync to. When provided, overrides prompt and voice. |
talking_style | one of stable, expressive | stable | Talking style - 'stable' for minimal movement, 'expressive' for more animation |
expression | text | — | Facial expression |
background | JSON | — | Background configuration |
resolution | one of 360p, 480p, 540p, 720p, 1080p | 720p | Video resolution preset. Options: 360p, 480p, 540p, 720p, 1080p |
aspect_ratio | one of 16:9, 9:16, 4:5, 5:4, 1:1, auto | 16:9 | Aspect ratio of the output video. Supported values: '16:9', '9:16', '4:5', '5:4', '1:1', and 'auto'. 'auto' preserves the source aspect ratio when HeyGen can read it, falling back to '16:9' otherwise. |
caption | true or false | false | Whether to add captions to the video |
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": "fal-ai/heygen/avatar4/image-to-video",
"input": {
"image_url": "https://v3b.fal.media/files/b/0a90062c/A7EIviZqNxZ2HAs0yHeZ6_77a05b99-8588-4ffc-90aa-be7f9d34e9d3.png"
}
}'Frequently asked questions
How much does HeyGen Avatar IV Photo to Video cost?
$0.13 per second of output video. The video is as long as the audio, or the spoken script when there is none. 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 IV Photo to Video through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/heygen/avatar4/image-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 IV Photo to Video?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use HeyGen Avatar IV Photo to Video?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.