クローン用音声を照会

`file_id` を指定して、まだ使っていないアップロードファイルを 1 件照会します。無料です。

GET/v1/files/retrieve

照会できるのはあなた自身がアップロードした有効なファイルのみです。クローンに使用済み、または 24 時間を超えたファイルは 404 を返します。

クローン用音声を照会

curl "https://api.hop-base.com/v1/files/retrieve?file_id=123456789" \
  -H "Authorization: Bearer $HOPBASE_API_KEY"

200application/json

{
  "file": {
    "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 キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります

クエリパラメーター

file_id:必須integer

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

範囲≥ 1

レスポンス

200ファイル情報

file:任意object

アップロードしたファイル

base_resp:任意object

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

エラー

400file_id must be a positive integer

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

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

503file lookup is temporarily unavailable; please retry

ヘッダー

クエリパラメーター

レスポンス

エラー

関連ページ