---
name: minimax-voice
description: >
  Synthesize spoken voice from text via the MiniMax TTS API. Use when the user wants
  speech, narration, voice-over, audio book, or to hear a line read aloud. Trigger
  on phrases like "say this", "voice this", "speak", "TTS", "read aloud", "narrate".
allowed-tools: Bash(minimax-gen voice *), Bash(minimax-gen --help), Bash(mkdir *), Bash(ls *), Bash(test *), Bash(file *), Read
---

# /minimax-voice — Text-to-Speech

Generate an MP3 (or other audio format) from text using the MiniMax TTS API.

## CLI

```bash
minimax-gen voice "Hello, world." --out /tmp/hello.mp3
minimax-gen voice "Greetings, traveller." --out /tmp/greeting.mp3 \
  --voice English_expressive_narrator --emotion calm --speed 1.1
```

The CLI is at `~/dev/claude/gamedev/minimax-gen/bin/minimax-gen` (or any path the user has on `$PATH`).

## Pick the voice

`t2a_v2` offers 300+ voices. A few useful defaults:

| Voice ID | Tone |
|---|---|
| `English_expressive_narrator` | warm, narrative (default) |
| `English_Graceful_Lady` | calm, feminine |
| `English_PassionateWarrior` | strong, dramatic |
| `English_Comedian` | upbeat, playful |

For the full list, the API model `speech-2.8-hd` exposes them via the docs.

## Audio format

Default: `mp3` 32 kHz 128 kbps mono. Other formats: `pcm`, `flac`, `wav`, `opus`.

## After the call

1. Show the user the path written and the `trace_id` from the sidecar `.meta.json`.
2. Suggest reasonable next steps (preview, regenerate with different emotion).
3. Do NOT print the contents of the meta JSON to the chat — point at the file.

## Never do

- Never echo, log, or commit the contents of `~/.claude-secrets/minimax-auth-token`.
- Never pass the token on a command line — the CLI reads it from the file directly.
- Never write the token to any other file, even a temp file.

## Reference

Full option list: `minimax-gen voice --help`