MiniMax Speech 2.8 辅助工具

1. 安装依赖项。 在将执行该脚本的环境中运行 pip install requests。CLI 通过 REST API 与 MiniMax 通信，因此除 Python 3.11+ 外，仅需额外安装 requests 库。
2. 配置 MiniMax 凭据。 将用户承诺提供的 API Key 导出为环境变量 MINIMAX_API_KEY。若未设置该变量，脚本将拒绝运行。
3. 使用内置 CLI 工具。 scripts/minimax_tts.py 提供两个子命令：
   • tts：向 POST https://api.minimax.io/v1/t2a_v2（Speech 2.8 T2A HTTP 接口）发起请求，传入目标 voice_id、语音设置、音频配置及可选的语音效果。示例：

     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.mp3
     

     脚本会自动解码 hex/base64 格式的响应载荷，保存音频文件，并输出元数据信息。如需调用其他地域的端点（例如 https://api-uw.minimax.io/v1/t2a_v2），可通过 --endpoint 参数覆盖默认地址。
   • voices：向 POST https://api.minimax.io/v1/get_voice 发起请求，枚举 system、voice_cloning、voice_generation 或 all 类别下的可用音色。示例：

     python scripts/minimax_tts.py voices --voice-type all --print-response
     

4. 通过 CLI 参数自定义 TTS 请求载荷。 使用 --speed、--vol、--pitch 和 --language-boost 调整语音表现；使用 --sample-rate、--bitrate、--audio-format 和 --channel 控制音频保真度；支持发音覆盖（如 --pronunciation "emoji=ee-moh-jee"）和音色混合（如 --timbre-weight "Sweet_Girl_2=0.8"）；--voice-modify-* 系列参数可用于微调音高/强度/音色，或附加音效（如 "spacious_echo"）；--output-format 指定 API 返回音频的方式（hex、base64 或下载 url）。
5. 处理 JSON 响应。 默认情况下脚本仅打印 extra_info 字段，便于查看比特率、采样率、时长等信息。在任一子命令中添加 --print-response 可完整输出原始 API 响应，用于调试；如需后续参考音色列表，可使用 --output 将目录 JSON 保存至本地磁盘。

当被要求提供 MiniMax 特定音色，或需要精确控制语音参数时，请始终启用此技能。该 CLI 提供对 voice_id、模型及音频质量的确定性控制，确保你始终获得预期的 Sweet_Girl_2（或其他指定）音色。若需从其他工具中自动化调用这些接口，可直接复用 scripts/minimax_tts.py 中对应的 requests.post 逻辑。