[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [MiniMax Speech-02 Turbo](https://spiral.ai/integrations/claude-code/minimax-speech-02-turbo)

# How to Use MiniMax Speech-02 Turbo in Claude Code

MiniMax Speech-02 Turbo suits spoken responses and frequent narration drafts. It emphasizes low latency, rhythm, and stability, while MiniMax Speech-02 HD emphasizes voice quality and similarity.

|  |  |
| --- | --- |
| Model | MiniMax Speech-02 Turbo |
| Available through | fal |
| Category | Audio |
| Price | Each item in `text` adds $0.078. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with MiniMax Speech-02 Turbo in Claude Code

- Use MiniMax Speech-02 Turbo to turn the latest changelog entry into a 120-word spoken release summary. Expand abbreviations and generate a recording for review.
- Use MiniMax Speech-02 Turbo to generate a short audio sample from the project's glossary. Include its hardest technical terms and prepare pronunciation replacements for any readings I specify.
- Read this paragraph aloud with MiniMax Speech-02 Turbo in a calm, warm voice and give me the MP3. Save the result in ./assets.
- Make a 30-second podcast intro voiceover with MiniMax Speech-02 Turbo.
- Turn these release notes into a short audio briefing with MiniMax Speech-02 Turbo.

## How to set up MiniMax Speech-02 Turbo in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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.

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

### Call the Spiral API

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

2. **Run MiniMax Speech-02 Turbo**: 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/minimax/speech-02-turbo",
    "input": {
      "text": "Hello world! This is a test of the text-to-speech system."
    }
  }'
```

Then paste one of the prompts above: Claude Code finds MiniMax Speech-02 Turbo on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## MiniMax Speech-02 Turbo tools and prices

- [MiniMax Speech-02 Turbo · Text to Speech](https://spiral.ai/tools/fal/fal-ai/minimax/speech-02-turbo) (fal): $0.078 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 |
| --- | --- | --- | --- |
| voice_setting |  | {"vol":1,"pitch":0,"speed":1,"voice_id":"Wise_Woman","english_normalization":false} | Voice configuration settings |
| audio_setting |  | — | Audio configuration settings |
| language_boost | Chinese, Chinese,Yue, English, Arabic, Russian, Spanish, French, Portuguese, German, Turkish, Dutch, Ukrainian, Vietnamese, Indonesian, Japanese, Italian, Korean, Thai, Polish, Romanian, Greek, Czech, Finnish, Hindi, Bulgarian, Danish, Hebrew, Malay, Slovak, Swedish, Croatian, Hungarian, Norwegian, Slovenian, Catalan, Nynorsk, Afrikaans, auto | — | Enhance recognition of specified languages and dialects |
| output_format | url, hex | hex | Format of the output content (non-streaming only) |
| pronunciation_dict |  | — | Custom pronunciation dictionary for text replacement |

## What can you do with MiniMax Speech-02 Turbo in Claude Code?

Turn project documentation into spoken walkthroughs, lessons, and release summaries with MiniMax Speech-02. A coding agent can prepare narration from repository files, divide long scripts into sections, and generate recordings for review.

### Product walkthrough narration

Turn a written walkthrough into spoken instructions. Generate one section per screen so individual instructions are easy to revise.

### Lesson explanations

Narrate short teaching scripts, adding a deliberate pause after a question so learners have time to think.

### Article listening editions

Prepare a spoken version of an article, splitting long text at section boundaries and checking names before assembling the recording.

### Spoken release notes

Convert a short release summary into an audio update. Rewrite code fragments and abbreviations as words before narration.

### Customer support responses

Create recordings of approved answers to recurring questions. Keep each answer separate so policy changes require replacing only the affected recording.

### Multilingual teaching audio

Narrate reviewed translations of a lesson in supported languages. Check pronunciation with a fluent reviewer before sharing the recordings.

### Recurring spoken briefings

Turn a prepared daily or weekly summary into a short recording. Check numeric passages and add pauses between topics.

### Narration script review

Listen to alternative openings or explanations before choosing a script. Use the recordings to spot awkward wording and unclear transitions.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## MiniMax Speech-02 Turbo in other agents

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

## More Claude Code guides

- [MiniMax Speech-02 HD](https://spiral.ai/integrations/claude-code/minimax-speech-02-hd)
- [MiniMax Voice Cloning](https://spiral.ai/integrations/claude-code/minimax-voice-cloning)
- [MiniMax Speech 2.8 Turbo](https://spiral.ai/integrations/claude-code/minimax-speech-2-8-turbo)
- [MiniMax Voice Design](https://spiral.ai/integrations/claude-code/minimax-voice-design)
- [MiniMax Speech 2.8 HD](https://spiral.ai/integrations/claude-code/minimax-speech-2-8-hd)
- [Mirelo SFX 2.0 Text to Audio](https://spiral.ai/integrations/claude-code/mirelo-sfx-2-0-text-to-audio)

## Questions about MiniMax Speech-02 Turbo in Claude Code

**Can Claude Code use MiniMax Speech-02 Turbo?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run MiniMax Speech-02 Turbo like any built-in tool.

**How much does MiniMax Speech-02 Turbo cost in Claude Code?**

Each item in `text` adds $0.078. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need a fal account to use MiniMax Speech-02 Turbo in Claude Code?**

No. Spiral runs MiniMax Speech-02 Turbo on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up MiniMax Speech-02 Turbo in Claude Code?**

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

**Does Claude Code wait while MiniMax Speech-02 Turbo runs?**

MiniMax Speech-02 Turbo runs in the background. Claude Code starts the run, checks on it and gives you the audio when it's ready.

**What is MiniMax Speech-02 useful for?**

Use it to turn written scripts into spoken narration, such as lesson explanations, product walkthroughs, and short spoken updates. Educational video narration is a documented use: VideoTutor uses Speech-02 for multilingual audio.

**Can I narrate a whole chapter at once?**

Keep each generation within 5,000 characters. For longer material, split at section or paragraph boundaries and review each recording before assembling the chapter.

**How do I add a deliberate pause?**

Insert a pause marker into the spoken script: <#0.5#> requests half a second of silence. Try it between a question and its answer or between two instructions.

**How can I improve numbers and difficult pronunciations?**

Enable English normalization for scripts containing numbers, and use pronunciation replacements for words that need a specific reading. Check those passages in a short sample before generating the full script.

**Does Speech-02 support every language in newer MiniMax speech models?**

No. MiniMax explicitly excludes Persian, Filipino, and Tamil from Speech-02, so check support before preparing narration in those languages.

