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

falVideoAvailable nowReleased 2026-02-23

HeyGen Avatar IV Photo to Video

fal-ai/heygen/avatar4/image-to-video

Turn 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

FieldKindDefaultDescription
image_url requiredURL or file—

URL of the image to animate. The image should contain a clear face.

prompttext—

The text the avatar will speak

voiceone 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_urlURL or file—

URL of an audio file for the avatar to lip-sync to. When provided, overrides prompt and voice.

talking_styleone of
stable, expressive
stable

Talking style - 'stable' for minimal movement, 'expressive' for more animation

expressiontext—

Facial expression

backgroundJSON—

Background configuration

resolutionone of
360p, 480p, 540p, 720p, 1080p
720p

Video resolution preset. Options: 360p, 480p, 540p, 720p, 1080p

aspect_ratioone 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.

captiontrue or falsefalse

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.