> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

## 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 mục lô hiện được hỗ trợ là `/v1/chat/completions` và `/v1/embeddings`; công việc lô `/v1/responses` bị từ chối cho đến khi executor lô Responses native sẵn sàng.

## Ví Dụ

<RequestExample>
  ```bash cURL theme={null}
  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"
    }'
  ```
</RequestExample>

## 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ô.
* Giá lô có thể khác với giá đồng bộ vì các quy tắc giảm giá `isBatchRequest=true` áp dụng.

## Ví dụ phản hồi

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "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
  }
  ```
</ResponseExample>

## Trường quan trọng

<ResponseField name="id" type="string">Định danh dùng cho lần gọi tiếp theo và hỗ trợ.</ResponseField>
<ResponseField name="status" type="string">Trạng thái vòng đời hiện tại của tài nguyên.</ResponseField>
<ResponseField name="output_file_id" type="string|null">Định danh tệp dùng bởi API liên quan.</ResponseField>