TokenLab

Tệp và lô

Tạo Batch

Tạo một batch từ tệp JSONL đã tải lên.

POST
/v1/batches

Tổng quan

Tải lên một tệp JSONL với purpose=batch, sau đó sử dụng ID của tệp đó làm input_file_id. Các batch hoàn tất sẽ trả về ID của tệp đầu ra và tệp lỗi.

Lưu ý

  • Các tệp đầu vào của batch phải sử dụng purpose=batch.
  • completion_window hiện tại là 24h.
  • Thứ tự đầu ra có thể khác với thứ tự đầu vào. Hãy khớp từng kết quả bằng custom_id.
  • Streaming không được hỗ trợ bên trong các mục của batch.
  • Các endpoint mục được hỗ trợ là /v1/chat/completions và /v1/embeddings. /v1/responses không được hỗ trợ.

Ví dụ

Yêu cầu

cURL
curl -X POST "https://api.tokenlab.sh/v1/batches" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "input_file_id": "file_abc123",
    "endpoint": "/v1/chat/completions",
    "completion_window": "24h"
  }'

Giá của batch có thể khác với các yêu cầu đồng bộ. Hãy sử dụng mức giá được hiển thị khi tạo batch và hóa đơn cuối cùng.

Ví dụ phản hồi

Phản hồi

200 OK
{
  "id": "batch_abc123",
  "object": "batch",
  "endpoint": "/v1/chat/completions",
  "input_file_id": "file_abc123",
  "completion_window": "24h",
  "status": "validating",
  "output_file_id": null,
  "error_file_id": null,
  "created_at": 1706000000
}

Các trường quan trọng

idstring
ID của Batch.
statusstring
Trạng thái của Batch.
output_file_idstring|null
ID của tệp đầu ra sau khi hoàn tất.

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Header

X-TokenLab-Delivery-Policy?string

Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.

Giá trị hợp lệ

  • "auto"
  • "verified"
  • "official"

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json

application/json