Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Audio

How to Use Seed Speech TTS 2.0 in Gemini CLI

Seed Speech TTS 2.0 turns written scripts into expressive narration for explainers, assistant replies, and support messages. Compared with Seed Speech TTS 1.0, it adds natural-language direction for delivery.

Prompts to try with Seed Speech TTS 2.0 in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Read the onboarding documentation in this project and draft a 90-word spoken introduction. Use Seed Speech TTS 2.0 to narrate it with a patient, conversational delivery, and save the script beside the audio.

Seed Speech TTS 2.0Gemini CLI
Try asking
  • Find the password-reset instructions in this project's interface copy. Create a short narration with Seed Speech TTS 2.0, using a calm, reassuring delivery and preserving the actual recovery steps.

  • Use the latest changelog entry to write a 75-word release announcement. Narrate it with Seed Speech TTS 2.0 in a pleased but restrained tone, and keep unsupported claims out of the script.

  • Review this project's Chinese and English welcome copy. Make one short mixed-language greeting with Seed Speech TTS 2.0 using a voice that supports mixing Chinese and English and automatic language handling.

  • Take the first paragraph of this project's tutorial and generate two readings with Seed Speech TTS 2.0: one neutral and one encouraging. Keep the spoken words identical and save both for review.

How to set up Seed Speech TTS 2.0 in Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Seed Speech TTS 2.0

    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": "fal-ai/bytedance/seed-speech/tts/v2",
        "input": {
          "text": "Hello, this is a test of ByteDance TTS 2.0 speech synthesis."
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Seed Speech TTS 2.0 on Spiral, shows the price and runs it.

Seed Speech TTS 2.0 providers and prices

Spiral runs Seed Speech TTS 2.0 through fal. Open a card for today's price, with every fee included.

falAudio
Bytedance Seed Speech Text to Speech
fal-ai/bytedance/seed-speech/tts/v2

Settings you can ask for

Seed Speech TTS 2.0 works from your text. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Voicevivi_mixed_en_zh_ja_es_id, mindy_en_es_id_pt_zh, stokie_en, dacey_en, tim_en, kian_en_zh, cedric_en_zh, sophie_en_zh and 33 morestokie_en

Voice to use for synthesis. The preset name encodes the voice and its supported language codes. 'mixed_en_zh' means the voice can seamlessly blend English and Chinese; separate codes (e.g. 'en_zh') mean the voice supports each language independently.

Output formatmp3 or opusmp3

Output audio format. 'mp3' returns MP3 audio; 'opus' returns Opus audio in an Ogg container.

Sample rate8000, 16000, 22050, 24000, 32000, 44100, or 4800024000

Sample rate of the output audio in Hz.

Speed0.5 to 21

Speech speed. 1.0 is normal speed, 0.5 is half speed, 2.0 is double speed.

Volume0.5 to 21

Volume. 1.0 is normal volume, 0.5 is half, 2.0 is double.

Pitch-12 to 120

Voice pitch shift in semitones. 0 is normal pitch, -12 lowers by one octave, 12 raises by one octave.

Languagezh, en, ja, es-mx, id, pt-br, ko, it and 2 more

Force the text to be read as a single language, disabling automatic language detection. Leave unset for automatic detection (including seamless Chinese/English mixing on bilingual voices). Codes: zh (Chinese), en (English), ja (Japanese), es-mx (Mexican Spanish), id (Indonesian), pt-br (Brazilian Portuguese), ko (Korean), it (Italian), de (German), fr (French).

Every API field of Bytedance Seed Speech Text to Speech is on its tool page: open its card above.

What can you do with Seed Speech TTS 2.0 in Gemini CLI?

Turn project documentation and interface copy into spoken walkthroughs and audio drafts. Use Seed Speech TTS 2.0 to audition delivery while reviewing the script alongside the source text.

Product walkthrough narration

Turn an approved walkthrough script into spoken instructions. Request a patient delivery for steps listeners need to follow.

Customer support responses

Read approved support replies in a calm, reassuring tone, especially when explaining a delay or a recovery step.

Spoken assistant answers

Give a text assistant a spoken response with delivery suited to the answer, such as restrained for a correction or cheerful for good news.

Chinese and English announcements

Narrate announcements that switch between Chinese and English using a voice that supports mixing both languages.

Daily audio briefings

Convert a short, checked daily summary into narration with a consistent voice and delivery instruction.

Character dialogue drafts

Generate separate readings of scripted lines with different emotional directions to audition how a scene sounds.

Training lesson narration

Read lesson scripts in short passages with an unhurried delivery. Review the readings before adding them to a course.

Questions about Seed Speech TTS 2.0 in Gemini CLI

Can Gemini CLI use Seed Speech TTS 2.0?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Seed Speech TTS 2.0 like any built-in tool.

How much does Seed Speech TTS 2.0 cost in Gemini CLI?

Each item in `text` adds $0.039. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

Do I need a fal account to use Seed Speech TTS 2.0 in Gemini CLI?

No. Spiral runs Seed Speech TTS 2.0 on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up Seed Speech TTS 2.0 in Gemini CLI?

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

Does Gemini CLI wait while Seed Speech TTS 2.0 runs?

Seed Speech TTS 2.0 runs in the background. Gemini CLI starts the run, checks on it and gives you the audio when it's ready.

What is Seed Speech TTS 2.0 useful for?

Use it to narrate explainers, speak assistant replies, or produce customer support messages. Its delivery instructions let you request a tone that fits the script.

How should I describe the delivery?

Keep the spoken script separate from directions such as “calm and reassuring” or “cheerful, with an unhurried pace.” Put those directions in the delivery instruction so they are not read aloud.

Can Seed Speech TTS 2.0 read Chinese and English in one script?

Yes, with a voice that supports mixing Chinese and English. Use automatic language handling for the mixed script rather than forcing one language.

Why might a multilingual script fail?

Multilingual support depends on the selected voice. Check that the voice supports the language in your script; a language mismatch can cause generation to fail.

How should I handle a long narration?

Split it into shorter passages if it exceeds the accepted text length. Keeping the same voice and delivery instruction across passages is a practical way to organize the narration.

Get started

Start using Seed Speech TTS 2.0 in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options