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

# How to Use HeyGen Video Agent v2 in Gemini

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 Gemini

- Use HeyGen Video Agent v2 to create a roughly 30-second lesson explaining compound interest to beginners. Use a hypothetical example, label it clearly, and keep the visual style consistent.
- Use HeyGen Video Agent v2 to make a roughly 60-second lesson on active listening for new managers. Include an example conversation, three practical habits, and a closing recap.
- Create a roughly 30-second product announcement with HeyGen Video Agent v2. The product is a reusable lunch container with removable dividers. Address commuters, explain that feature, and end by inviting viewers to learn more.
- Use HeyGen Video Agent v2 to make a roughly 60-second how-to video about preparing for a job interview. Write four scenes with narration and supporting visuals in one consistent style.
- Use HeyGen Video Agent v2 to create a roughly 90-second lesson explaining the water cycle to middle school students. Show evaporation, condensation, and precipitation with narrated motion graphics.

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

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

### Use the Gemini connector

1. **Open Connected Apps**: On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

2. **Add Spiral as a custom app**: Under Custom apps, click Add a custom app and paste this MCP server URL:

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

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

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

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

Turn an idea or written explanation into a narrated lesson or announcement. Use the conversation to settle the audience, required facts, and scene sequence before creating 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 Gemini guides](https://spiral.ai/integrations/gemini)

## 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 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 Gemini guides

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

## Questions about HeyGen Video Agent v2 in Gemini

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

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

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

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

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

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 Gemini?**

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

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

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

