How to Use Gemini 2.5 Pro Preview TTS in opencode
Gemini 2.5 Pro Preview TTS turns scripts into expressive narration and two-person dialogue. Google positions it for speech quality and complex prompts, while Gemini 2.5 Flash Preview TTS emphasizes low latency.
Prompts to try with Gemini 2.5 Pro Preview TTS in opencode
Copy an example into opencode, or ask in your own words.
Read the project's onboarding docs and draft a 150-word walkthrough. Use Gemini 2.5 Pro Preview TTS to narrate it as a patient instructor at a measured pace.
Turn the latest changelog into a short spoken release summary. Use Gemini 2.5 Pro Preview TTS with a factual tone and clear emphasis on changes users will notice.
Find a two-character scene in the game's dialogue files. Use Gemini 2.5 Pro Preview TTS to perform a short excerpt with one cautious character and one confident character.
Take one lesson from the project's training content. Use Gemini 2.5 Pro Preview TTS to make a narration sample that slows down around the instructions.
Prepare one short narration script from the README. Use Gemini 2.5 Pro Preview TTS to record it twice, once conversationally and once as a formal technical presentation.
How to set up Gemini 2.5 Pro Preview TTS in opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode 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 Gemini 2.5 Pro Preview TTS
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": "gemini", "model": "gemini-2.5-pro-preview-tts", "input": { "contents": [ {} ] } }'
Then paste one of the prompts above: opencode finds Gemini 2.5 Pro Preview TTS on Spiral, shows the price and runs it.
Gemini 2.5 Pro Preview TTS providers and prices
Spiral runs Gemini 2.5 Pro Preview TTS through Gemini. Open a card for today's price, with every fee included.
Input text: $1.30 per 1M tokens. Output speech: $26.00 per 1M audio tokens.
What can you do with Gemini 2.5 Pro Preview TTS in opencode?
Create spoken walkthroughs, narration, and character dialogue from your project's written content. Let the coding agent prepare the script, then use Gemini 2.5 Pro TTS to perform it with explicit delivery directions.
Audiobook passages
Record a finished chapter section with deliberate pacing and emotional direction. Generate long manuscripts section by section.
Two-person podcast explainers
Turn an approved host-and-guest script into dialogue, with a distinct delivery brief for each speaker.
Product tutorial narration
Read walkthrough scripts in a patient instructional tone, slowing down around steps that need extra attention.
Localized training audio
Generate spoken versions of approved translations. Preview a short lesson in each target language before recording the rest.
Game dialogue prototypes
Try character lines with different emotional directions, or rehearse a scripted exchange between two characters.
Spoken news briefings
Read a fact-checked briefing with measured delivery and clear emphasis on the main developments.
Poetry readings
Explore how pace, emotion, and accent change the performance of a finished poem.
Gemini 2.5 Pro Preview TTS success rate and speed on Spiral
Success and speed over the last 24 hours, across every run of these tools on Spiral.
| Tool | Success | Median time | Runs |
|---|---|---|---|
| Gemini 2.5 Pro Preview TTS | 99.0% | 34.1s | 674 |
More on Gemini 2.5 Pro Preview TTS and opencode
Overview
Gemini 2.5 Pro Preview TTS in other agents
Questions about Gemini 2.5 Pro Preview TTS in opencode
Can opencode use Gemini 2.5 Pro Preview TTS?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Gemini 2.5 Pro Preview TTS like any built-in tool.
How much does Gemini 2.5 Pro Preview TTS cost in opencode?
Input text: $1.30 per 1M tokens. Output speech: $26.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 opencode plan is separate.
Do I need a Gemini account to use Gemini 2.5 Pro Preview TTS in opencode?
No. Spiral runs Gemini 2.5 Pro Preview 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 Pro Preview TTS in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while Gemini 2.5 Pro Preview TTS runs?
Gemini 2.5 Pro Preview TTS runs in the background. opencode starts the run, checks on it and gives you the audio when it's ready.
What is Gemini 2.5 Pro TTS best at?
Use it for narration and dialogue where delivery matters: audiobook passages, podcast scripts, and spoken tutorials. Google positions Pro for quality and complex creative speech workflows.
Can Gemini 2.5 Pro TTS generate two different speakers?
Yes. It can turn text into a two-person audio overview, making it useful for scripted interviews, question-and-answer lessons, and podcast conversations.
How much text and audio can Gemini 2.5 Pro TTS handle?
Google lists an input limit of 8,192 tokens and an output limit of 16,384 tokens. Treat those as token limits rather than a guaranteed recording length; split long scripts into sections.
Which languages does Gemini 2.5 Pro TTS support?
Google's Gemini 2.5 technical report describes more than 80 languages for Preview TTS Pro and Flash. Test a short passage in your target language before generating a full recording.
How should I describe the voice delivery?
Specify the role, tone, accent, and pace in ordinary language, such as a patient instructor explaining one step at a time. Google recommends specific style prompts and warns that unfamiliar tags may be spoken aloud.
Start using Gemini 2.5 Pro Preview TTS in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


