上傳複製音訊

複製流程第 1 步：上傳錄音或示例片段，拿到一次性使用的 `file_id`；免費。

POST/v1/files/upload

以 multipart/form-data 提交，只接受 purpose 與 file 兩個欄位，其他欄位回傳 400。voice_clone 是要複製的錄音，prompt_audio 是可選的示例片段。格式與大小在上傳時校驗，時長（voice_clone 10 秒至 5 分鐘，prompt_audio 短於 8 秒）在複製時校驗。

檔案只能用一次：複製成功後來源音訊與示例音訊都會自動刪除；複製失敗則保留，可換參數重試。上傳後 24 小時內未使用的檔案自動刪除。已上傳的音訊不支援下載。金鑰所屬分組須包含 MiniMax 語音模型。

只複製你本人的聲音，或已取得說話人明確書面授權的聲音。

上傳複製音訊

curl https://api.hop-base.com/v1/files/upload \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -F "purpose=voice_clone" \
  -F "file=@my_voice.mp3"

200application/json

{
  "file": {
    "file_id": 123456789,
    "bytes": 1048576,
    "created_at": 1790380800,
    "filename": "my_voice.mp3",
    "purpose": "voice_clone"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

請求標頭

Authorization:必填string

Bearer sk-…：主控台「API 金鑰」中建立的金鑰，所屬分組須包含請求的模型

請求主體參數multipart

purpose:必填string

voice_clone 為要複製的錄音，prompt_audio 為示例片段

可選值voice_cloneprompt_audio

file:必填binary

單個檔案，副檔名 .mp3 / .m4a / .wav，≤20 MB

回傳

200上傳成功

file:選填object

上傳的檔案

base_resp:選填object

成功時為 {"status_code": 0, "status_msg": "success"}；錯誤不走這裡，而是非 200 狀態碼加 error 物件

錯誤

400purpose 取值錯誤、檔案為空、格式不支援、多傳了檔案或欄位

401沒帶金鑰、金鑰無效或已過期（missing_api_key / invalid_api_key / api_key_expired）

404模型不在這把金鑰的分組裡（model_not_found），或路徑不屬於該分組（route_not_found）

413請求體過大：file exceeds the 20 MiB limit

請求標頭

請求主體參數multipart

回傳

錯誤

相關頁面