- name
- minimax-tts
- description
- Manage MiniMax Speech 2.8 T2A (text-to-audio) and voice catalog lookups. Trigger when you need a precise MiniMax voice_id, a Speech 2.8 TTS request, or to list the available MiniMax system/cloned/generated voices.
MiniMax Speech 2.8 helper
- Install dependencies. Run
pip install requestsin the environment that will execute the script. The CLI talks to MiniMax's REST API, so you only need therequestslibrary on top of Python 3.11+. - Set your MiniMax credential. Export
MINIMAX_API_KEYwith the API key the user promised to supply. The script will refuse to run without it. - Use the bundled CLI.
scripts/minimax_tts.pyexposes two subcommands:
- tts: calls POST https://api.minimax.io/v1/t2a_v2 (Speech 2.8 T2A HTTP) with the desired voice_id, voice settings, audio configuration, and optional voice effects. Example:
python scripts/minimax_tts.py tts \
--text "Tonight in Shenzhen the skies are clear." \
--voice-id "Sweet_Girl_2" \
--model speech-2.8-hd \
--audio-format mp3 \
--output minimax-weather.mp3The script decodes the hex/base64 payload, saves the file, and prints metadata. Override the endpoint with --endpoint if you must hit https://api-uw.minimax.io/v1/t2a_v2 or another region. - voices: calls POST https://api.minimax.io/v1/get_voice to enumerate system, voice_cloning, voice_generation, or all categories. Example:
python scripts/minimax_tts.py voices --voice-type all --print-response- Customize TTS payloads via CLI switches. Use
--speed,--vol,--pitch, and--language-boostto shape the voice. Control audio fidelity with--sample-rate,--bitrate,--audio-format, and--channel. Add pronunciation overrides (--pronunciation "emoji=ee-moh-jee") or mix timbres (--timbre-weight "Sweet_Girl_2=0.8").--voice-modify-*flags let you nudge pitch/intensity/timbre or append a sound effect such as"spacious_echo".--output-formattells the script how the API returns audio (hex,base64, or a downloadurl). - Handle the JSON. By default the script prints the
extra_infofield so you can read bitrate/sample rate/length. Use--print-responseon either subcommand to dump the entire API payload for debugging. Save catalog JSON to disk with--output <path>when you need to reference voices later.
Keep this skill loaded any time you are asked for MiniMax-specific voices or when precise speech settings are required. The CLI gives you deterministic control over voice_id, model, and audio quality so you always get the Sweet_Girl_2 (or any other) tone you expect. If you need to script these requests from another tool, copy the relevant requests.post logic from scripts/minimax_tts.py.