跳到正文

删除音色

删除你的 MiniMax 克隆音色或豆包复刻音色;免费。

POST/v1/delete_voice

MiniMax 与豆包共用这个路径,在下方选择系列查看请求体与响应。

MiniMax Speech 2.8:只能删除克隆音色,voice_type 固定为 voice_cloning。删除后同名 voice_id 可以重新克隆;已删除的音色合成时返回 400。

豆包声音复刻 2.0:请求体必须带 "model": "seed-icl-2.0" 与要删除的 voice_id。删除后这个 voice_id 不能再用,复刻音色名额随即释放,可以重新复刻。

请求头

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 对象

错误

400MiniMax:voice_type must be "voice_cloning"、voice_id "…" does not exist,或出现未知字段。豆包:缺 model、voice_id is required、未知字段,或 unknown_voice(voice_id 不存在)
401没带密钥、密钥无效或已过期(missing_api_key / invalid_api_key / api_key_expired)
409豆包:voice_clone_in_progress,同一帐户的复刻或删除请求还没结束
413请求体超过 64 KiB:request body is too large
503音色或文件登记暂不可用,稍后重试(如 voice registry is temporarily unavailable; please retry)

相关页面