Upload File

File PurposesCopy Anchor Link

• Batch files: use purpose=batch for /v1/batches.
• Image/reference files: use purpose=user_data or purpose=vision for file-backed image requests.
• Anthropic Files: add the anthropic-beta: files-api-2025-04-14 header.

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"

Image File InputsCopy Anchor Link

This same /v1/files route can upload image reference files for /v1/images/edits.

• Use purpose=user_data or purpose=vision.
• Optionally include model to select the image-edit model; it defaults to gpt-image-2.
• The returned file_id is bound to the selected image-edit configuration and can be reused in images[].file_id.

Anthropic Files API ModeCopy Anchor Link

• Add anthropic-beta: files-api-2025-04-14 to use Anthropic Files.
• In Anthropic mode, upload the original file directly and do not send purpose=batch.
• The returned file_id is available only in the current Workspace and can be reused in /v1/messages requests.
• If you plan to reference the uploaded file from Anthropic message content, keep using Anthropic-native headers (x-api-key, anthropic-version, and the beta header when required).

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

Important fieldsCopy Anchor Link