HeyGen Avatar III Digital Twin
fal-ai/heygen/avatar3/digital-twinGenerate and edit video with HeyGen Avatar III Digital Twin from fal through one Spiral API key. Heygen Avatar V3 Model for Digital Twin. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
Up to $0.221 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 | 16:9 | Aspect ratio of the output video. Use '9:16' for portrait (vertical) videos, '16:9' for landscape, '1:1' for square, '4:5' for portrait social video, or '5:4' for landscape social 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/avatar3/digital-twin",
"input": {
"character": {
"avatar": "Florin Business Sitting Side"
},
"voice": {}
}
}'Frequently asked questions
How much does HeyGen Avatar III Digital Twin cost?
Up to $0.221 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 III Digital Twin through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/heygen/avatar3/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 III Digital Twin?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use HeyGen Avatar III Digital Twin?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.