[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Eleven Multilingual v2](https://spiral.ai/integrations/windsurf/eleven-multilingual-v2)

# How to Use Eleven Multilingual v2 in Windsurf

Eleven Multilingual v2 turns written scripts into speech for audiobooks, explainers, and other narration. Its strengths are consistent delivery over long passages and support for 29 languages, with up to 10,000 characters per generation.

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

## Prompts to try with Eleven Multilingual v2 in Windsurf

- Use Eleven Multilingual v2 to narrate a beginner walkthrough based on this project's README. Draft a script under 4,000 characters, expand technical abbreviations for speech, and generate it at normal speed.
- Turn this project's latest changelog into a spoken release summary with Eleven Multilingual v2. Keep it under 2,000 characters, explain changes in user terms, and exclude commit hashes and Markdown syntax.
- Use Eleven Multilingual v2 to generate narration from the approved Spanish tutorial script in this project. Choose a native Spanish voice and keep each generation below 10,000 characters.
- Prepare the project's onboarding guide for narration with Eleven Multilingual v2. Remove code blocks, describe the essential actions in plain English, and generate separate sections under 5,000 characters each.
- Use Eleven Multilingual v2 to make two readings of the first paragraph in this project's demo script. Keep the voice and speed fixed, compare stability at 0.4 and 0.6, and leave style exaggeration at zero.

## How to set up Eleven Multilingual v2 in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

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

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 Multilingual 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_multilingual_v2",
    "input": {
      "text": "<text>",
      "voice_id": "<voice_id>"
    }
  }'
```

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

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

## Eleven Multilingual v2 tools and prices

- [ElevenLabs Multilingual v2 Text to Speech](https://spiral.ai/tools/elevenlabs/eleven_multilingual_v2) (ElevenLabs): $0.104 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 Multilingual v2 in Windsurf?

Create spoken tutorials, release summaries, and documentation narration from project files with Eleven Multilingual v2. Have the coding agent prepare readable scripts and divide long passages before generating audio.

### Audiobook narration

Turn a finished manuscript into narrated sections. Keep the same voice throughout and split chapters into passages below 10,000 characters.

### Product tutorial voiceovers

Narrate a walkthrough from an approved script. Write button labels and technical abbreviations as they should sound when spoken.

### Localized training lessons

Generate separate recordings from approved English, Spanish, French, or Japanese lesson scripts. Choose a voice native to each target language.

### Article audio editions

Make spoken editions of written articles for people who prefer listening. Remove navigation text and production notes before generating the narration.

### Narrated weekly briefings

Turn an edited weekly summary into a spoken briefing. Expand dates and acronyms before recording and keep delivery settings consistent across editions.

### Museum and walking tour narration

Create separate spoken scripts for tour stops in supported languages. Preview place names and use occasional short pauses between ideas.

## Overview

- [ElevenLabs](https://spiral.ai/providers/elevenlabs)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## Eleven Multilingual v2 in other agents

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

## More Windsurf guides

- [Eleven Flash v2.5](https://spiral.ai/integrations/windsurf/eleven-flash-v2-5)
- [Eleven Music](https://spiral.ai/integrations/windsurf/eleven-music)
- [Eleven Flash v2](https://spiral.ai/integrations/windsurf/eleven-flash-v2)
- [Eleven Music v2](https://spiral.ai/integrations/windsurf/eleven-music-v2)
- [Demucs](https://spiral.ai/integrations/windsurf/demucs)
- [Eleven Music v2.5](https://spiral.ai/integrations/windsurf/eleven-music-v2-5)

## Questions about Eleven Multilingual v2 in Windsurf

**Can Windsurf use Eleven Multilingual v2?**

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

**How much does Eleven Multilingual v2 cost in Windsurf?**

$0.104 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 Windsurf plan is separate.

**Do I need an ElevenLabs account to use Eleven Multilingual v2 in Windsurf?**

No. Spiral runs Eleven Multilingual 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 Multilingual v2 in Windsurf?**

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

**Does Windsurf wait while Eleven Multilingual v2 runs?**

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

**What is Eleven Multilingual v2 good at?**

It suits audiobooks, voiceovers, and narration that needs consistent delivery over long passages. ElevenLabs highlights its stability on long-form generations.

**How much speech can Eleven Multilingual v2 generate at once?**

The limit is 10,000 characters per generation, which ElevenLabs estimates at roughly 10 minutes of audio. Actual duration depends on the script and speaking speed.

**Which languages does Eleven Multilingual v2 support?**

It supports 29 languages, including English, Spanish, French, German, Japanese, Chinese, Hindi, Arabic, and Portuguese. Choose a voice native to the target language when accent matters.

**How do I fix an unusual name or acronym?**

Try a phonetic spelling for a difficult name. Write acronyms, dates, and numbers the way you want them spoken; phoneme tags are not supported.

**How do I control pauses and speaking speed?**

Use break tags sparingly for pauses of up to three seconds. Adjust speaking speed for the overall pace, then listen to the result before trying a larger change.

