ファイルとバッチ

ファイルのアップロード

バッチファイル、画像参照、またはAnthropic形式のファイルをアップロードします。

POST
/v1/files

ファイルの用途 (File Purposes)

  • バッチファイル: /v1/batches には purpose=batch を使用します。
  • 画像/参照ファイル: ファイルベースの画像リクエストには purpose=user_data または purpose=vision を使用します。
  • Anthropic Files: anthropic-beta: files-api-2025-04-14 ヘッダーを追加します。

制限事項

用途最大サイズ
batch200 MiB
user_data, vision50 MiB
Anthropic Files500 MB

これより大きいファイルは 413 request_too_large を返します。batch、user_data、vision 以外の purpose は 400 unsupported_purpose を返します。file を含まないリクエストは 400 を返します。

batch ファイルはアップロードから24時間後に期限切れとなります。これを変更するには、フォームフィールド expires_after[anchor]=created_at および expires_after[seconds] を 3600 から 2592000 (30日間) の間で送信してください。レスポンスの expires_at フィールドに時刻が表示されます。

例

リクエスト

cURL
curl -X POST "https://api.tokenlab.sh/v1/files" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "purpose=batch" \
  -F "file=@batch-input.jsonl;type=application/jsonl"

画像ファイルの入力

この同じ /v1/files ルートを使用して、/v1/images/edits 用の画像参照ファイルをアップロードできます。

  • purpose=user_data または purpose=vision を使用してください。
  • オプションで model を含めて画像編集モデルを選択できます。デフォルトは gpt-image-2 です。
  • 返される file_id は選択した画像編集設定に紐付けられ、images[].file_id で再利用可能です。

Anthropic Files API モード

  • Anthropic Files を使用するには anthropic-beta: files-api-2025-04-14 を追加してください。
  • Anthropic モードでは、元のファイルを直接アップロードし、purpose=batch は送信しないでください。
  • 返される file_id は現在の Workspace 内でのみ有効であり、/v1/messages リクエストで再利用できます。
  • アップロードしたファイルを Anthropic メッセージコンテンツから参照する場合は、引き続き Anthropic ネイティブのヘッダー (x-api-key、anthropic-version、および必要な場合はベータヘッダー) を使用してください。

レスポンス例

レスポンス

200 OK
{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

重要なフィールド

idstring
ファイルID。
purposestring
ファイルに割り当てられた用途。アップロードでは batch、user_data、または vision を受け付けます。
bytesinteger
バイト単位のファイルサイズ。

認証

BearerAuth
AuthorizationBearer <token>

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

場所: header

ヘッダー

anthropic-beta?string

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

リクエストボディ

multipart/form-data

レスポンス

application/json

application/json

application/json

application/json