ファイルとバッチ
ファイル一覧の取得
アップロードされたバッチおよび画像参照ファイルの一覧を取得します。
バッチおよび画像参照ファイルの一覧を取得します。purpose=batch、purpose=batch_output、purpose=user_data、または purpose=vision でフィルタリングできます。
Anthropic Files ヘッダーを使用すると、同じ API で現在の Workspace 内の 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〜10,000(デフォルト10,000)、Anthropic Filesモードの場合は1〜1,000(デフォルト20)。
1 <= value <= 10000Anthropic 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