Gambar
Pembuatan gambar
Buat gambar dari prompt dengan Images API OpenAI: Nano Banana, GPT Image, Grok Imagine, dan FLUX 3, masing-masing cukup satu panggilan.
/v1/images/generationsBuat gambar
import osfrom openai import OpenAIclient = OpenAI(base_url="https://api.zurelay.com/v1", api_key=os.environ["ZURELAY_API_KEY"])result = client.images.generate( model="nano-banana-pro", prompt="A red fox curled up asleep in fresh snow at dawn, soft golden light, 85mm photo", size="2K", extra_body={ "aspect_ratio": "3:2" },)print(result.data[0].url){ "created": 1790870400, "data": [ { "url": "https://...signed link, valid for 24 hours..." } ]}Parameter
modelstringwajib- ID model gambar.
promptstringwajib- Gambar yang ingin dibuat, maksimal 32,000 karakter.
ninteger- Jumlah gambar, 1 hingga 4. Semuanya dibuat sekaligus; Anda hanya membayar gambar yang berhasil dikirim.
sizestring- Nano Banana:
1K,2Katau4K(atau ukuran piksel seperti2048x1152, yang dipetakan ke resolusi dan bentuk terdekat); Nano Banana 2 Lite hanya menghasilkan 1K. Grok Imagine:1Katau2K. FLUX 3:1K,2Katau4K. GPT Image: ukuran piksel, seperti1024x1024atau3840x2160. Hilangkan parameter ini untuk memakai nilai default. aspect_ratiostring- Nano Banana:
1:1,2:3,3:2,3:4,4:3,4:5,5:4,9:16,16:9atau21:9. Grok Imagine: sama, tetapi4:5dan5:4. FLUX 3: 15 bentuk, lihat panduan FLUX 3. response_formatstringurl(default): tautan yang berlaku selama 24 jam.b64_json: gambar itu sendiri, dalam format base64.imagesarray- Gambar referensi untuk diedit atau dijadikan acuan. Lihat Pengeditan gambar.
quality, background, output_formatstring- Khusus GPT Image: lihat panduan GPT Image.
modelsarray- Perutean cerdas untuk permintaan ini: alternatif yang dicoba secara berurutan jika model tidak tersedia. Lihat Perutean cerdas.
callback_urlstring- URL https untuk mengirim gambar setelah siap. Dengan ini, permintaan langsung mendapat respons (
202, dengan id) tanpa menunggu. Lihat Callback.
Ukuran
Harga Nano Banana ditentukan berdasarkan resolusi dan selalu menghasilkan ukuran persis sesuai permintaan: jika gambar yang dihasilkan lebih kecil, prosesnya diulang, bukan dikirimkan. Pada 1K:
Grok Imagine menghasilkan sekitar satu megapiksel pada 1K dan empat pada 2K, dengan ukuran yang ditentukannya sendiri (1280 × 720 untuk 16:9 pada 1K); jika rasio aspek atau resolusinya berbeda, prosesnya diulang, bukan dikirimkan. Lihat panduan Grok Imagine Image.
FLUX 3 menghasilkan sekitar satu megapiksel pada 1K, empat pada 2K, dan enam belas pada 4K, dalam 15 rasio aspek dari 21:9 hingga 9:21; jika hasilnya lebih kecil dari permintaan atau rasio aspeknya berbeda, prosesnya diulang, bukan dikirimkan. Lihat panduan FLUX 3.
Harga GPT Image 2 sama untuk semua ukuran: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 3840x2160, 2160x3840. Harga GPT Image 2.5 Flare dan Sunburst ditentukan berdasarkan ukuran: hingga 1024 × 1024 termasuk 1K, hingga 2560 × 1440 termasuk 2K, dan ukuran yang lebih besar termasuk 4K. Jika ukuran tidak ditentukan, atau auto, gambar yang dihasilkan berukuran 1024 × 1024.
Tautan dan riwayat
- Tautan di
urlmemiliki tanda tangan digital dan berlaku selama 24 jam. Unduh gambar yang ingin Anda simpan. - Gambar yang dikembalikan sebagai
urljuga disimpan selama 30 hari di Koleksi pada dasbor Anda, tempat Anda dapat mengunduh, menghapus, atau menggunakannya sebagai gambar referensi. Gambar yang dikembalikan sebagaib64_jsontidak disimpan. - Setiap gambar yang disimpan menyertakan prompt pembuatnya, yang ditampilkan di samping gambar pada dasbor, dan keduanya dihapus setelah 30 hari yang sama.
Waktu proses
Sebagian besar gambar siap dalam 10 hingga 60 detik, lebih lama pada 4K. Jika proses macet, permintaan otomatis dicoba ulang melalui jalur lain, jadi atur batas waktu klien Anda ke 10 menit. Atau tanpa perlu menunggu: tambahkan callback_url dan gambar akan dikirim ke server Anda setelah siap (lihat Callback).
Saat gambar tidak dihasilkan
Jika model menolak prompt (misalnya, karena kebijakan kontennya), Anda menerima 400 image_not_generated beserta alasan dari model, dan Anda tidak dikenai biaya. Jika n lebih dari 1, Anda menerima gambar yang berhasil dibuat dan hanya membayar untuk gambar tersebut.
Ada pertanyaan, atau ada yang kurang? Tanyakan kepada tim dukungan kami dan kami akan menjawab lewat email, biasanya dalam satu menit.