ファイルとバッチ

ファイルの一覧取得

アップロードされたバッチファイルおよび画像参照ファイルの一覧を取得します。

GET
/v1/files

バッチファイルおよび画像参照ファイルの一覧を取得します。purpose=batch、purpose=batch_output、purpose=user_data、または purpose=vision を使用してフィルタリングできます。

Anthropic Filesヘッダーを使用すると、同じAPIで現在のワークスペース内のAnthropic形式のファイルを一覧表示できます。

例

リクエスト

cURL
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で作成された画像参照ファイルを返します。

レスポンス例

レスポンス

200 OK
{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
  "first_id": "file_abc123",
  "last_id": "file_abc123",
  "has_more": false
}

重要なフィールド

objectstring
常に list となります。
dataarray
ファイルの一覧です。
has_moreboolean
has_more が true の場合、さらに結果が存在します。

認証

BearerAuth
AuthorizationBearer <token>

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

場所: header

クエリパラメータ

limit?integer
範囲1 <= value <= 1000
デフォルト20
after?string
after_id?string

Anthropic Filesカーソル。この公開ファイルID以降のファイルを返します。Anthropic Filesベータヘッダーが必要であり、before_idと組み合わせることはできません。

before_id?string

Anthropic Filesカーソル。この公開ファイルID以前のファイルを返します。Anthropic Filesベータヘッダーが必要であり、after_idと組み合わせることはできません。

scope_id?string

予約済みのAnthropic Filesスコープカーソル。TokenLabは現在、この値を黙って無視するのではなく、明示的な非サポートエラーを返します。

purpose?string

オプションのファイル目的フィルタ。batchおよびbatch_outputはBatch APIファイルをカバーし、user_dataおよびvisionはTokenLabの画像/参照ファイルバインディングをカバーします。Anthropic Files APIモードは、このクエリパラメータではなくAnthropicヘッダーによって選択されます。

指定できる値

  • "batch"
  • "batch_output"
  • "user_data"
  • "vision"

ヘッダー

anthropic-beta?string

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

レスポンス

application/json

application/json