檔案與批次
上傳檔案
上傳批次處理檔案、影像參考或 Anthropic 格式檔案。
檔案用途
- 批次處理檔案:針對
/v1/batches使用purpose=batch。 - 影像/參考檔案:針對檔案支援的影像請求使用
purpose=user_data或purpose=vision。 - Anthropic 檔案:加入
anthropic-beta: files-api-2025-04-14標頭。
限制
| 用途 | 最大容量 |
|---|---|
batch | 200 MiB |
user_data, vision | 50 MiB |
| Anthropic 檔案 | 500 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 -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-beta: files-api-2025-04-14以使用 Anthropic Files。 - 在 Anthropic 模式下,請直接上傳原始檔案,且不要發送
purpose=batch。 - 回傳的
file_id僅在當前 Workspace 中有效,並可在/v1/messages請求中重複使用。 - 若您計畫從 Anthropic 訊息內容中參照已上傳的檔案,請繼續使用 Anthropic 原生標頭(
x-api-key、anthropic-version以及必要時的 beta 標頭)。
回應
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}重要欄位
batch、user_data 或 vision。授權
BearerAuth API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
請求標頭
包含 files-api-2025-04-14 以使用 Anthropic Files API 模式。
請求主體
multipart/form-data
回應
application/json
application/json
application/json
application/json