TokenLab

Tệp và lô

Tải tệp lên

Tải lên tệp batch, tệp tham chiếu hình ảnh hoặc tệp định dạng Anthropic.

POST
/v1/files

Mục đích của tệp

  • Tệp batch: sử dụng purpose=batch cho /v1/batches.
  • Tệp hình ảnh/tham chiếu: sử dụng purpose=user_data hoặc purpose=vision cho các yêu cầu hình ảnh dựa trên tệp.
  • Tệp Anthropic: thêm header anthropic-beta: files-api-2025-04-14.

Giới hạn

Mục đíchKích thước tối đa
batch200 MiB
user_data, vision50 MiB
Tệp Anthropic500 MB

Tệp lớn hơn sẽ trả về lỗi 413 request_too_large. Một purpose khác ngoài batch, user_data, hoặc vision sẽ trả về lỗi 400 unsupported_purpose. Yêu cầu không có file sẽ trả về lỗi 400.

Tệp batch sẽ hết hạn sau 24 giờ kể từ khi tải lên. Để thay đổi điều đó, hãy gửi các trường biểu mẫu expires_after[anchor]=created_at và expires_after[seconds] từ 3600 đến 2592000 (30 ngày). Trường expires_at trong phản hồi sẽ hiển thị thời gian hết hạn.

Ví dụ

Yêu cầu

cURL
curl -X POST "https://api.tokenlab.sh/v1/files" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "purpose=batch" \
  -F "file=@batch-input.jsonl;type=application/jsonl"

Đầu vào tệp hình ảnh

Cùng một route /v1/files này có thể tải lên các tệp tham chiếu hình ảnh cho /v1/images/edits.

  • Sử dụng purpose=user_data hoặc purpose=vision.
  • Tùy chọn bao gồm model để chọn mô hình chỉnh sửa hình ảnh; mặc định là gpt-image-2.
  • file_id được trả về sẽ gắn liền với cấu hình chỉnh sửa hình ảnh đã chọn và có thể được sử dụng lại trong images[].file_id.

Chế độ API tệp Anthropic

  • Thêm anthropic-beta: files-api-2025-04-14 để sử dụng Tệp Anthropic.
  • Ở chế độ Anthropic, hãy tải lên tệp gốc trực tiếp và không gửi purpose=batch.
  • file_id được trả về chỉ khả dụng trong Workspace hiện tại và có thể được sử dụng lại trong các yêu cầu /v1/messages.
  • Nếu bạn dự định tham chiếu tệp đã tải lên từ nội dung tin nhắn Anthropic, hãy tiếp tục sử dụng các header gốc của Anthropic (x-api-key, anthropic-version và header beta khi được yêu cầu).

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"
}

Các trường quan trọng

idstring
ID của tệp.
purposestring
Mục đích được gán cho tệp. Các tệp tải lên chấp nhận batch, user_data, hoặc vision.
bytesinteger
Kích thước tệp tính bằng byte.

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

Header

anthropic-beta?string

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

Nội dung yêu cầu

multipart/form-data

Phản hồi

application/json

application/json

application/json

application/json