列出檔案

概述Copy Anchor Link

此端點主要服務於 TokenLab 的 OpenAI 相容 Batch API，包括上傳的批次輸入檔案以及生成的輸出或錯誤檔案。

當請求選擇 Anthropic Files 相容模式時，同一路由也可以列出繫結工作區中可用的 Anthropic 風格檔案。

不帶 Anthropic 標頭時，列表可能同時包含批次檔案和 TokenLab 圖像/參考檔案。可用 purpose=batch、purpose=batch_output、purpose=user_data 或 purpose=vision 縮小範圍。

注意事項Copy Anchor Link

• 批次輸入檔案必須使用 purpose=batch。
• 使用 purpose=batch_output 以聚焦生成的輸出檔案。
• completion_window 目前為 24h。
• 輸出順序不保證；始終根據 custom_id 匹配。
• 批次項目內不支援串流。

curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
  -H "Authorization: Bearer sk-your-api-key"

請求 / 回應Copy Anchor Link

使用上方的互動式 OpenAPI 面板以獲取確切的架構。

操作提示Copy Anchor Link

• 使用 custom_id 進行冪等的下游對帳。
• 只有在工作者完成批次後，才預期會有 output_file_id 和 error_file_id。

篩選條件Copy Anchor Link

• 批次和圖片參考檔案的 limit 為 1–10000，預設 10000，可用 after 分頁。Anthropic Files 模式的 limit 為 1–1000，預設 20；分頁使用 after_id 或 before_id，不能同時使用。
• purpose 可以是 batch、batch_output、user_data 或 vision。
• 當存在 TokenLab 建立的圖像參考檔案時，user_data 和 vision 會返回這些檔案。

{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
  "first_id": "file_abc123",
  "last_id": "file_abc123",
  "has_more": false
}

重要欄位Copy Anchor Link