ファイルとバッチ

ファイルの取得

アップロードされた単一ファイルのメタデータを取得します。

GET
/v1/files/{file_id}

ファイル名、サイズ、目的、作成時間を返します。Anthropicヘッダーがない場合、これはバッチファイルおよび画像参照ファイルを対象とします。Anthropic Filesヘッダーがある場合は、Anthropic形式のファイルを対象とします。

例

リクエスト

cURL
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

画像参照ファイル

このエンドポイントは、TokenLabで作成された画像参照ファイルのメタデータを返すこともできます。statusフィールドはオプションであり、提供されないファイルファミリーの場合は存在しないことがあります。

レスポンス例

レスポンス

200 OK
{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

重要なフィールド

idstring
ファイルID。
filenamestring
元のファイル名または生成されたファイル名。
purposestring
batch、batch_output、user_data、visionなどのファイルの目的。
expires_atinteger|null
ファイルに有効期限がある場合、その有効期限を示すUnix時間。

不明なファイルIDやアクセスできないファイルIDを指定した場合は、404 file_not_foundが返されます。

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

パスパラメータ

file_id*string

ヘッダー

anthropic-beta?string

Anthropic Files APIモードを使用するにはfiles-api-2025-04-14を含めてください。

レスポンス

application/json

application/json

application/json