[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [Chatterbox TTS](https://spiral.ai/integrations/dots/chatterbox-tts)

# How to Use Chatterbox TTS in dots

Chatterbox TTS turns English scripts into speech with voice cloning and adjustable emotional intensity. Unlike Chatterbox Multilingual, it focuses on English, making it useful for narration, character lines, and spoken replies.

|  |  |
| --- | --- |
| Model | Chatterbox TTS |
| Available through | fal |
| Category | Audio |
| Price | Each item in `text` adds $0.0325. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Chatterbox TTS in dots

- Each weekday morning, turn the updates I provide into a three-sentence English briefing and generate it with Chatterbox TTS. Use my supplied reference voice and emotional intensity of 0.5.
- Every Friday, summarize the week's completed tasks from our conversation in two English sentences. Read the summary with Chatterbox TTS using emotional intensity of 0.5, without speaking task IDs or links.
- At the scheduled reminder time, use Chatterbox TTS to say 'Time for a short break. Stand up, stretch, and look away from the screen.' Set emotional intensity to 0.5.
- Each evening, turn the English vocabulary words I supplied into three short example sentences. Generate each sentence separately with Chatterbox TTS, using my supplied reference voice and guidance of 0.3.
- Each Monday, prepare a two-sentence English introduction for the week's lesson topic from our conversation. Generate two readings with Chatterbox TTS, comparing emotional intensity of 0.5 and 0.7 while keeping the reference voice unchanged.

## How to set up Chatterbox TTS 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.

```text
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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Chatterbox TTS**: One request; the result comes back by polling or a webhook.

```bash
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/chatterbox/text-to-speech",
    "input": {
      "text": "I just found a hidden treasure in the backyard! Check it out!"
    }
  }'
```

Then paste one of the prompts above: dots finds Chatterbox TTS on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/dots

## Chatterbox TTS tools and prices

- [Chatterbox · Text to Speech](https://spiral.ai/tools/fal/fal-ai/chatterbox/text-to-speech) (fal): $0.0325 per 1,000 characters of `text`. Rounded up to the next 1,000 characters, minimum 1,000.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| audio_url |  | https://storage.googleapis.com/chatterbox-demo-samples/prompts/male_rickmorty.mp3 | Optional URL to an audio file to use as a reference for the generated speech. If provided, the model will try to match the style and tone of the reference audio. |
| exaggeration | 0 to 1 | 0.25 | Exaggeration factor for the generated speech (0.0 = no exaggeration, 1.0 = maximum exaggeration). |
| temperature | 0.05 to 2 | 0.7 | Temperature for generation (higher = more creative). |
| cfg | 0.1 to 1 | 0.5 |  |
| seed |  | — | Useful to control the reproducibility of the generated audio. Assuming all other properties didn't change, a fixed seed should always generate the exact same audio file. Set to 0 for random seed.. |

## What can you do with Chatterbox TTS in dots?

Create recurring spoken English briefings and reminders with Chatterbox TTS. A scheduled agent can prepare concise scripts and reuse a reference recording while keeping emotional intensity consistent across updates.

### Product tutorial narration

Turn an English walkthrough into spoken instructions. Generate each section separately so you can review the delivery alongside the corresponding screen recording.

### Game character dialogue

Create short English character lines using a reference voice. Compare restrained and dramatic readings by adjusting emotional exaggeration.

### Spoken assistant replies

Read an assistant's English response aloud. If the reference speaker sounds rushed, try lower guidance and review the pacing.

### Narration in your voice

Use a short recording of your voice to narrate English introductions, explainers, or lesson passages without training a separate voice model.

### Scheduled audio briefings

Have an agent draft a concise English update and turn it into speech. Reuse a reference recording and review how names and numbers sound.

### Alternate voiceover readings

Generate several readings of the same English script. Compare emotional intensity and pacing before selecting audio for a video edit.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All dots guides](https://spiral.ai/integrations/dots)

## Chatterbox TTS in other agents

- [Amp](https://spiral.ai/integrations/amp/chatterbox-tts)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/chatterbox-tts)
- [Claude](https://spiral.ai/integrations/claude-desktop/chatterbox-tts)
- [Claude Code](https://spiral.ai/integrations/claude-code/chatterbox-tts)
- [Cline](https://spiral.ai/integrations/cline/chatterbox-tts)
- [Codex](https://spiral.ai/integrations/codex/chatterbox-tts)
- [Cursor](https://spiral.ai/integrations/cursor/chatterbox-tts)
- [Devin](https://spiral.ai/integrations/devin/chatterbox-tts)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/chatterbox-tts)
- [Gemini](https://spiral.ai/integrations/gemini/chatterbox-tts)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/chatterbox-tts)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/chatterbox-tts)
- [goose](https://spiral.ai/integrations/goose/chatterbox-tts)
- [Grok](https://spiral.ai/integrations/grok/chatterbox-tts)
- [Grok Build](https://spiral.ai/integrations/grok-build/chatterbox-tts)
- [Hermes](https://spiral.ai/integrations/hermes/chatterbox-tts)
- [Instinct](https://spiral.ai/integrations/instinct/chatterbox-tts)
- [Manus](https://spiral.ai/integrations/manus/chatterbox-tts)
- [Muse](https://spiral.ai/integrations/muse/chatterbox-tts)
- [Muse Code](https://spiral.ai/integrations/muse-code/chatterbox-tts)
- [n8n](https://spiral.ai/integrations/n8n/chatterbox-tts)
- [Notion](https://spiral.ai/integrations/notion/chatterbox-tts)
- [OpenClaw](https://spiral.ai/integrations/openclaw/chatterbox-tts)
- [opencode](https://spiral.ai/integrations/opencode/chatterbox-tts)
- [Perplexity](https://spiral.ai/integrations/perplexity/chatterbox-tts)
- [Raycast](https://spiral.ai/integrations/raycast/chatterbox-tts)
- [VS Code](https://spiral.ai/integrations/vscode/chatterbox-tts)
- [Windsurf](https://spiral.ai/integrations/windsurf/chatterbox-tts)
- [Zapier](https://spiral.ai/integrations/zapier/chatterbox-tts)

## More dots guides

- [Chatterbox Speech to Speech](https://spiral.ai/integrations/dots/chatterbox-speech-to-speech)
- [Cohere Transcribe](https://spiral.ai/integrations/dots/cohere-transcribe)
- [Chatterbox Multilingual](https://spiral.ai/integrations/dots/chatterbox-multilingual)
- [DeepFilterNet 3](https://spiral.ai/integrations/dots/deepfilternet-3)
- [Chatterbox HD Speech to Speech](https://spiral.ai/integrations/dots/chatterbox-hd-speech-to-speech)
- [Demucs](https://spiral.ai/integrations/dots/demucs)

## Questions about Chatterbox TTS in dots

**Can dots use Chatterbox TTS?**

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

**How much does Chatterbox TTS cost in dots?**

Each item in `text` adds $0.0325. 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 Chatterbox TTS in dots?**

You need no fal account. dots uses one Spiral API key for every tool, and Spiral runs Chatterbox TTS on its own fal account.

**How long does it take to set up Chatterbox TTS 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 Chatterbox TTS runs?**

Chatterbox TTS runs in the background. dots starts the run, checks on it and gives you the audio when it's ready.

**Does Chatterbox TTS support languages other than English?**

The original Chatterbox TTS is documented as English. Chatterbox Multilingual provides broader language support, so its language list does not apply here.

**How do I make the delivery more expressive?**

Try emotional exaggeration around 0.7 and guidance around 0.3 as a starting point for dramatic speech. Listen before increasing intensity further, since extreme exaggeration can be unstable.

**Why does a more expressive reading sound faster?**

Higher exaggeration tends to speed up speech. Lowering guidance toward 0.3 can help restore a slower, more deliberate delivery.

**Can I add laughter with bracketed tags?**

Explicit vocal-reaction tags are documented for Chatterbox Turbo. For Chatterbox TTS, use the reference voice and emotional exaggeration controls instead of relying on those tags.

**Does Chatterbox TTS watermark its audio?**

Yes. Chatterbox includes PerTh watermarking in its generated audio.

