[Integrations](https://spiral.ai/integrations) › [Amp](https://spiral.ai/integrations/amp) › [HeyGen Video Agent v2](https://spiral.ai/integrations/amp/heygen-video-agent-v2)

# How to Use HeyGen Video Agent v2 in Amp

HeyGen Video Agent v2 turns a written brief into a narrated video for explainers, lessons, and product announcements. Give it a complete script and scene directions when the wording and visual sequence matter.

|  |  |
| --- | --- |
| Model | HeyGen Video Agent v2 |
| Available through | fal |
| Category | Video |
| Price | `config.duration` off adds $13.26 per run. `config.duration` adds $3.978 per minute. Billed on `config.duration`. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with HeyGen Video Agent v2 in Amp

- Read the README and use HeyGen Video Agent v2 to make a roughly 60-second introduction for new users. Explain the problem, the main workflow, and the next step. Use only documented claims.
- Read CHANGELOG.md and use HeyGen Video Agent v2 to create a roughly 30-second release announcement. Cover the latest user-facing change, who benefits, and one action to take.
- Use the project's quickstart documentation to write a three-scene tutorial, then generate it with HeyGen Video Agent v2. Target 60 seconds, with one narrated step per scene and consistent visuals.
- Read the troubleshooting guide and use HeyGen Video Agent v2 to make a roughly 60-second how-to video about its most common error. Explain the symptom, cause, and documented fix.
- Read the architecture overview and use HeyGen Video Agent v2 to create a roughly 90-second lesson for new contributors. Explain three components with narrated motion graphics and a closing recap.

## How to set up HeyGen Video Agent v2 in Amp

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

### Use Spiral's MCP server

1. **Add the server**: No header and no client ID or secret: Amp registers itself with Spiral.

```bash
amp mcp add spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `amp`. Amp opens Spiral's sign-in page in your browser: sign in, pick the organization and click Authorize. No API key.

3. **Check it**

```bash
amp mcp doctor
```

### Use the Spiral skill

1. **Send Amp 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 Agent v2**: 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/v2/video-agent",
    "input": {
      "prompt": "Create a 15-second explainer video about fal.ai Video Workflows.\n            Target audience: Developers, AI engineers, and creative tech teams\n           …"
    }
  }'
```

Then paste one of the prompts above: Amp finds HeyGen Video Agent v2 on Spiral, shows the price and runs it.

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

## HeyGen Video Agent v2 tools and prices

- [HeyGen Video Agent v2](https://spiral.ai/tools/fal/fal-ai/heygen/v2/video-agent) (fal): `config.duration` off adds $13.26 per run. `config.duration` adds $3.978 per minute. Billed on `config.duration`.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| config |  | — | Video configuration options |

## What can you do with HeyGen Video Agent v2 in Amp?

Turn project documentation into narrated explainers, tutorials, and release announcements. Have the coding agent extract the relevant facts and write scene instructions before generating the video.

### Customer onboarding explainers

Explain one product concept with narration and a short sequence of supporting visuals.

### How-to videos

Turn a written procedure into a narrated sequence with one clear instruction per scene.

### Course lessons

Teach one concept, walk through an example, and finish with a recap.

### Employee training

Explain a policy through a practical scenario and a short checklist.

### Product announcements

Introduce a change, explain who it helps, and describe the next action.

### Sales outreach

Build a short narrated introduction around a prospect's problem and a relevant product benefit.

### Company news briefs

Summarize approved announcements with names, dates, and next steps supplied in the brief.

## Overview

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

## HeyGen Video Agent v2 in other agents

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

## More Amp guides

- [HeyGen Lipsync Speed](https://spiral.ai/integrations/amp/heygen-lipsync-speed)
- [HeyGen Video Agent v3](https://spiral.ai/integrations/amp/heygen-video-agent-v3)
- [HeyGen Lipsync Precision](https://spiral.ai/integrations/amp/heygen-lipsync-precision)
- [HeyGen Video Image to Video](https://spiral.ai/integrations/amp/heygen-video-image-to-video)
- [HeyGen Filler Word Removal](https://spiral.ai/integrations/amp/heygen-filler-word-removal)
- [HeyGen Video Reference to Video](https://spiral.ai/integrations/amp/heygen-video-reference-to-video)

## Questions about HeyGen Video Agent v2 in Amp

**Can Amp use HeyGen Video Agent v2?**

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

**How much does HeyGen Video Agent v2 cost in Amp?**

`config.duration` off adds $13.26 per run. `config.duration` adds $3.978 per minute. Billed on `config.duration`. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Amp plan is separate.

**Do I need a fal account to use HeyGen Video Agent v2 in Amp?**

No. Spiral runs HeyGen Video Agent v2 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 Agent v2 in Amp?**

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

**Does Amp wait while HeyGen Video Agent v2 runs?**

HeyGen Video Agent v2 runs in the background. Amp starts the run, checks on it and gives you the video when it's ready.

**What is HeyGen Video Agent good for?**

Use it for narrated explainers, how-to videos, course lessons, training, product demonstrations, and sales outreach. HeyGen also lists news briefs and company updates.

**How long can a HeyGen Video Agent v2 video be?**

The documented minimum is five seconds, with suggested lengths of 30, 60, or 90 seconds. Duration is approximate, and those suggestions do not establish a maximum.

**Can I supply a complete script?**

Yes. HeyGen recommends pasting a full script to guide the scene sequence, while Video Agent adjusts flow, timing, and visuals.

**What should I include in the brief?**

Identify the audience and list the facts, names, numbers, and steps that must appear. That gives Video Agent concrete requirements to work from.

**How do I keep scenes visually consistent?**

Define a visual style before generation and carry it through the scene instructions. HeyGen warns that unspecified styling can lead to scenes that look inconsistent.

