ファイルとバッチ
ファイルの取得
アップロードされた単一ファイルのメタデータを取得します。
ファイル名、サイズ、目的、作成時間を返します。Anthropicヘッダーがない場合、これはバッチファイルおよび画像参照ファイルを対象とします。Anthropic Filesヘッダーがある場合は、Anthropic形式のファイルを対象とします。
リクエスト
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
-H "Authorization: Bearer sk-your-api-key"画像参照ファイル
このエンドポイントは、TokenLabで作成された画像参照ファイルのメタデータを返すこともできます。statusフィールドはオプションであり、提供されないファイルファミリーの場合は存在しないことがあります。
レスポンス
{
"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