上傳檔案

檔案用途 (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-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"
}

重要欄位Copy Anchor Link