删除克隆音频

删除一个尚未使用的上传文件；免费，不影响已克隆的音色。

POST/v1/files/delete

file_id 与 purpose 须与上传时一致。删除文件不影响已克隆的音色；克隆成功后源文件本就会自动删除，这里只用于清理没用上的文件。

删除克隆音频

curl https://api.hop-base.com/v1/files/delete \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": 123456789,
    "purpose": "voice_clone"
  }'

200application/json

{
  "file_id": 123456789,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

请求头

Authorization:必填string

Bearer sk-…：控制台「API 密钥」里创建的密钥，所属分组须包含请求的模型

请求体参数JSON

file_id:必填integer

上传时返回的文件 ID

范围≥ 1

purpose:必填string

上传时的用途

可选值voice_cloneprompt_audio

200已删除

file_id:可选integer

已删除的文件 ID

base_resp:可选object

成功时为 {"status_code": 0, "status_msg": "success"}；错误不走这里，而是非 200 状态码加 error 对象

错误

400file_id 不是正整数、purpose 取值错误或出现未知字段

401没带密钥、密钥无效或已过期（missing_api_key / invalid_api_key / api_key_expired）

404文件不存在、已使用、已过期或 purpose 不符：file_id N does not exist

413请求体超过 64 KiB：request body is too large

503file deletion is temporarily unavailable; please retry 等

请求头

请求体参数JSON

返回

错误

相关页面