TokenLab

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ợ.

GET
/v1/files

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_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?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_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.

Bộ lọc

  • Với tệp lô và tệp tham chiếu ảnh, limit là 1–10000 (mặc định 10000), dùng after để phân trang. Trong chế độ Anthropic Files, giá trị là 1–1000 (mặc định 20); dùng after_id hoặc before_id, không dùng cả hai.
  • purpose có thể là batch, batch_output, user_data hoặc vision.
  • user_data và vision trả về các tệp tham chiếu hình ảnh do TokenLab tạo khi có sẵn.

Ví dụ phản hồi

Phản hồi

200 OK
{
  "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

objectstring
Loại object của phản hồi.
dataarray
Danh sách hoặc payload được trả về trong phản hồi.
has_moreboolean
Có thêm kết quả khi has_more là true.

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ố truy vấn

limit?integer
Phạm vi1 <= value <= 1000
mặc định20
after?string
after_id?string

Con 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.

before_id?string

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.

scope_id?string

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.

purpose?string

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

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