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

Muse Code · VideoReleased 2026-02-23

How to Use HeyGen Avatar IV in Muse Code

HeyGen Avatar IV turns a single photo into a speaking presenter for explainers, training, and updates. Its audio-driven expressions also suit illustrated and 3D characters with clearly readable faces.

Prompts to try with HeyGen Avatar IV in Muse Code

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

Use HeyGen Avatar IV with the presenter portrait in this project to explain the latest changelog entry. Write about 60 spoken words covering the change and its practical benefit, then generate a video with restrained movement.

HeyGen Avatar IVMuse Code
Try asking
  • Read this project's onboarding documentation and use HeyGen Avatar IV with its presenter image to make a welcome video. Explain the product's purpose and one first action in about 50 words.

  • Use HeyGen Avatar IV and the project's instructor portrait to introduce the authentication guide. Base the script on the documentation, keep it under 70 words, and use punctuation that gives the explanation natural pauses.

  • Find one recurring question in the project's support documentation. Use HeyGen Avatar IV with the support presenter image to deliver a direct answer in about 60 words, with a calm expression and minimal movement.

  • Use HeyGen Avatar IV with the project's illustrated guide image to introduce its tutorial. Check that the character has clear eyes and lips, write a 40-word introduction, and choose expressive movement.

How to set up HeyGen Avatar IV in Muse Code

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

Use Spiral's MCP server

  1. Install Muse Code
    curl -fsSL https://dev.meta.ai/install.sh | bash
  2. Ask Muse to add the server

    Start muse and ask:

    Add the Spiral MCP server at https://api.spiral.ai/mcp
  3. Sign in

    In your terminal, run:

    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.

    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

    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/image-to-video",
        "input": {
          "image_url": "https://v3b.fal.media/files/b/0a90062c/A7EIviZqNxZ2HAs0yHeZ6_77a05b99-8588-4ffc-90aa-be7f9d34e9d3.png"
        }
      }'

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

HeyGen Avatar IV providers and prices

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

falVideo
HeyGen Avatar IV Photo to Video
fal-ai/heygen/avatar4/image-to-video

Settings you can ask for

HeyGen Avatar IV works from your image URL, prompt, and audio URL. Ask Muse Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
VoiceWarm Pro Narrator, Chill Brian, Ivy, John Doe, Monika Sogam, Hope , Archer , Brittney and 94 more

Name of the voice to use for the avatar

Talking stylestable or expressivestable

Talking style - 'stable' for minimal movement, 'expressive' for more animation

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.

Captionon or offoff

Whether to add captions to the video

Every API field of HeyGen Avatar IV Photo to Video is on its tool page: open its card above.

What can you do with HeyGen Avatar IV in Muse Code?

Turn project documentation into presenter videos for releases, onboarding, and support with HeyGen Avatar IV. A coding agent can extract the relevant details, draft spoken copy, and pair it with a presenter image from the project.

Product release explainers

Animate a product expert's portrait to explain one change, who benefits, and what to try first. Use a short spoken script based on the approved release notes.

Customer onboarding welcomes

Turn a presenter's photo into a welcome that introduces the product and gives new customers one clear next action.

Support answer videos

Use a support presenter's portrait to deliver a concise answer to a recurring question. Keep each clip focused on one problem and its resolution.

Employee training introductions

Animate an instructor's photo to introduce a lesson, explain its purpose, and state what employees should learn.

Weekly team updates

Turn an approved summary and a presenter's portrait into a brief update covering completed work, upcoming priorities, and one action for the audience.

Character-led lessons

Give an illustrated or 3D guide a spoken explanation for a learning activity. Choose a design with clear eyes and lips rather than an exaggerated or obscured face.

Social announcement videos

Animate a spokesperson's portrait for a short announcement with one message and a clear closing line. Match the voice's energy to the announcement.

Questions about HeyGen Avatar IV in Muse Code

Can Muse Code use HeyGen Avatar IV?

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

How much does HeyGen Avatar IV cost in Muse Code?

$0.13 per second of output video. The video is as long as the audio, or the spoken script when there is none. 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 in Muse Code?

No. Spiral runs HeyGen Avatar IV 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 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 runs?

HeyGen Avatar IV 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 good at?

Use it for a presenter delivering a scripted explanation, update, lesson, or customer message. It turns a single photo into speech with facial expressions and gestures.

Can HeyGen Avatar IV animate a cartoon or 3D character?

Yes. HeyGen recommends Avatar IV for virtual characters, including 2D, 3D, and non-human avatars. Choose a character with a readable face and proportions close to a human face.

Why does lip sync look weak on some characters?

Highly exaggerated facial proportions can reduce lip-sync accuracy and facial movement. Start with a character whose eyes, mouth, and lips are easy to distinguish.

How should I write an Avatar IV script?

Write the words the presenter should say, then punctuate them to reflect the intended pacing. Avatar IV reads pacing and punctuation from the script, so review the text aloud before generating.

How can I make the performance more expressive?

Match the vocal delivery to the intended mood because Avatar IV uses tone, rhythm, and emotion to drive expressions. For a more animated performance, choose the expressive talking style.

Get started

Start using HeyGen Avatar IV in Muse Code

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

Paste this into Muse Code:

Set up Muse Code

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