TokenLab
Lấy khóa API
Tài liệuTham chiếu APITích hợp

Tệp và lô

Liệt kê tệp

Liệt kê các tệp batch và tệp tham chiếu hình ảnh đã tải lên.

GET
/v1/files

Liệt kê các tệp batch và tệp tham chiếu hình ảnh. Lọc bằng purpose=batch, purpose=batch_output, purpose=user_data, hoặc purpose=vision.

Với các tiêu đề Anthropic Files, cùng một API này sẽ liệt kê các tệp định dạng Anthropic trong Workspace hiện tại.

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"

Bộ lọc

  • Đối với các tệp batch và tệp tham chiếu hình ảnh, limit nằm trong khoảng 1–10000 (mặc định là 10000), với after dùng để phân trang. Ở chế độ Anthropic Files, limit nằm trong khoảng 1–1000 (mặc định là 20); sử dụng after_id hoặc before_id, không sử 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
}

Các trường quan trọng

objectstring
Luôn là list.
dataarray
Các tệp.
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

Tải tệp lên

Trước

Truy xuất tệp

Tiếp