ファイルのアップロード

ファイルの用途 (File Purposes)Copy Anchor Link

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

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"

画像ファイルの入力Copy Anchor Link

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

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

Anthropic Files APIモードCopy Anchor Link

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

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

重要なフィールドCopy Anchor Link