[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [Gemini 2.5 Flash TTS](https://spiral.ai/integrations/cursor/gemini-2-5-flash-tts)

# How to Use Gemini 2.5 Flash TTS in Cursor

Gemini 2.5 Flash TTS turns written scripts into narration or dialogue with control over delivery. Google optimizes it for low latency, while Gemini 2.5 Pro TTS prioritizes quality.

|  |  |
| --- | --- |
| Model | Gemini 2.5 Flash TTS |
| Available through | Gemini |
| Category | Audio |
| Price | Input text: $0.65 per 1M tokens. Output speech: $13.00 per 1M audio tokens. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Gemini 2.5 Flash TTS in Cursor

- Read README.md and draft an onboarding script of no more than 120 words. Use Gemini 2.5 Flash TTS to narrate it in a friendly, measured voice, with pauses between the main steps.
- Summarize the latest CHANGELOG.md entry in no more than 100 spoken words. Generate the announcement with Gemini 2.5 Flash TTS using clear, matter-of-fact delivery.
- Use the project's help documentation to write an eight-line dialogue between a beginner and an expert. Generate it with Gemini 2.5 Flash TTS using two distinct voices, with curious questions and patient answers.
- Take the opening paragraph of docs/tutorial.md and generate two readings with Gemini 2.5 Flash TTS: one calm and deliberate, one brisk and conversational. Keep the words identical.
- Find five technical terms in the project's glossary and write a short pronunciation audition that uses each in a sentence. Generate it with Gemini 2.5 Flash TTS at a slow, clear pace for review.

## How to set up Gemini 2.5 Flash TTS in Cursor

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

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

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor 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 Gemini 2.5 Flash TTS**: 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": "gemini",
    "model": "gemini-2.5-flash-preview-tts",
    "input": {
      "contents": [
        {}
      ]
    }
  }'
```

Then paste one of the prompts above: Cursor finds Gemini 2.5 Flash TTS on Spiral, shows the price and runs it.

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

## Gemini 2.5 Flash TTS tools and prices

- [Gemini 2.5 Flash Preview TTS](https://spiral.ai/tools/gemini/gemini-2.5-flash-preview-tts) (Gemini): Input text: $0.65 per 1M tokens. Output speech: $13.00 per 1M audio tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| generationConfig |  | — | Configuration options for model generation and outputs. |

## What can you do with Gemini 2.5 Flash TTS in Cursor?

Turn project documentation and release notes into spoken walkthroughs with Gemini 2.5 Flash TTS. Have the coding agent prepare a concise script from the files, then direct its narration or dialogue.

### Tutorial voiceovers

Turn a finished walkthrough script into narration. Ask for a measured pace around instructions and a brief pause between steps.

### Spoken release notes

Have an agent condense approved changes into a short script, then produce an audio update with clear, matter-of-fact delivery.

### Two-person explainers

Record a scripted exchange between a curious interviewer and an expert. Give each speaker a distinct voice and describe their delivery separately.

### Localized training narration

Generate speech from reviewed translations of training scripts. Check pronunciation and delivery with a short sample in each target language.

### Character dialogue drafts

Audition written exchanges for a game or audio story. Try contrasting emotional directions before choosing a performance for each character.

### Read-aloud editions

Create spoken versions of finished articles or instructions. Divide longer pieces into sections and review the audio against the original text.

### Recurring audio briefings

Convert a prepared daily or weekly summary into a short recording. Reuse the same delivery instructions across editions.

## Overview

- [Google Gemini](https://spiral.ai/providers/gemini)
- [All Cursor guides](https://spiral.ai/integrations/cursor)

## Gemini 2.5 Flash TTS in other agents

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

## More Cursor guides

- [GPT-4o mini Transcribe](https://spiral.ai/integrations/cursor/gpt-4o-mini-transcribe)
- [Gemini 2.5 Pro Preview TTS](https://spiral.ai/integrations/cursor/gemini-2-5-pro-preview-tts)
- [GPT-4o mini TTS](https://spiral.ai/integrations/cursor/gpt-4o-mini-tts)
- [Gemini 3.1 Flash TTS](https://spiral.ai/integrations/cursor/gemini-3-1-flash-tts)
- [F5-TTS](https://spiral.ai/integrations/cursor/f5-tts)
- [Gemini 3.8 Flash TTS](https://spiral.ai/integrations/cursor/gemini-3-8-flash-tts)

## Questions about Gemini 2.5 Flash TTS in Cursor

**Can Cursor use Gemini 2.5 Flash TTS?**

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run Gemini 2.5 Flash TTS like any built-in tool.

**How much does Gemini 2.5 Flash TTS cost in Cursor?**

Input text: $0.65 per 1M tokens. Output speech: $13.00 per 1M audio tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cursor plan is separate.

**Do I need a Gemini account to use Gemini 2.5 Flash TTS in Cursor?**

No. Spiral runs Gemini 2.5 Flash TTS on its own Gemini account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Gemini 2.5 Flash TTS in Cursor?**

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

**Does Cursor wait while Gemini 2.5 Flash TTS runs?**

Gemini 2.5 Flash TTS runs in the background. Cursor starts the run, checks on it and gives you the audio when it's ready.

**What is Gemini 2.5 Flash TTS good for?**

It suits repeated narration tasks and scripted conversations: tutorial voiceovers, spoken updates, and dialogue. You can direct the delivery through descriptions of tone, pace, accent, and emotion.

**How does Gemini 2.5 Flash TTS compare with Gemini 2.5 Pro TTS?**

Google optimizes Flash for low latency and Pro for quality. Compare a short passage with both when deciding how much vocal detail your recording needs.

**Can Gemini 2.5 Flash TTS generate dialogue?**

Yes. It supports both single-speaker narration and conversations with distinct voices, so a scripted exchange can include different speakers.

**Which languages does Gemini 2.5 Flash TTS support?**

Google documented support for 24 languages when it introduced Gemini 2.5 Flash TTS. For a localized recording, prepare the translated script first and review a short spoken sample before producing the rest.

**How much text can Gemini 2.5 Flash TTS handle?**

Google lists an input limit of 8,192 tokens and an output limit of 16,384 tokens. For longer narration, split the script into sections and check each recording for completeness.

