TokenLab

檔案與批次

列出批次

列出當前 API 金鑰組織的批次作業。

GET
/v1/batches

概述

此端點是 TokenLab 的 OpenAI 相容批次 API 的一部分。批次作業使用上傳的 JSONL 檔案,異步運行,並可以稍後返回輸出/錯誤檔案。

注意事項

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

範例

請求

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

請求 / 回應

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

操作提示

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

回應範例

回應

200 OK
{
  "object": "list",
  "data": [{ "id": "batch_abc123", "object": "batch", "status": "completed" }],
  "first_id": "batch_abc123",
  "last_id": "batch_abc123",
  "has_more": false
}

重要欄位

objectstring
回應物件類型。
dataarray
本次回應返回的列表或載荷。
statusstring
該資源目前的生命週期狀態。
has_moreboolean
has_more 為 true 時還有後續結果。

授權

BearerAuth
AuthorizationBearer <token>

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

位置: header

查詢參數

limit?integer
範圍1 <= value <= 100
after?string

回應

application/json

application/json