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

# How to Use HeyGen Avatar V Digital Twin in opencode

HeyGen Avatar V Digital Twin turns scripts or recorded speech into presenter videos with consistent facial detail and gestures learned from video. Compared with HeyGen Avatar IV, it is better suited to realistic human presenters than stylized characters.

|  |  |
| --- | --- |
| Model | HeyGen Avatar V 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 V Digital Twin in opencode

- Read CHANGELOG.md and use HeyGen Avatar V Digital Twin to make a presenter announcement about the latest release. Write 90 words covering the main change, who it helps, and one next step. Use only documented behavior.
- Use HeyGen Avatar V Digital Twin to create an onboarding introduction from this project's README. Write 100 words for a first-time user, explain the purpose before the terminology, and keep production instructions outside the spoken script.
- Read the user documentation and use HeyGen Avatar V Digital Twin to create three separate presenter answers to common questions. Keep each answer under 70 words and cite the supporting project file in your accompanying notes.
- Use HeyGen Avatar V Digital Twin to turn the approved Spanish onboarding copy in this repository into a presenter video. Preserve the reviewed wording and product names. Flag any unclear text before generating.
- Find the approved narration recording referenced in the project and use HeyGen Avatar V Digital Twin to create its presenter segment. Preserve the recorded speech and timing. Keep the presenter separate from any screen demonstration.

## How to set up HeyGen Avatar V 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 V 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/avatar5/digital-twin",
    "input": {
      "prompt": "Hello and welcome to this demonstration of HeyGen Avatar V."
    }
  }'
```

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

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

## HeyGen Avatar V Digital Twin tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| avatar |  | Abigail Sofa Front | Name of the Avatar V-eligible avatar to use. |
| prompt |  | — | Text the avatar will speak. Required when ``audio_url`` is not provided. |
| voice | Warm Pro Narrator, Chill Brian, Ivy, John Doe, Monika Sogam, Hope , Archer , Brittney, Patrick, David Castlemore, Michael C, Adam Stone , Juniper, Cassidy , Jessica Anne Bogart, Arabella, Andrew, Spuds Oxley , Grace Elder, Helen, Canyon Rivers, Derya - Lifelike - Excited 🤩, Mellow Marcus, Jack Sterling - Broadcaster 🎙️, Brenda - UGC - 1.mp4, Reid, Reagan, Terry, Jenny, Radio Rick, Denise, Tim in car - Excited 🤩, Iskander, Thompson, Delicate Daisy - Excited 🤩, Kingston, George UGC 1, Bold Blake, Jane, Expressive Evan, Marianne - IA, Aaron, Modern Recipe Host - Voice 1, Willow, Cute Chloe - Friendly 😊, Rafael, June - Lifelike, Crisp Chloe, Slick Simon, Nassim - Informative, Baritone Ben, Maxwell, Ellie Faye - Excited 🤩, Milani, Feisty Fiona - Excited 🤩, Professor Dean, Rose - UGC - 1.mp4, Shona, Hudson Wilder, Ann - IA, Alastair Kensington, Oxley, Christina, Andrew Rizz , Peyton, Gerardo - Outdoor, Chloe - Lifelike, Stephanie, Anthony - IA, Signal - Voice 1, Luca, Lisa - Voice 1, T.W.Tucker, Jack Sullivan - Serious 😐, Winter, Mireia - Lifelike, Georgia, Stella, Masha - Lifelike, Charming Charles - Friendly 😊, Serenity, Annie - Excited, Ralph, Bethany, Dominic, Mason Finn, Leena, Veteran Victor, Tamara, Nik Public, Calm Chloe, Sevik, Reilly, Raul, Imposing Ian, Relaxed Ray, Dexter - Professional, Relaxed Rick, Edwin, Rupert Blackwood, Ginny, Hope | Warm Pro Narrator | Name of the text-to-speech voice to use for the avatar when ``audio_url`` is not provided. |
| audio_url |  | — | HTTP(S) URL of an audio file for the avatar to lip-sync to. When provided, the avatar uses this audio instead of text-to-speech and ``prompt``/``voice`` are ignored. |
| fit | contain, cover | cover | How the avatar fits within the output frame. 'contain' keeps the full avatar in view (may letterbox); 'cover' fills the frame (may crop). |
| remove_background |  | false | Remove the avatar's background. Requires a matting-enabled avatar. |

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

Turn project documentation and release notes into presenter videos for users. A coding agent can prepare accurate narration from the repository and keep it aligned with documented behavior.

### Feature announcement presenter

Turn approved release notes into a short presenter video explaining the change, who benefits, and the next action.

### Customer onboarding lessons

Create one presenter lesson per task, such as inviting a teammate or completing a first project. Update the narration when the instructions change.

### Employee training introductions

Give each training module a consistent presenter who introduces the topic and explains what employees should learn.

### Multilingual customer education

Render reviewed translations of the same explanation for different audiences while keeping a consistent on-screen presenter.

### Recorded narration to presenter video

Use an approved voice recording as the basis for a lip-synced presenter segment in a lesson or product explanation.

### Recurring team updates

Convert an approved weekly summary into a presenter briefing covering completed work, upcoming milestones, and decisions.

### Video answers to common questions

Create a separate presenter answer for each common customer question, using approved support wording and a concrete next step.

## Overview

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

## HeyGen Avatar V Digital Twin in other agents

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

## More opencode guides

- [HeyGen Avatar IV Digital Twin](https://spiral.ai/integrations/opencode/heygen-avatar-iv-digital-twin)
- [HeyGen Filler Word Removal](https://spiral.ai/integrations/opencode/heygen-filler-word-removal)
- [HeyGen Avatar IV](https://spiral.ai/integrations/opencode/heygen-avatar-iv)
- [HeyGen Lipsync Precision](https://spiral.ai/integrations/opencode/heygen-lipsync-precision)
- [HeyGen Avatar III Digital Twin](https://spiral.ai/integrations/opencode/heygen-avatar-iii-digital-twin)
- [HeyGen Lipsync Speed](https://spiral.ai/integrations/opencode/heygen-lipsync-speed)

## Questions about HeyGen Avatar V Digital Twin in opencode

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

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

**How much does HeyGen Avatar V 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 V Digital Twin in opencode?**

No. Spiral runs HeyGen Avatar V 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 V Digital Twin in opencode?**

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

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

HeyGen Avatar V 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 V best for?**

Use it for a human presenter delivering explanations, lessons, announcements, or customer education. Its focus is preserving the speaker's appearance and characteristic expressions and gestures.

**How does Avatar V compare with Avatar IV?**

HeyGen recommends Avatar V for realistic human presenters and consistent identity. Avatar IV is the stronger choice for illustrated, 3D, or other virtual characters.

**Which languages does Avatar V support?**

Avatar V supports more than 175 languages and dialects with lip synchronization, including English, Spanish, and Japanese. Have a fluent speaker review translated scripts before generating the final video.

**What resolution and video length can Avatar V produce?**

HeyGen's technical report describes 1080p output and generation of unlimited duration at the model level. That is not a verified maximum duration or resolution guarantee for this particular endpoint.

**How should I write an Avatar V script?**

Write sentences that sound natural aloud, with short clauses and punctuation that makes the pacing clear. Keep the spoken script separate from production instructions.

