TokenLab

檔案與批次

上傳檔案

上傳批次處理檔案、影像參考或 Anthropic 格式檔案。

POST
/v1/files

檔案用途

  • 批次處理檔案:針對 /v1/batches 使用 purpose=batch。
  • 影像/參考檔案:針對檔案支援的影像請求使用 purpose=user_data 或 purpose=vision。
  • Anthropic 檔案:加入 anthropic-beta: files-api-2025-04-14 標頭。

限制

用途最大容量
batch200 MiB
user_data, vision50 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
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 標頭)。

回應範例

回應

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

重要欄位

idstring
檔案 ID。
purposestring
指派給檔案的用途。上傳時接受 batch、user_data 或 vision。
bytesinteger
檔案大小(以位元組為單位)。

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

請求標頭

anthropic-beta?string

包含 files-api-2025-04-14 以使用 Anthropic Files API 模式。

請求主體

multipart/form-data

回應

application/json

application/json

application/json

application/json