ファイルとバッチ

ファイルの取得

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

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などのファイルの目的。

認証

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