[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [HeyGen Video Image to Video](https://spiral.ai/integrations/muse-code/heygen-video-image-to-video)

# How to Use HeyGen Video Image to Video in Muse Code

HeyGen Video Image to Video animates a still into a 5 to 15 second clip with sound. Unlike HeyGen Video Reference to Video, it uses your image as the opening frame, making it useful when the starting composition matters.

|  |  |
| --- | --- |
| Model | HeyGen Video Image to Video |
| Available through | fal |
| Category | Video |
| Price | `resolution`: 480p $0.026, 768p (default) $0.026, 2k $0.078, 1080p $0.078 per second. Billed on `duration`, default 5. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with HeyGen Video Image to Video in Muse Code

- Use HeyGen Video Image to Video with the approved hero still in the project. Make a 5-second clip at 768p with a very slow push-in and quiet room sound. Preserve the opening composition and keep the product stationary.
- Use HeyGen Video Image to Video with the project's approved character illustration. Generate a 5-second clip at 768p where the character turns its head slightly toward the camera. Keep the framing still and request a quiet background with no dialogue.
- Animate the image I attach with HeyGen Video Image to Video: slow push-in, leaves moving in the wind. Save the result in ./assets.
- Turn this product photo into a 5-second rotating shot with HeyGen Video Image to Video.
- Bring this portrait to life with HeyGen Video Image to Video: a subtle smile and a blink.

## How to set up HeyGen Video Image to Video 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 Video Image to Video**: 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": "heygen/heygen-video/image-to-video",
    "input": {
      "prompt": "<prompt>",
      "image_url": "<image_url>"
    }
  }'
```

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

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

## HeyGen Video Image to Video tools and prices

- [HeyGen Video Image to Video](https://spiral.ai/tools/fal/heygen/heygen-video/image-to-video) (fal): `resolution`: 480p $0.026, 768p (default) $0.026, 2k $0.078, 1080p $0.078 per second. Billed on `duration`, default 5.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| duration | 5 to 15 | 5 |  |
| resolution | 480p, 768p, 1080p, 2k | 768p |  |
| prompt_enhancement | turbo, quality, ultraquality, disabled | turbo |  |
| seed | 0 to 4294967295 | — |  |

## What can you do with HeyGen Video Image to Video in Muse Code?

Turn a project's visual brief into short video assets with sound. Use HeyGen Video to test a shot's composition, motion, and style before placing it in the interface.

### Product B-roll

Make a short shot of a product resting on a counter, with a slow camera move and room sound. Keep detailed handling out of the scene.

### Hospitality mood shots

Create a brief hotel, café, or lounge scene for a promotional edit. Specify the light, camera position, and background sound.

### Ad storyboard tests

Test a single advertising shot before committing to a full sequence. Compare how different framing and lighting choices communicate the same idea.

### Stylized social shorts

Build a short anime or clay scene around one simple action. Direct its sound as carefully as its appearance.

### Short spoken introductions

Create a brief introduction with a stationary subject and one short line of dialogue. Keep gestures simple and review the result before using it.

### Animate approved artwork

Start with an approved illustration and add a simple movement with sound. Choose HeyGen Video Image to Video when the artwork must be the opening frame.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## HeyGen Video Image to Video in other agents

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

## More Muse Code guides

- [HeyGen Video Agent v3](https://spiral.ai/integrations/muse-code/heygen-video-agent-v3)
- [HeyGen Video Reference to Video](https://spiral.ai/integrations/muse-code/heygen-video-reference-to-video)
- [HeyGen Video Agent v2](https://spiral.ai/integrations/muse-code/heygen-video-agent-v2)
- [HeyGen Video Text to Video](https://spiral.ai/integrations/muse-code/heygen-video-text-to-video)
- [HeyGen Lipsync Speed](https://spiral.ai/integrations/muse-code/heygen-lipsync-speed)
- [HeyGen Video Translate Precision](https://spiral.ai/integrations/muse-code/heygen-video-translate-precision)

## Questions about HeyGen Video Image to Video in Muse Code

**Can Muse Code use HeyGen Video Image to Video?**

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

**How much does HeyGen Video Image to Video cost in Muse Code?**

`resolution`: 480p $0.026, 768p (default) $0.026, 2k $0.078, 1080p $0.078 per second. Billed on `duration`, default 5. 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 Video Image to Video in Muse Code?**

No. Spiral runs HeyGen Video Image to Video 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 Video Image to Video 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 Video Image to Video runs?**

HeyGen Video Image to Video runs in the background. Muse Code starts the run, checks on it and gives you the video when it's ready.

**What is HeyGen Video useful for?**

Use it for short scenes with sound: product B-roll, ad concepts, location shots, and stylized shorts. Give each shot one clear subject and one action.

**Does HeyGen Video generate sound?**

Yes. Describe the sound you want alongside the action, such as a machine hum, footsteps, or a short spoken line.

**Where does HeyGen Video struggle?**

HeyGen flags long on-screen text, delicate motion involving hair or paper, and close hand work as less reliable. For an assembly demonstration, consider a simpler shot and add precise instructions during editing.

**How should I write a HeyGen Video prompt?**

Describe one subject doing one thing, then specify the camera, lens, movement, lighting, and sound. A concrete shot description gives you a clearer brief to revise than a broad request for a cinematic video.

**When should I turn prompt enhancement off?**

Turn it off when you want to preserve an already detailed brief. Leave enhancement on when you want the model to expand a short idea.

