[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [GPT-4o mini TTS](https://spiral.ai/integrations/dots/gpt-4o-mini-tts)

# How to Use GPT-4o mini TTS in dots

GPT-4o mini TTS turns scripts into narration for demos, readouts, and support messages. Written delivery directions let you shape its tone, pacing, and emphasis.

|  |  |
| --- | --- |
| Model | GPT-4o mini TTS |
| Available through | OpenAI |
| Category | Audio |
| Price | Input text: $0.78 per 1M tokens. Output speech: $15.60 per 1M audio tokens. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with GPT-4o mini TTS in dots

- Each weekday morning, summarize the confirmed tasks available to you in no more than 100 words. Narrate the summary with GPT-4o mini TTS using a calm tone and pauses between priorities.
- Every Friday, turn the approved weekly updates available to you into a 120-word spoken recap with GPT-4o mini TTS. Use a neutral tone and distinguish completed work from upcoming work.
- Whenever an approved product announcement becomes available to you, prepare a narration script under 1,000 characters. Read it with GPT-4o mini TTS using a measured pace and emphasis on the main change.
- Each evening, turn the next day's confirmed agenda available to you into a short spoken briefing with GPT-4o mini TTS. Read times clearly and pause between events; skip generation if no agenda is available.
- For each new approved Spanish help message available to you, generate a separate recording with GPT-4o mini TTS. Keep the original wording, use an even pace, and include the text alongside the audio for pronunciation review.

## How to set up GPT-4o mini 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 GPT-4o mini 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": "openai",
    "model": "gpt-4o-mini-tts",
    "input": {
      "input": "<input>",
      "voice": "ash"
    }
  }'
```

Then paste one of the prompts above: dots finds GPT-4o mini TTS on Spiral, shows the price and runs it.

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

## GPT-4o mini TTS tools and prices

- [GPT-4o mini TTS](https://spiral.ai/tools/openai/gpt-4o-mini-tts) (OpenAI): Input text: $0.78 per 1M tokens. Output speech: $15.60 per 1M audio tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| speed | 0.25 to 4 | 1 | The speed of the generated audio. Select a value from `0.25` to `4.0`. `1.0` is the default. |
| instructions |  | — | Control the voice of your generated audio with additional instructions. Does not work with `tts-1` or `tts-1-hd`. |
| response_format | mp3, opus, aac, flac, wav, pcm | mp3 | The format to audio in. Supported formats are `mp3`, `opus`, `aac`, `flac`, `wav`, and `pcm`. |

## What can you do with GPT-4o mini TTS in dots?

Create recurring spoken briefings and narration for new approved content with GPT-4o mini TTS. Have the agent prepare a short script on each run and reuse the same delivery directions.

### Product walkthrough narration

Turn a short walkthrough script into speech. Ask for measured pacing and emphasis on the action viewers should take next.

### Spoken information readouts

Read help text, instructions, or short articles aloud with clear pronunciation and pauses between sections.

### Customer support messages

Voice approved support responses with a calm, reassuring delivery. Keep the explanation and next action easy to hear.

### Telephone menu recordings

Generate separate spoken menu options. Use an even pace and emphasize each option number.

### Localized narration

Generate speech from translated scripts in supported languages. Check pronunciation before using the recordings.

### Short story narration

Give a finished story a spoken delivery with directions for mood, pace, and emphasis. Divide longer stories into short passages.

### Recurring spoken briefings

Have an agent prepare a concise daily update, then narrate that script with a consistent delivery brief.

## Overview

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

## GPT-4o mini TTS in other agents

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

## More dots guides

- [F5-TTS](https://spiral.ai/integrations/dots/f5-tts)
- [GPT-4o mini Transcribe](https://spiral.ai/integrations/dots/gpt-4o-mini-transcribe)
- [Elevenlabs Tts Eleven V3](https://spiral.ai/integrations/dots/elevenlabs-tts-eleven-v3)
- [Gemini 2.5 Flash TTS](https://spiral.ai/integrations/dots/gemini-2-5-flash-tts)
- [Elevenlabs Music v2.5](https://spiral.ai/integrations/dots/elevenlabs-music-v2-5)
- [Gemini 2.5 Pro Preview TTS](https://spiral.ai/integrations/dots/gemini-2-5-pro-preview-tts)

## Questions about GPT-4o mini TTS in dots

**Can dots use GPT-4o mini TTS?**

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

**How much does GPT-4o mini TTS cost in dots?**

Input text: $0.78 per 1M tokens. Output speech: $15.60 per 1M audio tokens. 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 an OpenAI account to use GPT-4o mini TTS in dots?**

You need no OpenAI account. dots uses one Spiral API key for every tool, and Spiral runs GPT-4o mini TTS on its own OpenAI account.

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

GPT-4o mini TTS runs in the background. dots starts the run, checks on it and gives you the audio when it's ready.

**What is GPT-4o mini TTS useful for?**

Use it to narrate product demos, read written information aloud, voice support messages, or tell short stories. It is especially useful when you need to give the narrator specific delivery directions.

**How do I control the delivery?**

Describe the tone, pace, and emphasis separately from the words to be spoken. For example: use a calm tone, keep a measured pace, and stress the next action.

**How much text can GPT-4o mini TTS read at once?**

Keep each passage within both limits: 4,096 characters and 2,000 input tokens. Split longer scripts into short sections before generating narration.

**Can GPT-4o mini TTS speak languages other than English?**

Yes, including Spanish, French, German, and Japanese. Supply text in the language you want spoken; the voices are optimized for English, so check pronunciation when preparing other languages.

**How can I improve acronyms and pauses?**

Write an acronym as spoken letters when needed, such as A-I. Use punctuation and short line breaks to guide pauses, then check the resulting narration.

