Tệp và lô
Liệt Kê Tệp
Liệt kê các tệp đã tải lên cho luồng batch và các chế độ tương thích dựa trên tệp được hỗ trợ.
Tổng Quan
Endpoint này chủ yếu phục vụ Batch API tương thích với OpenAI của TokenLab, bao gồm các đầu vào batch đã tải lên và các tệp đầu ra/lỗi được tạo ra.
Khi request bật chế độ tương thích Anthropic Files, cùng route này cũng có thể liệt kê các tệp kiểu Anthropic hiện có trong workspace đã gắn.
Khi không có header Anthropic, danh sách có thể bao gồm cả file batch và file ảnh/tham chiếu TokenLab. Dùng purpose=batch, purpose=batch_output, purpose=user_data hoặc purpose=vision để thu hẹp danh sách.
Ghi Chú
- Các tệp đầu vào batch phải dùng
purpose=batch. - Dùng
purpose=batch_outputđể chỉ tập trung vào các tệp đầu ra được tạo ra. completion_windowhiệ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.
Yêu cầu
curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
-H "Authorization: Bearer sk-your-api-key"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_idcho việc đối soát downstream mang tính idempotent. - Chỉ kỳ vọng
output_file_idvàerror_file_idsau khi worker hoàn tất batch.
Bộ lọc
- Với tệp lô và tệp tham chiếu ảnh,
limitlà 1–10000 (mặc định 10000), dùngafterđể phân trang. Trong chế độ Anthropic Files, giá trị là 1–1000 (mặc định 20); dùngafter_idhoặcbefore_id, không dùng cả hai. purposecó thể làbatch,batch_output,user_datahoặcvision.user_datavàvisiontrả về các tệp tham chiếu hình ảnh do TokenLab tạo khi có sẵn.
Phản hồi
{
"object": "list",
"data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
"first_id": "file_abc123",
"last_id": "file_abc123",
"has_more": false
}Trường quan trọng
has_more là true.Xác thực
BearerAuth 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ố truy vấn
1 <= value <= 100020Con trỏ Anthropic Files. Trả về các tệp sau ID tệp công khai này. Yêu cầu header Anthropic Files beta và không thể kết hợp với before_id.
Con trỏ Anthropic Files. Trả về các tệp trước ID tệp công khai này. Yêu cầu header Anthropic Files beta và không thể kết hợp với after_id.
Con trỏ phạm vi Anthropic Files dành riêng. TokenLab hiện trả về lỗi không hỗ trợ thay vì bỏ qua giá trị này một cách âm thầm.
Bộ lọc mục đích tệp tùy chọn. batch và batch_output bao gồm các tệp Batch API; user_data và vision bao gồm các liên kết tệp ảnh/tham chiếu TokenLab. Chế độ Anthropic Files API được chọn bởi các header Anthropic thay vì tham số truy vấn này.
Giá trị hợp lệ
- "batch"
- "batch_output"
- "user_data"
- "vision"
Header
Bao gồm files-api-2025-04-14 để sử dụng chế độ Anthropic Files API.
Phản hồi
application/json
application/json