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

falVideoAvailable nowReleased 2026-02-23

HeyGen Avatar IV Digital Twin

fal-ai/heygen/avatar4/digital-twin

Generate 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

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