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.
Mục đích của tệp
- Tệp batch: sử dụng
purpose=batchcho/v1/batches. - Tệp hình ảnh/tham chiếu: sử dụng
purpose=user_datahoặcpurpose=visioncho 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 đích | Kích thước tối đa |
|---|---|
batch | 200 MiB |
user_data, vision | 50 MiB |
| Tệp Anthropic | 500 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.
Yêu cầu
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_datahoặcpurpose=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 trongimages[].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-versionvà header beta khi được yêu cầu).
Phản hồi
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Các trường quan trọng
batch, user_data, hoặc vision.Xác thực
BearerAuth 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
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