删除音色
删除你的 MiniMax 克隆音色或豆包复刻音色;免费。
POST
/v1/delete_voiceMiniMax 与豆包共用这个路径,在下方选择系列查看请求体与响应。
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
要删除的克隆音色名
model:必填string
固定为 seed-icl-2.0,必填;HopBase 按它把请求交给豆包声音复刻
可选值seed-icl-2.0
voice_id:必填string
要删除的复刻音色 ID
返回
200已删除
voice_id:可选string
已删除的音色名
created_time:可选string
音色创建时间,Unix 秒的字符串
base_resp:必填object
成功时为 {"status_code": 0, "status_msg": "success"};错误不走这里,而是非 200 状态码加 error 对象
status_code:可选integer
成功为 0
status_msg:可选string
成功为 success
voice_id:必填string
已删除的复刻音色 ID
deleted:必填boolean
恒为 true
错误
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 large503音色或文件登记暂不可用,稍后重试(如
voice registry is temporarily unavailable; please retry)