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.

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ể được sử dụng để 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 tái sử dụng trong images[].file_id.

Chế độ API tệp Anthropic

  • Thêm anthropic-beta: files-api-2025-04-14 để sử dụng Anthropic Files.
  • Ở chế độ Anthropic, hãy tải trực tiếp tệp gốc lên 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 tái sử dụng 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