上传文件

文件用途Copy Anchor Link

• 批量文件：使用 purpose=batch，供 /v1/batches 使用。
• 图像/参考文件：使用 purpose=user_data 或 purpose=vision，供基于文件的图像请求使用。
• Anthropic Files：添加 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-beta: files-api-2025-04-14 请求头以切换到 Anthropic 模式。
• 在 Anthropic 模式下，直接上传原始文件，不要传 purpose=batch。
• 返回的 file_id 只在当前工作区可用，可在后续 /v1/messages 请求中复用。
• 如果你要在 Anthropic 消息内容中引用该文件，请继续使用 Anthropic 原生请求头（x-api-key、anthropic-version，以及需要时的 beta header）。

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

重要字段Copy Anchor Link