Tải Lên Tệp

Tổng QuanCopy Anchor Link

Điểm cuối này là một phần của Batch API tương thích với OpenAI của TokenLab. Các công việc theo lô sử dụng các tệp JSONL đã tải lên, chạy không đồng bộ và có thể trả về các tệp đầu ra/lỗi sau.

Chế độ file được hỗ trợCopy Anchor Link

TokenLab xử lý /v1/files theo ba chế độ rõ ràng:

• File batch: dùng purpose=batch cho /v1/batches.
• File ảnh/tham chiếu: dùng purpose=user_data hoặc purpose=vision cho request ảnh dựa trên file.
• Chế độ Anthropic Files API: thêm anthropic-beta: files-api-2025-04-14 để dùng lưu trữ file native của Anthropic.

Ghi ChúCopy Anchor Link

• Các tệp đầu vào theo lô phải sử dụng purpose=batch.
• completion_window hiện tại là 24h.
• Thứ tự đầu ra không được đảm bảo; luôn khớp theo custom_id.
• Streaming không được hỗ trợ bên trong các mục theo lô.

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"

Yêu Cầu / Phản HồiCopy Anchor Link

Sử dụng bảng điều khiển OpenAPI tương tác ở trên để có sơ đồ chính xác.

Mẹo Vận HànhCopy Anchor Link

• Sử dụng custom_id cho việc đối chiếu không thay đổi ở phía hạ nguồn.
• Mong đợi output_file_id và error_file_id chỉ sau khi công nhân hoàn tất lô.

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

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

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

Chế độ Anthropic Files APICopy Anchor Link

Chính route /v1/files này cũng hỗ trợ đường dẫn Anthropic Files API.

• Thêm header anthropic-beta: files-api-2025-04-14 để chuyển sang chế độ Anthropic.
• Ở chế độ Anthropic, hãy tải trực tiếp file gốc lên và không gửi purpose=batch.
• file_id trả về sẽ được gắn với cùng không gian làm việc tương thích Anthropic và nên được tái sử dụng trong các request /v1/messages.
• Nếu bạn định tham chiếu file này trong nội dung message Anthropic, hãy tiếp tục dùng các header Anthropic gốc (x-api-key, anthropic-version và beta header khi cần).

{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

Trường quan trọngCopy Anchor Link