How to Use xAI Text to Speech in Factory Droid
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 Factory Droid
Copy an example into Factory Droid, 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.
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 Factory Droid
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Droid saves it to your user config, ~/.factory/mcp.json, so it works in every project.
droid mcp add spiral https://api.spiral.ai/mcp --type http
- Sign in
Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.
- Check it
Spiral shows as connected. needs authentication means the sign-in did not finish: run /mcp again.
droid mcp list
Use the Spiral skill
- Send Factory Droid 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 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: Factory Droid 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.
$0.0195 per 1,000 characters of text. Rounded up to the next 1,000 characters, minimum 1,000.
Settings you can ask for
xAI Text to Speech works from your text. Ask Factory Droid for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Voice | carina, zagan, helix, orion, luna, iris, altair, zenith and 20 more | eve | Built-in xAI voice to use for synthesis. |
| Language | auto, en, ar-EG, ar-SA, ar-AE, bn, zh, fr and 13 more | auto | 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 Factory Droid?
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.
| Tool | Success | Median time | Runs |
|---|---|---|---|
| xAI Text to Speech | 100.0% | 40.5s | 52 |
More on xAI Text to Speech and Factory Droid
Overview
xAI Text to Speech in other agents
Questions about xAI Text to Speech in Factory Droid
Can Factory Droid use xAI Text to Speech?
Yes. Add Spiral to Factory Droid as an MCP server, and Factory Droid can find and run xAI Text to Speech like any built-in tool.
How much does xAI Text to Speech cost in Factory Droid?
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 Factory Droid plan is separate.
Do I need a fal account to use xAI Text to Speech in Factory Droid?
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 Factory Droid?
About two minutes: add the server, then sign in, then check it.
Does Factory Droid wait while xAI Text to Speech runs?
xAI Text to Speech runs in the background. Factory Droid 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.
Start using xAI Text to Speech in Factory Droid
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Factory Droid:
set up https://spiral.ai/SKILL.md


