1.7 KiB
1.7 KiB
Troubleshooting
Quick reference
| Error | Cause | Fix |
|---|---|---|
MINIMAX_API_KEY is not set |
Key not set | export MINIMAX_API_KEY="key" |
401 Unauthorized |
Invalid/expired key | Check key validity |
429 Too Many Requests |
Rate limit | Add delays between requests |
TimeoutError |
Network or long text | Use async TTS for long text, check network |
invalid params, method t2a-v2 not have model |
Wrong model name | Use speech-2.8-hd (hyphens, not underscores) |
brotli: decoder process called... |
Encoding issue | Already fixed in utils.py (Accept-Encoding header) |
Environment
API key not set
export MINIMAX_API_KEY="<paste-your-key-here>"
# Verify
echo $MINIMAX_API_KEY
FFmpeg not found
# macOS
brew install ffmpeg
# Ubuntu
sudo apt install ffmpeg
# Verify
ffmpeg -version
Missing Python packages
pip install requests
API errors
Authentication (401)
- Verify API key is correct and not expired
- Check for extra spaces in key value
Rate limiting (429)
Add delays between requests:
import time
for text in texts:
result = tts(text)
time.sleep(1)
Invalid model name
Valid names (use hyphens, must include -hd or -turbo):
speech-2.8-hd(recommended)speech-2.8-turbospeech-2.6-hdspeech-2.6-turbo
Wrong: speech_01, speech_2.6, speech-01
Audio issues
Poor quality
Re-generate with higher settings:
python scripts/minimax_tts.py "text" -o out.mp3 --sample-rate 32000 --model speech-2.8-hd
Invalid emotion
Valid emotions:
- All models: happy, sad, angry, fearful, disgusted, surprised, calm
- speech-2.6 only: + fluent, whisper
- speech-2.8: auto-matched (leave empty, recommended)