檔案與批次
列出批次
列出當前 API 金鑰組織的批次作業。
概述
此端點是 TokenLab 的 OpenAI 相容批次 API 的一部分。批次作業使用上傳的 JSONL 檔案,異步運行,並可以稍後返回輸出/錯誤檔案。
注意事項
- 批次輸入檔案必須使用
purpose=batch。 completion_window目前為24h。- 輸出順序不保證;始終根據
custom_id匹配。 - 批次項目內不支援串流。
請求
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。
回應
{
"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 <= 100after?string
回應
application/json
application/json