[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Eleven Turbo v2](https://spiral.ai/integrations/claude-code/eleven-turbo-v2)

# How to Use Eleven Turbo v2 in Claude Code

Eleven Turbo v2 turns English scripts into speech for spoken replies and short voiceovers. ElevenLabs recommends Eleven Flash v2 instead, which offers equivalent functionality with lower average latency.

|  |  |
| --- | --- |
| Model | Eleven Turbo v2 |
| Available through | ElevenLabs |
| Category | Audio |
| Price | $0.052 per 1,000 characters of `text`. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Eleven Turbo v2 in Claude Code

- Use Eleven Turbo v2 to narrate a plain-English summary of this project's latest changelog entry. Keep the script under 700 characters and spell out version numbers as they should be spoken.
- Read the README and use Eleven Turbo v2 to make an English introduction explaining the project's purpose. Keep the narration under 750 characters and expand acronyms before synthesis.
- Use Eleven Turbo v2 to generate separate English narration clips for the walkthrough script in this project. Keep each section under 800 characters and preserve sentence boundaries.
- Use Eleven Turbo v2 to compare two readings of the first paragraph in our demo script. Keep the voice and wording fixed, start stability at 0.5, and lower it slightly for the second take.
- Use Eleven Turbo v2 to narrate the English training instructions in this project. Generate one clip per step, keep each under 800 characters, and insert a one-second SSML break before each step's final reminder.

## How to set up Eleven Turbo v2 in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 Eleven Turbo 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": "elevenlabs",
    "model": "eleven_turbo_v2",
    "input": {
      "text": "<text>",
      "voice_id": "<voice_id>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Eleven Turbo v2 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Eleven Turbo v2 tools and prices

- [Eleven Turbo v2](https://spiral.ai/tools/elevenlabs/eleven_turbo_v2) (ElevenLabs): $0.052 per 1,000 characters of `text`.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — | If specified, our system will make a best effort to sample deterministically, such that repeated requests with the same seed and parameters should return the same result. |
| next_text |  | — | The text that comes after the text of the current request. |
| audio_effects |  | — | Audio effects applied to the generated audio. |
| language_code |  | — | Language code (ISO 639-1) used to enforce a language for the model and text normalization. |
| output_format | alaw_8000, mp3_22050_32, mp3_24000_48, mp3_44100_128, mp3_44100_192, mp3_44100_32, mp3_44100_64, mp3_44100_96, opus_48000_128, opus_48000_192, opus_48000_32, opus_48000_64, opus_48000_96, pcm_16000, pcm_22050, pcm_24000, pcm_32000, pcm_44100, pcm_48000, pcm_8000, ulaw_8000, wav_16000, wav_22050, wav_24000, wav_32000, wav_44100, wav_48000, wav_8000 | mp3_44100_128 | Output format of the generated audio. |
| previous_text |  | — | The text that came before the text of the current request. |

## What can you do with Eleven Turbo v2 in Claude Code?

Turn project documentation and release notes into English narration for demos, tutorials, and spoken updates. Your coding agent can prepare the script, expand technical abbreviations, and divide longer passages into short sections.

### Spoken support replies

Turn an approved English answer into a short spoken response. Spell out reference numbers in the order the listener should hear them.

### Product walkthrough narration

Create English narration for individual walkthrough scenes. Generate each scene separately so a script change requires replacing only that section.

### Audio release notes

Convert a concise English release summary into a spoken update. Expand version numbers and technical abbreviations before synthesis.

### Daily spoken briefings

Make an English audio briefing from approved updates. Keep each section short and write dates and quantities as spoken words.

### Training instructions

Read English procedures aloud in separate steps. Add a short pause between instructions when listeners need time to act.

### Narration draft comparisons

Generate short English readings of alternative scripts. Compare wording and stability settings before choosing a take.

### Read-aloud article sections

Create an English audio edition of an article in sections under 800 characters. Review each section before assembling the full reading.

## Overview

- [ElevenLabs](https://spiral.ai/providers/elevenlabs)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Eleven Turbo v2 in other agents

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

## More Claude Code guides

- [Eleven Sound Effects v3](https://spiral.ai/integrations/claude-code/eleven-sound-effects-v3)
- [Eleven v3](https://spiral.ai/integrations/claude-code/eleven-v3)
- [Eleven Music with metadata](https://spiral.ai/integrations/claude-code/eleven-music-with-metadata)
- [Eleven v3 Conversational](https://spiral.ai/integrations/claude-code/eleven-v3-conversational)
- [Eleven Music v2.5](https://spiral.ai/integrations/claude-code/eleven-music-v2-5)
- [Eleven v4](https://spiral.ai/integrations/claude-code/eleven-v4)

## Questions about Eleven Turbo v2 in Claude Code

**Can Claude Code use Eleven Turbo v2?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Eleven Turbo v2 like any built-in tool.

**How much does Eleven Turbo v2 cost in Claude Code?**

$0.052 per 1,000 characters of `text`. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need an ElevenLabs account to use Eleven Turbo v2 in Claude Code?**

No. Spiral runs Eleven Turbo v2 on its own ElevenLabs account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Eleven Turbo v2 in Claude Code?**

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

**Does Claude Code wait while Eleven Turbo v2 runs?**

Eleven Turbo v2 runs in the background. Claude Code starts the run, checks on it and gives you the audio when it's ready.

**Does Eleven Turbo v2 support languages other than English?**

No. Eleven Turbo v2 supports English only, so use a multilingual speech model when your script includes another language.

**How much audio can Eleven Turbo v2 generate at once?**

ElevenLabs documents a limit of 30,000 characters per API request, roughly 30 minutes of speech. For better consistency, generate shorter sections; its troubleshooting guide recommends keeping sections under 800 characters.

**How does Eleven Turbo v2 compare with Eleven Flash v2?**

ElevenLabs describes the two as functionally equivalent, with lower average latency on Eleven Flash v2. It classifies Eleven Turbo v2 as deprecated and recommends Flash over Turbo.

**Which settings should I adjust if the voice sounds flat?**

Try lowering stability slightly to allow more emotional variation. Start around 50% stability, 75% similarity, and zero style exaggeration, then compare short samples.

**How do I prevent mistakes with dates and acronyms?**

Write them as you want them spoken before generating audio. For example, turn an ambiguous date into a spelled-out month and day, and separate letters in an acronym that should be read letter by letter.

