删除音色

POST/v1/delete_voice

只能删除克隆音色，voice_type 固定为 voice_cloning。删除后同名 voice_id 可以重新克隆；已删除的音色合成时返回 400。

删除音色

curl https://api.hop-base.com/v1/delete_voice \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_type": "voice_cloning",
    "voice_id": "MyNarrator01"
  }'

200application/json

{
  "voice_id": "MyNarrator01",
  "created_time": "1790380920",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

请求头

Authorization:必填string

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

请求体参数JSON

voice_type:必填string

固定为 voice_cloning

可选值voice_cloning

voice_id:必填string

要删除的克隆音色名

200已删除

voice_id:可选string

已删除的音色名

created_time:可选string

音色创建时间，Unix 秒的字符串

base_resp:可选object

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

错误

400voice_type must be "voice_cloning"、voice_id "…" does not exist，或出现未知字段

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

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

503音色或文件登记暂不可用，稍后重试（如 voice registry is temporarily unavailable; please retry）

请求头

请求体参数JSON

返回

错误

相关页面