Hình ảnh
Tạo biến thể hình ảnh
Tạo biến thể của một hình ảnh cho trước
Tổng quan
Endpoint này được giữ lại cho client tạo biến thể legacy tương thích OpenAI. Đây không phải đường dẫn được khuyến nghị cho workflow image-to-image hiện tại; hãy dùng /v1/images/edits với gpt-image-2 hoặc /v1/images/generations với model image-to-image như nano-banana-pro khi có thể. Yêu cầu multipart/form-data.
Nội dung yêu cầu
Timeout cho yêu cầu đồng bộ: một số nhà cung cấp hình ảnh được định tuyến sẽ trả ảnh cuối cùng inline và chờ quá trình tạo hoàn tất. Yêu cầu độ phân giải cao hoặc chất lượng cao có thể mất gần một phút hoặc lâu hơn, vì vậy hãy đặt timeout của HTTP client ít nhất là 120s. Nếu phản hồi tạo có status: "pending", task_id, hoặc poll_url, hãy theo poll_url được trả về để polling.
Ảnh nguồn multipart. File và toàn bộ nội dung yêu cầu đều không được vượt quá 50 MiB. Định dạng và kích thước phụ thuộc vào model; chi tiết model hiện tại phải liệt kê rõ /v1/images/variations.
ID model bắt buộc cho các route legacy tương thích biến thể. Không có default ngầm định; với workflow image-to-image hiện tại, ưu tiên /v1/images/edits hoặc /v1/images/generations với model hiện tại.
1Số lượng hình ảnh cần tạo (1-10, tùy theo model).
Kích thước ảnh được tạo cho các route legacy tương thích biến thể. Giá trị hỗ trợ phụ thuộc vào model đã chọn.
Định dạng trả về của 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 để giám sát lạm dụng.
Phản hồi
Dấu thời gian Unix khi hình ảnh được tạo.
Mảng các biến thể hình ảnh đã tạo.
Mỗi đối tượng chứa:
url(string): URL của hình ảnh biến thể (nếu response_format làurl)b64_json(string): Hình ảnh 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://..."
}
]
}Ghi chú
Đây là endpoint tương thích legacy. Endpoint này không nằm trong catalog model ảnh được khuyến nghị hiện tại. Với tích hợp mới, dùng /v1/images/edits với gpt-image-2, hoặc /v1/images/generations với operation: "image-to-image" và một model 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