跳到正文

刪除音色

刪除你的 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)

相關頁面