TokenLab

Tệp và lô

Tạo Lô

Tạo một công việc lô tương thích với OpenAI từ một tệp đầu vào đã tải lên.

POST
/v1/batches

Tổng Quan

Điểm cuối này là một phần của API Lô tương thích với OpenAI của TokenLab. Các công việc lô sử dụng các tệp JSONL đã tải lên, chạy không đồng bộ và có thể trả về các tệp đầu ra/lỗi sau.

Ghi Chú

  • Các tệp đầu vào lô phải sử dụng purpose=batch.
  • completion_window hiện tại là 24h.
  • Thứ tự đầu ra không được đảm bảo; luôn khớp theo custom_id.
  • Streaming không được hỗ trợ bên trong các mục lô.
  • Các endpoint được hỗ trợ cho mục lô là /v1/chat/completions và /v1/embeddings. Không hỗ trợ /v1/responses.

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"
  }'

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

Sử dụng bảng điều khiển OpenAPI tương tác ở trên để có sơ đồ chính xác.

Mẹo Vận Hành

  • Sử dụng custom_id cho việc đối chiếu không thay đổi ở phía hạ nguồn.
  • Mong đợi output_file_id và error_file_id chỉ sau khi công nhân hoàn tất lô.

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
}

Trường quan trọng

idstring
Định danh dùng cho lần gọi tiếp theo và hỗ trợ.
statusstring
Trạng thái vòng đời hiện tại của tài nguyên.
output_file_idstring|null
Định danh tệp dùng bởi API liên quan.

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