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

# How to Use HeyGen Avatar IV Digital Twin in Muse Code

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 Muse Code

- 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 Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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: Muse Code finds HeyGen Avatar IV Digital Twin on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## 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 Muse Code?

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 Muse Code guides](https://spiral.ai/integrations/muse-code)

## 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)
- [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)
- [opencode](https://spiral.ai/integrations/opencode/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 Muse Code guides

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

## Questions about HeyGen Avatar IV Digital Twin in Muse Code

**Can Muse Code use HeyGen Avatar IV Digital Twin?**

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

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

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 Muse Code plan is separate.

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

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 Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while HeyGen Avatar IV Digital Twin runs?**

HeyGen Avatar IV Digital Twin runs in the background. Muse Code 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.

