文件管理

常见路径：

• GET /minimaxi/v1/files/retrieve?file_id=...
• GET /minimaxi/v1/files/retrieve_content?file_id=...

• retrieve 返回文件对象（含 download_url/bytes 等）；
• retrieve_content 直接返回二进制流，建议加 -L 跟随重定向并输出到文件；
• 可选参数：task_id、channel_id（用于定位来源渠道）。

​

上传复刻音频（voice_clone / prompt_audio）

路径：POST /minimaxi/v1/files/upload

• 媒介类型：multipart/form-data
• 字段：
  • purpose：
    • voice_clone：上传待复刻音频（10 秒–5 分钟）
    • prompt_audio：上传示例音频（用于 clone_prompt，时长 < 8 秒）
  • file：待上传的音频文件，支持 mp3/m4a/wav，≤ 20MB

curl -X POST "$BASE_URL/minimaxi/v1/files/upload" \
  -H "Authorization: Bearer $TOKEN" \
  -F "purpose=voice_clone" \  # 或 prompt_audio
  -F "file=@/path/to/audio.wav"

声音快速复刻（voice cloning）推荐配合 POST /minimaxi/v1/voice_clone 使用：
1）先通过 /minimaxi/v1/files/upload 上传复刻音频拿到 file_id；
2）再在 POST /minimaxi/v1/voice_clone 中传入对应的 file_id 与 voice_id 完成音色快速复刻。

curl -L "$BASE_URL/minimaxi/v1/files/retrieve_content?file_id=$FILE_ID" \
  -H "Authorization: Bearer $TOKEN" \
  --output "$FILE_ID.bin"