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

Gemini CLI · Audio

How to Use xAI Text to Speech in Gemini CLI

xAI Text to Speech turns written scripts into narration for tutorials, spoken articles, and character dialogue. Its speech tags let you add pauses, whispers, and slower delivery within a passage.

Prompts to try with xAI Text to Speech in Gemini CLI

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

Read README.md and draft a 120-word spoken introduction to the project using only documented features. Generate it with xAI Text to Speech, adding [pause] between the introduction and the first example.

xAI Text to SpeechGemini CLI
Try asking
  • Turn the latest CHANGELOG.md entry into a spoken update under 1,500 characters. Expand abbreviations in the script, preserve version numbers, and generate narration with xAI Text to Speech.

  • Find the onboarding tutorial in this project and prepare narration for its first three actions. Add [pause] between actions, generate it with xAI Text to Speech, and save the audio beside the tutorial assets.

  • Use xAI Text to Speech to generate two readings of the first paragraph in docs/demo-script.md: one unchanged and one with each complete sentence wrapped in <slow> tags. Save both for listening review.

  • Read the English and Spanish welcome scripts in the project. Generate each with xAI Text to Speech using the same built-in voice, preserving the approved wording and keeping each script below 15,000 characters.

How to set up xAI Text to Speech 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 xAI Text to Speech

    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": "xai/tts/v1",
        "input": {
          "text": "Hello! This is xAI text to speech, brought to you by Fal AI."
        }
      }'

Then paste one of the prompts above: Gemini CLI finds xAI Text to Speech on Spiral, shows the price and runs it.

xAI Text to Speech providers and prices

Spiral runs xAI Text to Speech through fal. Open a card for today's price, with every fee included.

falAudio

Settings you can ask for

xAI Text to Speech works from your text. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Voicecarina, zagan, helix, orion, luna, iris, altair, zenith and 20 moreeve

Built-in xAI voice to use for synthesis.

Languageauto, en, ar-EG, ar-SA, ar-AE, bn, zh, fr and 13 moreauto

BCP-47 language code or 'auto' for automatic detection. Supported: en, zh, fr, de, hi, id, it, ja, ko, pt-BR, pt-PT, ru, es-MX, es-ES, tr, vi, bn, ar-EG, ar-SA, ar-AE.

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

What can you do with xAI Text to Speech in Gemini CLI?

Create narration from project documentation, tutorial scripts, and release notes with xAI Text to Speech. Let the coding agent prepare the spoken wording and place delivery tags before generating audio.

Spoken articles

Turn an edited article into narration. Divide scripts longer than 15,000 characters at section boundaries.

Product tutorial narration

Generate spoken instructions for a walkthrough, placing pauses between actions so listeners can follow along.

Translated training narration

Narrate prepared translations of a training lesson using the same built-in voice across supported languages.

Character dialogue drafts

Try a scene with whispered phrases, sighs, or laughter before choosing the delivery for each line.

Podcast narration drafts

Convert an approved introduction or scripted segment into speech, then review the pacing before editing the episode.

Spoken daily briefings

Have an agent prepare a short briefing from verified updates, then generate narration with pauses between topics.

Practice listening exercises

Generate a normal reading and a slower reading of the same short passage for language practice.

xAI Text to Speech success rate and speed on Spiral

Success and speed over the last 24 hours, across every run of these tools on Spiral.

Success rate
100.0%
Fastest median run time
40.5s
Runs, last 24 hours
52
ToolSuccessMedian timeRuns
xAI Text to Speech100.0%40.5s52

Questions about xAI Text to Speech in Gemini CLI

Can Gemini CLI use xAI Text to Speech?

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

How much does xAI Text to Speech cost in Gemini CLI?

Each item in `text` adds $0.0195. 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 xAI Text to Speech in Gemini CLI?

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

How long does it take to set up xAI Text to Speech in Gemini CLI?

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

Does Gemini CLI wait while xAI Text to Speech runs?

xAI Text to Speech runs in the background. Gemini CLI starts the run, checks on it and gives you the audio when it's ready.

What is xAI Text to Speech useful for?

Use it to turn finished scripts into spoken articles, tutorials, or dialogue. Speech tags help when a passage needs a pause, a whispered aside, or a change in pace.

Can xAI Text to Speech narrate a long article?

Yes, but the listed endpoint limits each request to 15,000 characters. Split longer scripts at paragraph or section boundaries before generating the audio.

How do I add pauses or change the delivery?

Put [pause] where a break belongs. Wrap a passage in <whisper>...</whisper> or <slow>...</slow> to change how that passage is spoken.

How should I apply speech tags?

Wrap complete phrases instead of tagging individual words. Start with one passage, listen to the result, and adjust the tagged span before generating the full script.

Can the same voice narrate different languages?

Yes. Any built-in voice can speak any supported language, so you can keep the same voice selection across translated scripts.

Get started

Start using xAI Text to Speech 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