ファイルとバッチ
ファイルの一覧取得
アップロードされたバッチファイルおよび画像参照ファイルの一覧を取得します。
バッチファイルおよび画像参照ファイルの一覧を取得します。purpose=batch、purpose=batch_output、purpose=user_data、または purpose=vision を使用してフィルタリングできます。
Anthropic Filesヘッダーを使用すると、同じAPIで現在のワークスペース内のAnthropic形式のファイルを一覧表示できます。
リクエスト
curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
-H "Authorization: Bearer sk-your-api-key"フィルタ
- バッチファイルおよび画像参照ファイルの場合、
limitは1〜10000(デフォルトは10000)で、ページネーションにはafterを使用します。Anthropic Filesモードの場合、limitは1〜1000(デフォルトは20)です。after_idまたはbefore_idのいずれかを使用し、両方を同時に使用することはできません。 purposeにはbatch、batch_output、user_data、またはvisionを指定できます。user_dataおよびvisionは、利用可能な場合にTokenLabで作成された画像参照ファイルを返します。
レスポンス
{
"object": "list",
"data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
"first_id": "file_abc123",
"last_id": "file_abc123",
"has_more": false
}重要なフィールド
list となります。has_more が true の場合、さらに結果が存在します。認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
クエリパラメータ
1 <= value <= 100020Anthropic Filesカーソル。この公開ファイルID以降のファイルを返します。Anthropic Filesベータヘッダーが必要であり、before_idと組み合わせることはできません。
Anthropic Filesカーソル。この公開ファイルID以前のファイルを返します。Anthropic Filesベータヘッダーが必要であり、after_idと組み合わせることはできません。
予約済みのAnthropic Filesスコープカーソル。TokenLabは現在、この値を黙って無視するのではなく、明示的な非サポートエラーを返します。
オプションのファイル目的フィルタ。batchおよびbatch_outputはBatch APIファイルをカバーし、user_dataおよびvisionはTokenLabの画像/参照ファイルバインディングをカバーします。Anthropic Files APIモードは、このクエリパラメータではなくAnthropicヘッダーによって選択されます。
指定できる値
- "batch"
- "batch_output"
- "user_data"
- "vision"
ヘッダー
Anthropic Files APIモードを使用するにはfiles-api-2025-04-14を含めてください。
レスポンス
application/json
application/json