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

dots · Audio

How to Use xAI Text to Speech in dots

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 dots

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

Every weekday morning, prepare a spoken briefing from verified public astronomy news published in the previous day. Keep it under 2,000 characters and generate it with xAI Text to Speech, pausing between stories.

xAI Text to Speechdots
Try asking
  • Each Monday, write a 120-word beginner Spanish listening exercise about an everyday activity. Generate normal and slower readings with xAI Text to Speech, keeping the wording identical.

  • Each Friday, summarize changes announced on the public Python release page that week. Generate a spoken update with xAI Text to Speech only when new information is available, with pauses between releases.

  • Every evening, write a 150-word original bedtime story with a clear ending. Generate it with xAI Text to Speech, using slower delivery for the final two complete sentences.

  • On the first day of each month, prepare a short introduction to the next month's observable meteor showers from verified astronomy sources. Generate English and Spanish narration with xAI Text to Speech using the same built-in voice.

How to set up xAI Text to Speech in dots

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

Use the Spiral skill

  1. Send dots 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 Spiral's MCP server

  1. Create an API key

    In the console, open API keys and create a key for your dot. Copy it.

  2. Send your dot this message

    Your dot reads Spiral's skill and asks for your API key.

    set up https://spiral.ai/SKILL.md
  3. Give your dot the key

    When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

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: dots 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 dots 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 dots?

Produce recurring spoken briefings, lessons, and updates with xAI Text to Speech. Have the scheduled agent prepare a concise script from its available information and divide longer narration into sections.

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 dots

Can dots use xAI Text to Speech?

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

How much does xAI Text to Speech cost in dots?

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 dots plan is separate.

Do I need a fal account to use xAI Text to Speech in dots?

You need no fal account. dots uses one Spiral API key for every tool, and Spiral runs xAI Text to Speech on its own fal account.

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

About two minutes: create an API key, then send your dot this message, then give your dot the key.

Does dots wait while xAI Text to Speech runs?

xAI Text to Speech runs in the background. dots 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 dots

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

Paste this into dots:

Set up dots

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