ボイスを削除

あなたのクローンボイスを削除し、名前を解放します。無料です。

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

レスポンス

エラー

関連ページ