83887b9649
Includes the minimax-mesh switch to M3.1-Flash-Preview at effort low, README/reflection-state refresh, and removal of two old session logs.
56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
---
|
|
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`
|