TokenLab

Tệp và lô

Lấy Nội Dung Tệp

Tải xuống nội dung gốc của một tệp đã tải lên.

GET
/v1/files/{file_id}/content

Tổng Quan

Endpoint này chủ yếu phục vụ việc truy xuất nội dung tệp của Batch API tương thích với OpenAI của TokenLab.

Khi request bật chế độ tương thích Anthropic Files, cùng route này cũng có thể chuyển tiếp nội dung gốc đã lưu của tệp cho workspace đã gắn.

Khi không có header Anthropic, route này tải nội dung file batch hoặc proxy nội dung file ảnh/tham chiếu đã bind nếu provider hỗ trợ đọc nội dung file.

Ghi Chú

  • Các tệp đầu vào batch phải dùng purpose=batch.
  • 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ụ

Yêu cầu

cURL
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123/content" \
  -H "Authorization: Bearer sk-your-api-key" \
  --output batch-output.jsonl

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.

Loại nội dung

Nội dung tệp batch được trả về dưới dạng JSONL hoặc văn bản thuần. Nội dung tham chiếu hình ảnh do TokenLab tạo có thể được proxy dưới dạng nội dung nhị phân khi nhà cung cấp tệp phía sau hỗ trợ truy xuất nội dung.

Ví dụ phản hồi

Phản hồi

200 OK
{"custom_id":"request-1","response":{"status_code":200,"body":{"id":"chatcmpl_abc123"}}}
{"custom_id":"request-2","error":{"code":"invalid_request_error","message":"Invalid model"}}

Trường quan trọng

bodybinary|string
Nội dung tệp. Lưu hoặc phân tích theo Content-Type; phân tích JSONL từng dòng.
custom_idstring
ID dùng để ghép mục đầu vào của lô với kết quả tương ứng.

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

file_id*string

Phản hồi

text/plain

application/json