[Integrations](https://spiral.ai/integrations) › [Devin](https://spiral.ai/integrations/devin) › [HeyGen Video Reference to Video](https://spiral.ai/integrations/devin/heygen-video-reference-to-video)

# How to Use HeyGen Video Reference to Video in Devin

HeyGen Video Reference to Video puts supplied products, people, or places into a new scene with sound. Unlike HeyGen Video Image to Video, it uses references to guide the scene instead of making one still the opening frame.

|  |  |
| --- | --- |
| Model | HeyGen Video Reference 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 Reference to Video in Devin

- Use HeyGen Video Reference to Video with the project's approved mug photo. Make a 10-second landscape café shot at 1080p, with the mug resting on a counter, warm morning light, a slow push-in, and distant café chatter.
- Estimate, then generate a 5-second 9:16 clip with HeyGen Video Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with HeyGen Video Reference to Video for a smartwatch, slow orbit shot, studio lighting.
- Generate three 5-second b-roll clips of a busy coffee shop with HeyGen Video Reference to Video and list what each cost.
- Make a 6-second 16:9 drone shot over a misty pine forest at sunrise with HeyGen Video Reference to Video.

## How to set up HeyGen Video Reference to Video in Devin

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

### Use Spiral's MCP server

1. **Add a custom MCP**: Open Customize › MCPs. Click + and choose New MCP. Fill in:

2. **Sign in to Spiral and approve**: In Customize › MCPs, open Spiral and choose Connect. Spiral opens: sign in, pick the organization and click Authorize. No API key.

3. **Check it**: On Spiral's configuration page, click Test tools. Devin lists Spiral's tools.

### Use the Spiral skill

1. **Send Devin 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 Reference 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/reference-to-video",
    "input": {
      "prompt": "<prompt>"
    }
  }'
```

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

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

## HeyGen Video Reference to Video tools and prices

- [HeyGen Video Reference to Video](https://spiral.ai/tools/fal/heygen/heygen-video/reference-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 | — |  |
| reference_image_urls |  | — |  |
| reference_video_urls |  | — |  |

## What can you do with HeyGen Video Reference to Video in Devin?

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.

### Place an existing product in a new setting

Use a product reference to brief a new scene around its recognizable appearance, such as a ceramic cup on a café counter.

## Overview

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

## HeyGen Video Reference to Video in other agents

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

## More Devin guides

- [HeyGen Video Image to Video](https://spiral.ai/integrations/devin/heygen-video-image-to-video)
- [HeyGen Video Text to Video](https://spiral.ai/integrations/devin/heygen-video-text-to-video)
- [HeyGen Video Agent v3](https://spiral.ai/integrations/devin/heygen-video-agent-v3)
- [HeyGen Video Translate Precision](https://spiral.ai/integrations/devin/heygen-video-translate-precision)
- [HeyGen Video Agent v2](https://spiral.ai/integrations/devin/heygen-video-agent-v2)
- [HeyGen Video Translate Speed](https://spiral.ai/integrations/devin/heygen-video-translate-speed)

## Questions about HeyGen Video Reference to Video in Devin

**Can Devin use HeyGen Video Reference to Video?**

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

**How much does HeyGen Video Reference to Video cost in Devin?**

`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 Devin plan is separate.

**Do I need a fal account to use HeyGen Video Reference to Video in Devin?**

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

About two minutes: add a custom MCP, then sign in to Spiral and approve, then check it.

**Does Devin wait while HeyGen Video Reference to Video runs?**

HeyGen Video Reference to Video runs in the background. Devin 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.

