刪除音色

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

回傳

錯誤

相關頁面