[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [MiniMax Speech 2.5 HD](https://spiral.ai/integrations/muse-code/minimax-speech-2-5-hd)

# How to Use MiniMax Speech 2.5 HD in Muse Code

MiniMax Speech 2.5 HD turns written scripts into voiceovers for lessons, product demos, and narrated content. Choose it for narration work; MiniMax Speech 2.5 Turbo emphasizes faster speech generation.

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

## Prompts to try with MiniMax Speech 2.5 HD in Muse Code

- Read this project's README and write a 150-word spoken introduction for a new user. Use MiniMax Speech 2.5 HD to narrate it at normal speed and save the script with the audio.
- Use the onboarding documentation to create a narrated first-task lesson with MiniMax Speech 2.5 HD. Split it into sections under 5,000 characters and read at 0.9 times normal speed.
- Prepare a spoken summary of the project's latest release notes using MiniMax Speech 2.5 HD. Enable English number normalization, generate a short sample containing the version numbers first, and save the final narration as MP3.
- Read this paragraph aloud with MiniMax Speech 2.5 HD 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 2.5 HD.

## How to set up MiniMax Speech 2.5 HD in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse 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 2.5 HD**: 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/preview/speech-2.5-hd",
    "input": {
      "text": "Hello world! This is a test of the text-to-speech system."
    }
  }'
```

Then paste one of the prompts above: Muse Code finds MiniMax Speech 2.5 HD on Spiral, shows the price and runs it.

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

## MiniMax Speech 2.5 HD tools and prices

- [Minimax](https://spiral.ai/tools/fal/fal-ai/minimax/preview/speech-2.5-hd) (fal): $0.13 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 | Persian, Filipino, Tamil, 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 2.5 HD in Muse Code?

Turn project documentation and release notes into spoken walkthroughs with MiniMax Speech 2.5. A coding agent can prepare narration from the repository, divide long scripts into sections, and save audio alongside the reviewed text.

### Product walkthrough narration

Turn a reviewed product script into spoken instructions. Generate each section separately so you can replace a changed explanation without redoing the entire walkthrough.

### Multilingual product explainers

Create separate voiceovers from approved translations of a product explanation. Review names and technical terms in each language before assembling the final video.

### Short course lessons

Narrate lessons in sections of up to 5,000 characters. Try a slower reading for definitions and worked examples.

### Spoken daily briefings

Convert a checked summary of news, project progress, or operational updates into a short audio briefing. Keep dates and figures explicit in the spoken script.

### Customer service messages

Generate spoken greetings, service notices, and answers to common questions from approved copy. Prepare separate scripts for each supported audience language.

### Audio editions of articles

Adapt an article for listening, removing navigation text and rewriting visual references. Split longer pieces into sections before generating speech.

### Voiceover script reviews

Listen to draft narration before recording or publishing. Compare pacing across two short readings to find sentences that need rewriting.

## Overview

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

## MiniMax Speech 2.5 HD in other agents

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

## More Muse Code guides

- [MiniMax Music 3](https://spiral.ai/integrations/muse-code/minimax-music-3)
- [MiniMax Speech 2.5 Turbo](https://spiral.ai/integrations/muse-code/minimax-speech-2-5-turbo)
- [MiniMax Music 2.6](https://spiral.ai/integrations/muse-code/minimax-music-2-6)
- [MiniMax Speech 2.6 HD](https://spiral.ai/integrations/muse-code/minimax-speech-2-6-hd)
- [MiniMax Music 2.5](https://spiral.ai/integrations/muse-code/minimax-music-2-5)
- [MiniMax Speech 2.6 Turbo](https://spiral.ai/integrations/muse-code/minimax-speech-2-6-turbo)

## Questions about MiniMax Speech 2.5 HD in Muse Code

**Can Muse Code use MiniMax Speech 2.5 HD?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run MiniMax Speech 2.5 HD like any built-in tool.

**How much does MiniMax Speech 2.5 HD cost in Muse Code?**

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

**Do I need a fal account to use MiniMax Speech 2.5 HD in Muse Code?**

No. Spiral runs MiniMax Speech 2.5 HD 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 2.5 HD in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while MiniMax Speech 2.5 HD runs?**

MiniMax Speech 2.5 HD runs in the background. Muse Code starts the run, checks on it and gives you the audio when it's ready.

**When should I choose HD or Turbo?**

Use MiniMax Speech 2.5 HD for narration projects such as lessons and product walkthroughs. MiniMax Speech 2.5 Turbo emphasizes fast generation, making it a practical choice for frequent updates and script revisions.

**Can MiniMax Speech 2.5 handle multilingual narration?**

Yes. MiniMax reports support for more than 40 languages. Prepare and review the script in each target language before generating the narration.

**How much text can I turn into speech at once?**

Keep each generation within 5,000 characters. For a longer lesson or article, split the script at paragraph or section boundaries and keep the voice and speed consistent.

**How should I handle numbers in English scripts?**

Enable English text normalization to improve number reading. For identifiers or other numbers that need a specific reading, write the intended spoken words into the script and check a short sample.

**Which audio formats can MiniMax Speech 2.5 produce?**

MiniMax Speech 2.5 supports MP3, PCM, and FLAC output. Choose the format your playback or editing workflow needs.

