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

falVideoAvailable nowReleased 2026-02-23

HeyGen Avatar III Digital Twin

fal-ai/heygen/avatar3/digital-twin

Generate 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

FieldKindDefaultDescription
character requiredJSON—

Character configuration for the video

voice requiredJSON—

Voice configuration for the character

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

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