TokenLab

Tệp và lô

Lấy Tệp

Lấy metadata cho một tệp đã tải lên.

GET
/v1/files/{file_id}

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_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" \
  -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_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.

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.

Ví dụ phản hồi

Phản hồi

200 OK
{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

Trường quan trọng

idstring
Định danh tệp dùng bởi API liên quan.
filenamestring
Tên tệp gốc hoặc được tạo.
purposestring
Mục đích tệp được workflow sở hữu sử dụng, chẳng hạn batch, batch_output, user_data hoặc vision.

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

Header

anthropic-beta?string

Bao gồm files-api-2025-04-14 để sử dụng chế độ Anthropic Files API.

Phản hồi

application/json

application/json