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

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

## Pricing

Up to $0.221 per run at the default inputs.

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

## 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/avatar3/digital-twin",
    "input": {
      "character": {
        "avatar": "Florin Business Sitting Side"
      },
      "voice": {}
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fheygen%2Favatar3%2Fdigital-twin

## Common questions

### HeyGen Avatar III Digital Twin

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

