Skip to main content

概述

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

注意事項

  • 批次輸入檔案必須使用 purpose=batch
  • completion_window 目前為 24h
  • 輸出順序不保證;始終通過 custom_id 進行匹配。
  • 批次項目內不支持串流。
  • 目前支援的批次項目端點是 /v1/chat/completions/v1/embeddings;在原生 Responses 批次執行器可用之前,/v1/responses 批次作業會被拒絕。

範例

請求 / 回應

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

操作提示

  • 使用 custom_id 進行冪等的下游對帳。
  • 只有在工作者完成批次後,才會期望 output_file_iderror_file_id
  • 批次定價可能與同步定價不同,因為適用 isBatchRequest=true 的折扣規則。

回應範例

重要欄位

string
用於後續呼叫和支援排障的識別符。
string
該資源目前的生命週期狀態。
string|null
供相關 API 使用的檔案識別符。