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

Factory Droid · AudioReleased 2025-03-20

How to Use GPT-4o mini TTS in Factory Droid

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.

Prompts to try with GPT-4o mini TTS in Factory Droid

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

Read the README and draft a 100-word introduction to this project using only documented behavior. Use GPT-4o mini TTS to narrate it with a clear, measured delivery, and save the script beside the audio.

GPT-4o mini TTSFactory Droid
Try asking
  • Find the main user tutorial and turn its first task into a short voiceover. Use GPT-4o mini TTS with a patient tone and pauses between actions; keep the script under 1,000 characters.

  • Summarize the latest changelog entry in 80 words, then narrate it with GPT-4o mini TTS. Use a matter-of-fact tone and emphasize the changes users will notice.

  • Find the project's telephone menu text and generate each menu option separately with GPT-4o mini TTS. Keep the delivery slow and even, and emphasize the option numbers.

  • Take the shortest product demo script in this project and make two readings with GPT-4o mini TTS: one calm and measured, one upbeat and brisk. Keep the spoken words identical for comparison.

How to set up GPT-4o mini TTS in Factory Droid

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

Use Spiral's MCP server

  1. 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
  2. Sign in

    Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

  3. 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

  1. Send Factory Droid 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 GPT-4o mini TTS

    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": "openai",
        "model": "gpt-4o-mini-tts",
        "input": {
          "input": "<input>",
          "voice": "ash"
        }
      }'

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

GPT-4o mini TTS providers and prices

Spiral runs GPT-4o mini TTS through OpenAI. Open a card for today's price, with every fee included.

OpenAIDeprecatedAudio
GPT-4o mini TTS
gpt-4o-mini-tts

Settings you can ask for

GPT-4o mini TTS works from your input and instructions. Ask Factory Droid for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Speed0.25 to 41

The speed of the generated audio. Select a value from 0.25 to 4.0. 1.0 is the default.

Response formatmp3, opus, aac, flac, wav, or pcmmp3

The format to audio in. Supported formats are mp3, opus, aac, flac, wav, and pcm.

Every API field of GPT-4o mini TTS is on its tool page: open its card above.

What can you do with GPT-4o mini TTS in Factory Droid?

Add spoken walkthroughs, help readouts, and release summaries to your project with GPT-4o mini TTS. Have the coding agent prepare short scripts from project files and keep delivery directions separate.

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.

Questions about GPT-4o mini TTS in Factory Droid

Can Factory Droid use GPT-4o mini TTS?

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

How much does GPT-4o mini TTS cost in Factory Droid?

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

Do I need an OpenAI account to use GPT-4o mini TTS in Factory Droid?

No. Spiral runs GPT-4o mini TTS on its own OpenAI account. You sign in to Spiral once and never paste a key.

How long does it take to set up GPT-4o mini TTS in Factory Droid?

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

Does Factory Droid wait while GPT-4o mini TTS runs?

GPT-4o mini TTS runs in the background. Factory Droid 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.

Get started

Start using GPT-4o mini TTS 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 Factory Droid

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