Hình ảnh
Create Image Variation
Tạo một biến thể từ một hình ảnh cho trước
Tổng quan
Endpoint này hỗ trợ các client OpenAI Variations hiện có. Đối với các tính năng image-to-image mới, hãy sử dụng /v1/images/edits hoặc /v1/images/generations với mô hình image-to-image hiện tại. Các yêu cầu sử dụng multipart/form-data.
Phần thân yêu cầu (Request Body)
Endpoint này hoạt động đồng bộ: phản hồi trả về hình ảnh cuối cùng và không bao giờ trả về task. Hãy đặt timeout cho HTTP client của bạn tối thiểu là 120s.
Hình ảnh nguồn dạng multipart. Tệp và toàn bộ request body phải có dung lượng dưới 50 MiB (tải lên lớn hơn sẽ trả về lỗi 413). Định dạng và kích thước được hỗ trợ tùy thuộc vào mô hình đã chọn. Chỉ mô hình có thông tin chi tiết ánh xạ image-to-image tới /v1/images/variations mới được chấp nhận; bất kỳ mô hình nào khác sẽ trả về lỗi 400.
ID của mô hình. Endpoint này không có mô hình mặc định. Các ví dụ sử dụng placeholder your-legacy-variation-model: hãy thay thế bằng mô hình có thông tin chi tiết liệt kê endpoint này.
1Số lượng hình ảnh cần tạo (1-10, tùy thuộc vào mô hình).
Kích thước hình ảnh được tạo. Các giá trị được hỗ trợ tùy thuộc vào mô hình đã chọn.
Định dạng trả về của các hình ảnh được tạo. Phải là url hoặc b64_json.
Mã định danh duy nhất đại diện cho người dùng cuối của bạn nhằm mục đích giám sát lạm dụng.
Phản hồi
Unix timestamp thời điểm hình ảnh được tạo.
Mảng chứa các biến thể hình ảnh được tạo.
Mỗi đối tượng bao gồm:
url(string): URL của hình ảnh biến thể (nếu response_format làurl)b64_json(string): Hình ảnh được mã hóa Base64 (nếu response_format làb64_json)
Yêu cầu
curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
-H "Authorization: Bearer sk-your-api-key" \
-F "model=your-legacy-variation-model" \
-F "image=@cat.png" \
-F "n=2" \
-F "size=1024x1024"Phản hồi
{
"created": 1706000000,
"data": [
{
"url": "https://..."
},
{
"url": "https://..."
}
]
}Lưu ý
Đây là endpoint tương thích kế thừa. Nó không có trong danh mục mô hình hình ảnh được đề xuất hiện tại. Đối với các tích hợp mới, hãy sử dụng /v1/images/edits với gpt-image-2, hoặc /v1/images/generations với operation: "image-to-image" và một mô hình image-to-image hiện tại.
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
Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.
Giá trị hợp lệ
- "auto"
- "verified"
- "official"
Nội dung yêu cầu
multipart/form-data
Phản hồi
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json