クローン用音声を一覧表示

まだ使っていない、有効なアップロードファイルを一覧表示します。無料です。

GET/v1/files/list

あなた自身がアップロードし、まだクローンに使われておらず、期限切れでない（アップロードから 24 時間以内の）ファイルのみを返し、purpose で絞り込みます。アップロード済みの音声のダウンロードには対応していません。

クローン用音声を一覧表示

curl "https://api.hop-base.com/v1/files/list?purpose=voice_clone" \
  -H "Authorization: Bearer $HOPBASE_API_KEY"

200application/json

{
  "files": [
    {
      "file_id": 123456789,
      "bytes": 1048576,
      "created_at": 1790380800,
      "filename": "my_voice.mp3",
      "purpose": "voice_clone"
    }
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

ヘッダー

Authorization:必須string

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

クエリパラメーター

purpose:必須string

一覧表示するファイルの用途

取りうる値voice_cloneprompt_audio

レスポンス

200ファイル一覧

files:任意array of object

ファイル

base_resp:任意object

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

エラー

400purpose must be "voice_clone" or "prompt_audio"

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

503file lookup is temporarily unavailable; please retry

ヘッダー

クエリパラメーター

レスポンス

エラー

関連ページ