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

# How to Use ElevenLabs Multilingual v2 in Windsurf

ElevenLabs Multilingual v2 turns scripts into consistent narration for audiobooks, lessons, and video voiceovers in 29 languages. Its strength is long-form delivery, with up to 10,000 characters per generation.

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

## Prompts to try with ElevenLabs Multilingual v2 in Windsurf

- Read the project's getting-started guide and write a 250-word onboarding narration. Generate it with ElevenLabs Multilingual v2, using 50% stability and no style exaggeration.
- Use the latest changelog entry to write a spoken release briefing explaining the three most useful changes. Generate the narration with ElevenLabs Multilingual v2 and keep the script below 3,000 characters.
- Find the English, Spanish, and French onboarding copy in the repository. Prepare a separate narration script for each language and generate each with ElevenLabs Multilingual v2.
- Read the tutorial scripts in this project and generate narration with ElevenLabs Multilingual v2. Divide any script over 10,000 characters at paragraph boundaries and keep the same voice throughout.
- Take the first paragraph of the project's demo script and generate two readings with ElevenLabs Multilingual v2. Use 40% stability for one and 65% for the other, keeping similarity at 75% and style exaggeration off.

## How to set up ElevenLabs 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 ElevenLabs 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": "fal",
    "model": "fal-ai/elevenlabs/tts/multilingual-v2",
    "input": {
      "text": "Hello! This is a test of the text to speech system, powered by ElevenLabs. How does it sound?"
    }
  }'
```

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

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

## ElevenLabs Multilingual v2 tools and prices

- [ElevenLabs TTS Multilingual v2](https://spiral.ai/tools/fal/fal-ai/elevenlabs/tts/multilingual-v2) (fal): $0.13 per 1,000 characters of `text`. Rounded up to the next 1,000 characters, minimum 1,000.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| voice |  | Rachel | The voice to use for speech generation |
| stability | 0 to 1 | 0.5 | Voice stability (0-1) |
| similarity_boost | 0 to 1 | 0.75 | Similarity boost (0-1) |
| style | 0 to 1 | 0 | Style exaggeration (0-1) |
| speed | 0.7 to 1.2 | 1 | Speech speed (0.7-1.2). Values below 1.0 slow down the speech, above 1.0 speed it up. Extreme values may affect quality. |
| timestamps |  | false | Whether to return timestamps for each word in the generated speech |

## What can you do with ElevenLabs Multilingual v2 in Windsurf?

Turn project documentation into spoken tutorials, release briefings, and training narration. Your coding agent can prepare scripts from repository files and divide long passages into separate generations.

### Audiobook narration

Turn book chapters into spoken sections with a consistent narrator. Split chapters that exceed 10,000 characters.

### Employee training

Narrate onboarding lessons, policy explanations, and process walkthroughs. Start with moderate stability and no style exaggeration.

### Product explainer voiceovers

Create narration for product demonstrations and explainer videos. Generate each scene separately so revisions stay focused.

### Localized video narration

Generate separate voiceovers from translated scripts in supported languages, including Spanish, French, German, and Japanese.

### Audio editions of articles

Make spoken editions of essays, documentation, and educational articles for readers who prefer listening.

### Language lesson narration

Read lesson scripts in supported languages. Add short pauses between an example sentence and its explanation.

### Narrated release notes

Convert written product updates into a spoken briefing that explains changes and their practical effects.

## Overview

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

## ElevenLabs Multilingual v2 in other agents

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

## More Windsurf guides

- [ElevenLabs Forced Alignment](https://spiral.ai/integrations/windsurf/elevenlabs-forced-alignment)
- [ElevenLabs Music](https://spiral.ai/integrations/windsurf/elevenlabs-music)
- [ElevenLabs English Voice Changer v2](https://spiral.ai/integrations/windsurf/elevenlabs-english-voice-changer-v2)
- [ElevenLabs Music v2](https://spiral.ai/integrations/windsurf/elevenlabs-music-v2)
- [ElevenLabs Dubbing v2](https://spiral.ai/integrations/windsurf/elevenlabs-dubbing-v2)
- [ElevenLabs Scribe v1](https://spiral.ai/integrations/windsurf/elevenlabs-scribe-v1)

## Questions about ElevenLabs Multilingual v2 in Windsurf

**Can Windsurf use ElevenLabs Multilingual v2?**

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

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

Each item in `text` adds $0.13. 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 a fal account to use ElevenLabs Multilingual v2 in Windsurf?**

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

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

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

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

**What is ElevenLabs Multilingual v2 best for?**

Audiobooks, instructional narration, and video voiceovers are strong fits. ElevenLabs highlights consistent delivery across long passages.

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

It supports 29 languages, including English, Spanish, French, German, Japanese, Chinese, Hindi, and Arabic.

**How much text can ElevenLabs Multilingual v2 read at once?**

The documented limit is 10,000 characters per generation. For longer scripts, generate separate sections.

**How do I make the delivery more expressive?**

Lower stability to allow more emotional variation. Raise it for steadier narration, but avoid pushing it so high that the voice sounds monotonous.

**How do I add a pause?**

Insert a break tag such as <break time="1.0s" /> in the script. Supported pauses can last up to three seconds.

