[Integrations](https://spiral.ai/integrations) › [Google Antigravity](https://spiral.ai/integrations/antigravity) › [HeyGen Voice](https://spiral.ai/integrations/antigravity/heygen-voice)

# How to Use HeyGen Voice in Google Antigravity

Use HeyGen Voice for course narration, podcast scripts, and spoken app content. It follows the standard generation path; HeyGen Voice Turbo shortens that step when faster production matters.

|  |  |
| --- | --- |
| Model | HeyGen Voice |
| Available through | fal |
| Category | Audio |
| Price | Each item in `text` adds $0.000039. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with HeyGen Voice in Google Antigravity

- Read the README and draft an 80-word spoken introduction to the project. Use HeyGen Voice with low expressiveness to generate the narration, keeping commands and code blocks out of the spoken text.
- Read the tutorial files and turn the first lesson into a conversational narration script. Use HeyGen Voice to generate one paragraph as a sample before processing the remaining sections.
- Find the approved troubleshooting instructions in the docs. Rewrite one answer for listening, then use HeyGen Voice to generate a WAV with clear sentence boundaries and low expressiveness.
- Read this paragraph aloud with HeyGen Voice in a calm, warm voice and give me the MP3. Save the result in ./assets.
- Make a 30-second podcast intro voiceover with HeyGen Voice.

## How to set up HeyGen Voice in Google Antigravity

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

### Use Spiral's MCP server

1. **Open the MCP config**: * Antigravity App: click Customizations, then Installed. In the MCP Servers section, click Copy Config File Path and open that file. * Antigravity IDE: click … at the top of the agent side panel, select MCP Servers, then Manage MCP Servers › View raw config. * Antigravity CLI: edit `~/.gemini/config/mcp_config.json`.

2. **Add the server**: Add Spiral under `mcpServers`:

```json
{
  "mcpServers": {
    "spiral": {
      "serverUrl": "https://api.spiral.ai/mcp"
    }
  }
}
```

3. **Sign in**: In the Antigravity App, open Customizations › Installed. Under MCP Servers, click Authenticate next to Spiral. Sign in to Spiral, pick the organization and click Authorize. Copy the authorization code the browser shows, paste it into Enter authorization code and click Submit. No API key.

### Use the Spiral skill

1. **Send Google Antigravity 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 Voice**: 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-voice",
    "input": {
      "text": "Hello! This is HeyGen Voice, speaking on fal."
    }
  }'
```

Then paste one of the prompts above: Google Antigravity finds HeyGen Voice on Spiral, shows the price and runs it.

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

## HeyGen Voice tools and prices

- [HeyGen Voice](https://spiral.ai/tools/fal/heygen/heygen-voice) (fal): $0.039 per 1,000 characters of `text`.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| voice | Jonah, Nadine, Tabitha, Soren, Elowen, Vincent, Jocelyn, Marielle, Corinne, Lucian, Kieran, Hugh, Noelle, Bram, Ewan, Iona, Cecily, Simon, Weston, Felicity, Gareth, Rory, Meredith, Sabrina | Jonah | HeyGen public voice. Ignored when reference_audio_url is set. |
| reference_audio_url |  | — | Recording of a single speaker to clone instead of using a public voice. Only the first 3 minutes are used. |
| language | ar, be, bg, ca, cs, da, de, el, en, es, fa, fi, fr, he, hi, hr, hu, id, it, ja, ko, mk, ms, nl, pl, pt, ro, ru, sk, sl, sr, sv, ta, th, tl, tr, uk, vi, zh | — | Language of the text. Detected from the text when omitted. |
| expressiveness_boost | 0 to 1 | 1 | How expressive the delivery is. |

## What can you do with HeyGen Voice in Google Antigravity?

Turn project documentation into spoken walkthroughs, onboarding messages, and tutorial narration. Have the agent draft scripts from the files, then generate separate audio sections for review.

### Course lesson narration

Turn a lesson script into spoken instruction. Test one explanatory paragraph with lower expressiveness before producing the remaining sections.

### App welcome messages

Create a spoken welcome that explains the app's first useful action. Keep the script focused on one task and review the opening sentence by ear.

### Support reply audio

Convert an approved troubleshooting answer into a spoken response. Use short sentences and listen for pauses between instructions.

### Podcast intros

Generate an introduction from the episode title and summary. Keep production directions outside the spoken script and audition the complete introduction.

### Ad read comparisons

Produce several reads of approved ad copy with different expressiveness levels. Compare delivery while keeping the wording fixed.

### Product walkthrough narration

Write a spoken explanation of a product workflow, then generate each section separately. Review terminology and pacing before adding the narration to the edit.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Google Antigravity guides](https://spiral.ai/integrations/antigravity)

## HeyGen Voice in other agents

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

## More Google Antigravity guides

- [Grok Voice](https://spiral.ai/integrations/antigravity/grok-voice)
- [HeyGen Voice Turbo](https://spiral.ai/integrations/antigravity/heygen-voice-turbo)
- [Gemini 3.8 Flash-Lite TTS](https://spiral.ai/integrations/antigravity/gemini-3-8-flash-lite-tts)
- [Index TTS 2.0](https://spiral.ai/integrations/antigravity/index-tts-2-0)
- [Gemini 3.8 Flash TTS](https://spiral.ai/integrations/antigravity/gemini-3-8-flash-tts)
- [Insanely Fast Whisper with video](https://spiral.ai/integrations/antigravity/insanely-fast-whisper-with-video)

## Questions about HeyGen Voice in Google Antigravity

**Can Google Antigravity use HeyGen Voice?**

Yes. Add Spiral to Google Antigravity as an MCP server, and Google Antigravity can find and run HeyGen Voice like any built-in tool.

**How much does HeyGen Voice cost in Google Antigravity?**

Each item in `text` adds $0.000039. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Google Antigravity plan is separate.

**Do I need a fal account to use HeyGen Voice in Google Antigravity?**

No. Spiral runs HeyGen Voice 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 Voice in Google Antigravity?**

About two minutes: open the MCP config, then add the server, then sign in.

**Does Google Antigravity wait while HeyGen Voice runs?**

HeyGen Voice runs in the background. Google Antigravity starts the run, checks on it and gives you the audio when it's ready.

**How should I choose between HeyGen Voice and HeyGen Voice Turbo?**

Turbo uses the same voices with a shorter generation step. Choose it when frequent revisions or repeated narration make speed useful; compare a representative passage before committing to a longer project.

**What audio format does HeyGen Voice produce?**

HeyGen Voice and HeyGen Voice Turbo produce 44.1 kHz WAV audio. That gives you an audio file to use in an editor or app.

**How much expressiveness should I use?**

Start lower for instructional narration and higher for an ad read. Zero gives the baseline delivery; compare the same sentence at different levels before generating the full script.

**How should I write a script for HeyGen Voice?**

Write complete sentences with enough context to establish the intended emotion. The model reads contextual cues, so test a complete paragraph rather than judging a voice from an isolated word.

**Can I count on an exact emotional performance?**

Text-to-speech can miss subtle tone, pacing, or emotion. Review important lines by ear and try revised wording or punctuation before approving the recording.

