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