Chuyển đến nội dung chính

​
Tổng Quan

Endpoint này chủ yếu phục vụ Batch API tương thích với OpenAI của TokenLab, bao gồm các đầu vào batch đã tải lên và các tệp đầu ra/lỗi được tạo ra. Khi request bật chế độ tương thích Anthropic Files, cùng route này cũng có thể liệt kê các tệp kiểu Anthropic hiện có trong workspace đã gắn. Khi không có header Anthropic, danh sách có thể bao gồm cả file batch và file ảnh/tham chiếu TokenLab. Dùng purpose=batch, purpose=batch_output, purpose=user_data hoặc purpose=vision để thu hẹp danh sách.

​
Ghi Chú

  • Các tệp đầu vào batch phải dùng purpose=batch.
  • Dùng purpose=batch_output để chỉ tập trung vào các tệp đầu ra được tạo ra.
  • completion_window hiện là 24h.
  • Thứ tự đầu ra không được đảm bảo; luôn đối chiếu theo custom_id.
  • Streaming không được hỗ trợ bên trong các mục batch.

​
Ví Dụ

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

​
Yêu Cầu / Phản Hồi

Sử dụng bảng OpenAPI tương tác ở trên để xem schema chính xác.

​
Mẹo Vận Hành

  • Dùng custom_id cho việc đối soát downstream mang tính idempotent.
  • Chỉ kỳ vọng output_file_id và error_file_id sau khi worker hoàn tất batch.
  • Giá batch có thể khác với giá đồng bộ vì các quy tắc giảm giá isBatchRequest=true được áp dụng.

​
Ví dụ phản hồi

{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }]
}

​
Trường quan trọng

​
object
string
Loại object của phản hồi.
​
data
array
Danh sách hoặc payload được trả về trong phản hồi.