[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [HeyGen Avatar IV Digital Twin](https://spiral.ai/integrations/opencode/heygen-avatar-iv-digital-twin)

# How to Use HeyGen Avatar IV Digital Twin in opencode

HeyGen Avatar IV Digital Twin makes talking-presenter videos for lessons, product explanations, and personal messages. It uses an avatar built from recorded footage, with facial expressions shaped by the narration's tone, rhythm, and emotion.

|  |  |
| --- | --- |
| Model | HeyGen Avatar IV Digital Twin |
| Available through | fal |
| Category | Video |
| Price | Up to $0.65 per run at the default inputs. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with HeyGen Avatar IV Digital Twin in opencode

- Read CHANGELOG.md and draft a spoken release summary with short sentences. Use the approved recording at media/release-summary.wav with HeyGen Avatar IV Digital Twin to create a 1080p presenter segment.
- Use HeyGen Avatar IV Digital Twin with media/onboarding.wav to make a 720p presenter draft. Compare its narration with README.md and flag any outdated instructions before final editing.
- Read docs/quickstart.md and outline a tutorial with separate presenter and screen-recording segments. Render media/quickstart-intro.wav with HeyGen Avatar IV Digital Twin at 1080p for the opening.
- Create a 1080p presenter video from media/feature-overview.wav using HeyGen Avatar IV Digital Twin. Keep the interface demonstration as a separate clip in the project's video edit.
- Use HeyGen Avatar IV Digital Twin to render media/faq-answer.wav at 720p. Check the spoken terminology against docs/faq.md and list corrections needed in the narration.

## How to set up HeyGen Avatar IV Digital Twin in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run HeyGen Avatar IV Digital Twin**: One request; the result comes back by polling or a webhook.

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

Then paste one of the prompts above: opencode finds HeyGen Avatar IV Digital Twin on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## HeyGen Avatar IV Digital Twin tools and prices

- [HeyGen Avatar IV Digital Twin](https://spiral.ai/tools/fal/fal-ai/heygen/avatar4/digital-twin) (fal): Up to $0.65 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| audio_url |  | — | 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 | 360p, 480p, 540p, 720p, 1080p | 720p | Video resolution preset. Options: 360p, 480p, 540p, 720p, 1080p |
| aspect_ratio | 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. |

## What can you do with HeyGen Avatar IV Digital Twin in opencode?

Turn project explanations into presenter videos for release announcements, onboarding, and tutorials. Use project files to prepare accurate narration, then render an approved recording and add screen footage separately.

### Release announcements

Turn approved release narration into a presenter video explaining what changed and who benefits.

### Short training lessons

Create a presenter segment for one procedure or concept, then pair it with supporting slides during editing.

### Customer welcome messages

Use a warm recorded greeting to introduce the next steps for a new customer.

### Product explanations

Give a product overview a visible presenter, with screen recordings added separately where viewers need to see the interface.

### Answers to common questions

Make a short presenter video answering one recurring question with an approved explanation.

### Recurring team updates

Convert approved weekly narration into a presenter briefing covering decisions, progress, and next steps.

### Event introductions

Create a recorded presenter introduction that welcomes attendees and explains the session's purpose.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## HeyGen Avatar IV Digital Twin in other agents

- [Amp](https://spiral.ai/integrations/amp/heygen-avatar-iv-digital-twin)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/heygen-avatar-iv-digital-twin)
- [Claude](https://spiral.ai/integrations/claude-desktop/heygen-avatar-iv-digital-twin)
- [Claude Code](https://spiral.ai/integrations/claude-code/heygen-avatar-iv-digital-twin)
- [Cline](https://spiral.ai/integrations/cline/heygen-avatar-iv-digital-twin)
- [Codex](https://spiral.ai/integrations/codex/heygen-avatar-iv-digital-twin)
- [Cursor](https://spiral.ai/integrations/cursor/heygen-avatar-iv-digital-twin)
- [Devin](https://spiral.ai/integrations/devin/heygen-avatar-iv-digital-twin)
- [dots](https://spiral.ai/integrations/dots/heygen-avatar-iv-digital-twin)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/heygen-avatar-iv-digital-twin)
- [Gemini](https://spiral.ai/integrations/gemini/heygen-avatar-iv-digital-twin)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/heygen-avatar-iv-digital-twin)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/heygen-avatar-iv-digital-twin)
- [goose](https://spiral.ai/integrations/goose/heygen-avatar-iv-digital-twin)
- [Grok](https://spiral.ai/integrations/grok/heygen-avatar-iv-digital-twin)
- [Grok Build](https://spiral.ai/integrations/grok-build/heygen-avatar-iv-digital-twin)
- [Hermes](https://spiral.ai/integrations/hermes/heygen-avatar-iv-digital-twin)
- [Instinct](https://spiral.ai/integrations/instinct/heygen-avatar-iv-digital-twin)
- [Manus](https://spiral.ai/integrations/manus/heygen-avatar-iv-digital-twin)
- [Muse](https://spiral.ai/integrations/muse/heygen-avatar-iv-digital-twin)
- [Muse Code](https://spiral.ai/integrations/muse-code/heygen-avatar-iv-digital-twin)
- [n8n](https://spiral.ai/integrations/n8n/heygen-avatar-iv-digital-twin)
- [Notion](https://spiral.ai/integrations/notion/heygen-avatar-iv-digital-twin)
- [OpenClaw](https://spiral.ai/integrations/openclaw/heygen-avatar-iv-digital-twin)
- [Perplexity](https://spiral.ai/integrations/perplexity/heygen-avatar-iv-digital-twin)
- [Raycast](https://spiral.ai/integrations/raycast/heygen-avatar-iv-digital-twin)
- [VS Code](https://spiral.ai/integrations/vscode/heygen-avatar-iv-digital-twin)
- [Windsurf](https://spiral.ai/integrations/windsurf/heygen-avatar-iv-digital-twin)
- [Zapier](https://spiral.ai/integrations/zapier/heygen-avatar-iv-digital-twin)

## More opencode guides

- [HeyGen Avatar IV](https://spiral.ai/integrations/opencode/heygen-avatar-iv)
- [HeyGen Avatar V Digital Twin](https://spiral.ai/integrations/opencode/heygen-avatar-v-digital-twin)
- [HeyGen Avatar III Digital Twin](https://spiral.ai/integrations/opencode/heygen-avatar-iii-digital-twin)
- [HeyGen Filler Word Removal](https://spiral.ai/integrations/opencode/heygen-filler-word-removal)
- [Hedra Character 3](https://spiral.ai/integrations/opencode/hedra-character-3)
- [HeyGen Lipsync Precision](https://spiral.ai/integrations/opencode/heygen-lipsync-precision)

## Questions about HeyGen Avatar IV Digital Twin in opencode

**Can opencode use HeyGen Avatar IV Digital Twin?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run HeyGen Avatar IV Digital Twin like any built-in tool.

**How much does HeyGen Avatar IV Digital Twin cost in opencode?**

Up to $0.65 per run at the default inputs. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need a fal account to use HeyGen Avatar IV Digital Twin in opencode?**

No. Spiral runs HeyGen Avatar IV Digital Twin on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up HeyGen Avatar IV Digital Twin in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while HeyGen Avatar IV Digital Twin runs?**

HeyGen Avatar IV Digital Twin runs in the background. opencode starts the run, checks on it and gives you the video when it's ready.

**What is HeyGen Avatar IV Digital Twin good for?**

Use it for presenter-led explanations, lessons, updates, and personal messages. Its focus is a person delivering narration with matching facial movement.

**What shapes the presenter's expression?**

Avatar IV analyzes the narration's vocal tone, rhythm, and emotion. Choose a recording whose delivery already suits the message, such as a warm welcome or a measured explanation.

**How should I write narration for Avatar IV?**

Write for speaking: use short sentences and clear punctuation. When preparing synthesized narration, commas create short pauses, periods separate sentences, and ellipses create longer pauses.

**Does Avatar IV generate native 4K video?**

No. HeyGen says Avatar IV API output is not native 4K; a 4K request on HeyGen's API produces an upscaled 1080p render.

**Which visual details need careful review?**

Check clothing logos, lettering, and busy patterns. HeyGen warns that these can produce artifacts or distortions in avatar Looks.

