Tệp và lô
Truy xuất Batch
Truy xuất trạng thái hiện tại, số lượng request và các tệp kết quả cho một batch.
Tổng quan
Trả về trạng thái của batch, số lượng request và ID của các tệp kết quả. ID batch không xác định hoặc batch thuộc về một Workspace khác sẽ trả về 404 batch_not_found.
status là một trong các giá trị validating, queued, in_progress, finalizing, completed, failed, cancelling, cancelled hoặc expired. Các tệp kết quả sẵn sàng khi status là completed; đọc các tệp này bằng Truy xuất nội dung tệp.
Yêu cầu
curl -X GET "https://api.tokenlab.sh/v1/batches/batch_abc123" \
-H "Authorization: Bearer sk-your-api-key"Phản hồi
{
"id": "batch_abc123",
"object": "batch",
"status": "completed",
"input_file_id": "file_abc123",
"output_file_id": "file_out123",
"error_file_id": "file_err123",
"request_counts": { "total": 100, "completed": 98, "failed": 2 }
}Các trường quan trọng
request_countsobject
Số lượng các request tổng cộng, đã hoàn thành, thất bại và đã hủy.
output_file_idstring|null
ID tệp kết quả thành công.
error_file_idstring|null
ID tệp kết quả thất bại.
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
Tham số đường dẫn
batch_id*string
Phản hồi
application/json
application/json
application/json