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

Claude Code · VideoReleased 2026-02-23

How to Use HeyGen Avatar IV Digital Twin in Claude 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.

Prompts to try with HeyGen Avatar IV Digital Twin in Claude Code

Copy an example into Claude Code, or ask in your own words.

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.

HeyGen Avatar IV Digital TwinClaude Code
Try asking
  • 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 Claude Code

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

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude 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.

    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.

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

HeyGen Avatar IV Digital Twin providers and prices

Spiral runs HeyGen Avatar IV Digital Twin through fal. Open a card for today's price, with every fee included.

falVideo
HeyGen Avatar IV Digital Twin
fal-ai/heygen/avatar4/digital-twin

Settings you can ask for

HeyGen Avatar IV Digital Twin works from your audio URL. Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Resolution360p, 480p, 540p, 720p, or 1080p720p

Video resolution preset. Options: 360p, 480p, 540p, 720p, 1080p

Aspect ratio16:9, 9:16, 4:5, 5:4, 1:1, or auto16: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.

Every API field of HeyGen Avatar IV Digital Twin is on its tool page: open its card above.

What can you do with HeyGen Avatar IV Digital Twin in Claude 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.

Questions about HeyGen Avatar IV Digital Twin in Claude Code

Can Claude Code use HeyGen Avatar IV Digital Twin?

Yes. Add Spiral to Claude Code as an MCP server, and Claude 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 Claude 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 Claude Code plan is separate.

Do I need a fal account to use HeyGen Avatar IV Digital Twin in Claude 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 Claude Code?

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

Does Claude Code wait while HeyGen Avatar IV Digital Twin runs?

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

Get started

Start using HeyGen Avatar IV Digital Twin in Claude Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude Code:

Set up Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options