HeyGen Avatar IV Digital Twin
fal-ai/heygen/avatar4/digital-twinGenerate and edit video with HeyGen Avatar IV Digital Twin from fal through one Spiral API key. Heygen Avatar 4 Digital Twin Model. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
Up to $0.65 per run at the default inputs.
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 |
|---|---|---|---|
character required | JSON | — | Character configuration for the video |
voice required | JSON | — | Voice configuration for the character |
audio_url | URL or file | — | URL of an audio file for the avatar to lip-sync to. When provided, the avatar uses this audio instead of text-to-speech. |
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. |
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/digital-twin",
"input": {
"character": {
"avatar": "Florin Business Sitting Side"
},
"voice": {}
}
}'Frequently asked questions
How much does HeyGen Avatar IV Digital Twin cost?
Up to $0.65 per run at the default inputs. 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 Digital Twin through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/heygen/avatar4/digital-twin"` 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 Digital Twin?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use HeyGen Avatar IV Digital Twin?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.