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

# How to Use HeyGen Video Agent v2 in Instinct

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, with a Spiral API key |

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

- Every Friday, use HeyGen Video Agent v2 to turn this week's approved company announcements into a roughly 60-second staff brief. Include confirmed dates and next steps, and flag missing facts before generation.
- Each Monday, use HeyGen Video Agent v2 to create a roughly 30-second customer tip from the approved help-center content. Explain one task with three narrated steps and consistent visuals.
- After each approved product release, use HeyGen Video Agent v2 to generate a roughly 60-second announcement. Explain what changed, who it helps, and the next action using only confirmed information.
- Once a week, use HeyGen Video Agent v2 to turn one approved training topic into a roughly 90-second lesson. Include a practical scenario, a checklist, and a recap in the same visual style.
- Each morning, summarize the approved industry headlines with HeyGen Video Agent v2 in a roughly 60-second narrated brief. Attribute each item, preserve dates, and leave out unsupported predictions.

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

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

### Use the Spiral skill

1. **Send Instinct 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### 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: Instinct finds HeyGen Video Agent v2 on Spiral, shows the price and runs it.

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

## 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 Instinct?

Create recurring video briefs from approved updates and announcements. Give each run a defined audience, a short script, and a consistent visual style.

### 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 Instinct guides](https://spiral.ai/integrations/instinct)

## HeyGen Video Agent v2 in other agents

- [Amp](https://spiral.ai/integrations/amp/heygen-video-agent-v2)
- [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)
- [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 Instinct guides

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

## Questions about HeyGen Video Agent v2 in Instinct

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

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

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

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

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

You need no fal account. Instinct uses one Spiral API key for every tool, and Spiral runs HeyGen Video Agent v2 on its own fal account.

**How long does it take to set up HeyGen Video Agent v2 in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

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

HeyGen Video Agent v2 runs in the background. Instinct 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.

