How to Use Eleven v4 in Windsurf
Eleven v4 turns scripts into expressive narration for audiobooks, character voiceovers, and produced content. Compared with Eleven v4 Turbo, it prioritizes audio quality over conversational speed.
Prompts to try with Eleven v4 in Windsurf
Copy an example into Windsurf, or ask in your own words.
Read the onboarding copy in this project and draft a spoken walkthrough of no more than 120 words. Generate it with Eleven v4, adding [curious] before the opening question and [pause] before the first instruction.
Find the quest introduction in this project's dialogue files. Generate a preview with Eleven v4 using [whispers] for the warning and [excited] when the reward is revealed, keeping the spoken wording unchanged.
Take the first paragraph of this project's demo script and generate two readings with Eleven v4: one [curious] and one [thoughtful]. Keep the spoken text identical so I can compare the delivery.
Read this paragraph aloud with Eleven v4 in a calm, warm voice and give me the MP3. Save the result in ./assets.
Make a 30-second podcast intro voiceover with Eleven v4.
How to set up Eleven v4 in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- 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:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - 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.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Eleven v4
One request; the result comes back by polling or a webhook.
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": "elevenlabs/tts/eleven-v4", "input": { "text": "[excited] Hello! Welcome to Eleven v4." } }'
Then paste one of the prompts above: Windsurf finds Eleven v4 on Spiral, shows the price and runs it.
Eleven v4 providers and prices
Spiral runs Eleven v4 through fal. Open a card for today's price, with every fee included.
$0.104 per 1,000 characters of text. Rounded up to the next 1,000 characters, minimum 1,000.
Settings you can ask for
Eleven v4 works from your text. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Stability | 0 to 1 | 0.5 | Voice stability. Lower values allow more expressive delivery; higher values make delivery more consistent. |
| Similarity boost | 0 to 1 | 0.75 | How closely the output follows the reference voice. Higher values increase similarity but may reduce naturalness. |
| Seed | 0 to 4294967295 | Seed for best-effort reproducibility. Identical output is not guaranteed. | |
| Output format | mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000 and 11 more | mp3_44100_128 | Output format of the generated audio. Formatted as codec_sample_rate_bitrate. |
| Apply text normalization | auto, on, or off | auto | Whether to normalize text such as numbers and dates before generation. |
| Timestamps | on or off | off | Whether to return character-level timing information with the generated audio. |
Every API field of Eleven v4 · Text to Speech is on its tool page: open its card above.
What can you do with Eleven v4 in Windsurf?
Add expressive spoken narration and character responses to the project you are building. Your coding agent can turn project text into scripts with delivery cues and generate audio for review.
Product walkthrough narration
Turn a walkthrough script into spoken instructions. Use short delivery cues to distinguish an explanation from a warning or a successful result.
Game character lines
Generate quest instructions, reactions, and character monologues. Place emotional changes directly in the script so the performance follows the scene.
Localized voiceovers
Produce spoken versions of approved scripts in supported languages such as Spanish, French, Japanese, and Portuguese.
Spoken assistant responses
Give confirmations, explanations, and follow-up questions different deliveries. Use concise scripts with a clear direction at each change in tone.
Story narration
Read a short story or scene aloud with changes in emotion and pacing. Keep directions close to the passages they affect.
Performance previews
Try different deliveries of the same script before choosing a take. Compare a curious, restrained, or excited reading without changing the spoken words.
More on Eleven v4 and Windsurf
Overview
Eleven v4 in other agents
Questions about Eleven v4 in Windsurf
Can Windsurf use Eleven v4?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Eleven v4 like any built-in tool.
How much does Eleven v4 cost in Windsurf?
Each item in `text` adds $0.104. 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 Eleven v4 in Windsurf?
No. Spiral runs Eleven v4 on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Eleven v4 in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Eleven v4 runs?
Eleven v4 runs in the background. Windsurf starts the run, checks on it and gives you the audio when it's ready.
What is Eleven v4 useful for?
Use Eleven v4 speech generation when delivery matters: narration, character lines, localized voiceovers, and spoken assistant responses. Write the words to be spoken, then add short bracketed directions where the performance should change.
Which languages does Eleven v4 support?
Eleven v4 and Eleven v4 Turbo support more than 90 languages, including English, Spanish, French, Japanese, and Portuguese. Provide the script in the language you want spoken.
How do I control emotion and delivery?
Place short directions such as [whispers], [curious], or [sighs] immediately before the words they affect. Introduce a new direction at the point where delivery should change, and avoid conflicting directions on the same phrase.
Why might an audio tag produce an unexpected sound?
The model can interpret an ambiguous tag as a sound effect instead of a vocal direction. Describe the intended delivery explicitly, such as [low, gravelly voice], and test the line before using it.
Start using Eleven v4 in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


