Ikhtisar
Endpoint ini dipertahankan untuk client variasi legacy yang kompatibel dengan OpenAI. Ini bukan jalur yang direkomendasikan untuk workflow image-to-image saat ini; gunakan/v1/images/edits dengan gpt-image-2 atau /v1/images/generations dengan model image-to-image seperti nano-banana-pro jika memungkinkan. Memerlukan multipart/form-data.
Isi Permintaan
Timeout permintaan sinkron: beberapa penyedia gambar yang dirutekan mengembalikan gambar final secara inline dan menunggu proses generasi selesai. Permintaan resolusi tinggi atau kualitas tinggi dapat memakan waktu hampir satu menit atau lebih, jadi atur timeout HTTP client Anda minimal120s. Jika respons pembuatan berisi status: "pending", task_id, atau poll_url, ikuti poll_url yang dikembalikan.
Gambar yang digunakan sebagai dasar untuk variasi. Harus berupa file PNG yang valid, kurang dari 50MB, dan berbentuk persegi.
ID model wajib untuk rute legacy yang kompatibel dengan variasi. Tidak ada default implisit; untuk workflow image-to-image saat ini, pilih
/v1/images/edits atau /v1/images/generations dengan model saat ini.Jumlah gambar yang akan dihasilkan. Harus antara 1 dan 10.
Ukuran gambar yang dihasilkan untuk rute legacy yang kompatibel dengan variasi. Nilai yang didukung bergantung pada model yang dipilih.
Format pengembalian gambar yang dihasilkan. Harus
url atau b64_json.Pengidentifikasi unik yang mewakili pengguna akhir Anda untuk pemantauan penyalahgunaan.
Respons
Timestamp Unix saat gambar dibuat.
Array variasi gambar yang dihasilkan.Setiap objek berisi:
url(string): URL gambar variasi (jika response_format adalahurl)b64_json(string): Gambar yang dikodekan Base64 (jika response_format adalahb64_json)
Catatan
Ini adalah endpoint kompatibilitas legacy. Endpoint ini tidak termasuk dalam katalog model gambar rekomendasi saat ini. Untuk integrasi baru, gunakan
/v1/images/edits dengan gpt-image-2, atau /v1/images/generations dengan operation: "image-to-image" dan model image-to-image saat ini.