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.
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ể đượ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_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 tái sử dụng trongimages[].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-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