本文へスキップ

ボイスを削除

MiniMax のクローンボイスまたは Doubao のクローンボイスを削除します。無料。

POST/v1/delete_voice

MiniMax と Doubao はこのパスを共有しています。下でシリーズを選んでリクエストボディとレスポンスを確認してください。

MiniMax Speech 2.8:削除できるのはクローンボイスのみで、voice_type は voice_cloning 固定です。削除後は同じ名前の voice_id で再度クローンできます。削除済みのボイスで合成すると 400 を返します。

Doubao ボイスクローン 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、または未知のフィールドがある。Doubao:model の欠落、voice_id is required、未知のフィールド、または unknown_voice(voice_id が存在しない)
401キー未指定、キーが無効または期限切れ(missing_api_key / invalid_api_key / api_key_expired)
409Doubao:voice_clone_in_progress。同じアカウントのクローンまたは削除リクエストがまだ終わっていません
413リクエストボディが 64 KiB を超えた:request body is too large
503ボイスまたはファイルの登録が一時的に利用できません。しばらくしてから再試行してください(例:voice registry is temporarily unavailable; please retry)

関連ページ