クローン用音声を削除

まだ使っていないアップロードファイルを 1 件削除します。無料で、クローン済みのボイスには影響しません。

POST/v1/files/delete

file_id と purpose はアップロード時と一致している必要があります。ファイルを削除してもクローン済みのボイスには影響しません。クローンに成功すると元のファイルはもともと自動削除されるため、これは使わなかったファイルの整理にのみ使います。

クローン用音声を削除

curl https://api.hop-base.com/v1/files/delete \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": 123456789,
    "purpose": "voice_clone"
  }'

200application/json

{
  "file_id": 123456789,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

ヘッダー

Authorization:必須string

Bearer sk-…：コンソールの「API キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります

リクエストボディJSON

file_id:必須integer

アップロード時に返されたファイル ID

範囲≥ 1

purpose:必須string

アップロード時の用途

取りうる値voice_cloneprompt_audio

レスポンス

200削除済み

file_id:任意integer

削除したファイルの ID

base_resp:任意object

成功時は {"status_code": 0, "status_msg": "success"}。エラーはここに入らず、200 以外のステータスコードと error オブジェクトで返されます

エラー

400file_id が正の整数でない、purpose の値が不正、または未知のフィールドがある

401キー未指定、キーが無効または期限切れ（missing_api_key / invalid_api_key / api_key_expired）

404ファイルが存在しない、使用済み、期限切れ、または purpose が一致しない：file_id N does not exist

413リクエストボディが 64 KiB を超えた：request body is too large

503file deletion is temporarily unavailable; please retry など

ヘッダー

リクエストボディJSON

レスポンス

エラー

関連ページ