上传克隆音频

克隆流程第 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

返回

错误

相关页面