ファイルを取得

GET https://api.inoneapi.com/v1/files/{file_id}

アップロード状態、判定形式、元のサイズをメタデータで確認します。バイト列、ダウンロードリンク、署名 URL は返さず、COS オブジェクトが現在も存在するかも確認しません。

Authorization: Bearer $INONEAPI_API_KEY を指定し、リクエスト本文は送信しません。アップロードしたキーのみ操作できます。同じユーザーやプロジェクトの別キーでもアクセスできません。推論料金や残高は不要ですが、キーのレート・同時実行制限とプロジェクトの状態は適用されます。

リクエスト項目

パラメーター場所型説明
file_idpathstring必須。アップロードで返された完全な ID。file_ioa_ と小文字の 16 進数 32 桁。Playground やプロバイダーの ID は不可。

リクエスト例

JavaScript は Node.js 20+ のサーバーで INONEAPI_API_KEY を設定して実行します。

curl  https://api.inoneapi.com/v1/files/file_ioa_0123456789abcdef0123456789abcdef \
  -H "Authorization: Bearer $INONEAPI_API_KEY"

応答内容

{
  "id": "file_ioa_0123456789abcdef0123456789abcdef",
  "object": "file",
  "filename": "sample.pdf",
  "mime_type": "application/pdf",
  "media_type": "document",
  "bytes": 1024,
  "status": "ready",
  "created_at": 1789430400,
  "purpose": "user_data"
}

HTTP 200 で返します。id は ID、object は file、filename は元の名前、mime_type は判定 MIME、media_type は image/video/audio/document、bytes はバイト数、created_at は Unix 秒、purpose は user_data です。status は uploading または ready で、モデルリクエストには ready のみ利用できます。

エラーと制約

不正・不存在・別キーの ID は 404 FILE_NOT_FOUND。メタデータ取得障害は 503 FILE_STORAGE_UNAVAILABLE。認証、キーの状態、レート制限も適用されます。

uploading の取得は 409 ではなく HTTP 200 のメタデータです。モデルでの参照は失敗します。中断したアップロードは自動復旧を保証しないため、無制限にポーリングしないでください。COS の 1 日ライフサイクルは非同期で、expires_at は返しません。削除済みでも ready が残る場合は再アップロードが必要です。メタデータ取得では保存期間は延長されません。

ファイルガイド · POST /v1/files · エラーコード

ファイルを取得 · ドキュメント · InOneAPI