# HeyGen Avatar IV Photo 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.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Released: 2026-02-23
- Tool id: `fal` / `fal-ai/heygen/avatar4/image-to-video`
- Page: https://spiral.ai/tools/fal/fal-ai/heygen/avatar4/image-to-video

## 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

- 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 | Allowed | 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 |

## Example

```bash
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"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fheygen%2Favatar4%2Fimage-to-video

## Common questions

### HeyGen Avatar IV Photo to Video

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

