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.
Hình ảnh dùng làm cơ sở cho biến thể. Phải là file PNG hợp lệ, nhỏ hơn 50MB và có tỷ lệ vuông.
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.Số lượng hình ảnh cần tạo. Phải từ 1 đến 10.
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)
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.