Tệp và lô
Lấy Tệp
Lấy metadata cho một tệp đã tải lên.
Tổng Quan
Endpoint này chủ yếu phục vụ các đối tượng 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ể trả về metadata tệp kiểu Anthropic cho workspace đã gắn.
Khi không có header Anthropic, route này có thể trả về object file batch hoặc object file ảnh/tham chiếu TokenLab.
Ghi Chú
- Các tệp đầu vào batch phải dùng
purpose=batch. 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/file_abc123" \
-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.
Tệp tham chiếu hình ảnh
Endpoint này cũng có thể trả về siêu dữ liệu cho các tệp tham chiếu hình ảnh do TokenLab tạo. Trường status là tùy chọn và có thể không có đối với các họ tệp không cung cấp trường này.
Phản hồi
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Trường quan trọng
batch, batch_output, user_data hoặc vision.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ố đường dẫn
Header
Bao gồm files-api-2025-04-14 để sử dụng chế độ Anthropic Files API.
Phản hồi
application/json
application/json