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.

POST/v1/images/generations
ModelIDUkuran dan hargaGambar referensi
Nano Banana 2.1nano-banana-2.11K $0.03 · 2K $0.04 · 4K $0.06hingga 14
Nano Banana Pronano-banana-pro1K dan 2K $0.035 · 4K $0.065hingga 14
Nano Banana 2nano-banana-21K $0.025 · 2K $0.034 · 4K $0.058hingga 14
Nano Banana 2 Litenano-banana-2-lite1K $0.016hingga 14
GPT Image 2.5 Flaregpt-image-2.5-flare1K $0.028 · 2K $0.034 · 4K $0.045hingga 16
GPT Image 2.5 Sunburstgpt-image-2.5-sunburst1K $0.026 · 2K $0.034 · 4K $0.045hingga 16
GPT Image 2gpt-image-2$0.02 per gambarhingga 16
Grok Imagine Image 2.0grok-imagine-image-2.01K $0.045 · 2K $0.06hingga 3
FLUX 3 Imageflux-3-image1K $0.04 · 2K $0.05 · 4K $0.09hingga 1

Buat gambar

import os
from openai import OpenAI
client = 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)
Respons
{
"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, 2K atau 4K (atau ukuran piksel seperti 2048x1152, yang dipetakan ke resolusi dan bentuk terdekat); Nano Banana 2 Lite hanya menghasilkan 1K. Grok Imagine: 1K atau 2K. FLUX 3: 1K, 2K atau 4K. GPT Image: ukuran piksel, seperti 1024x1024 atau 3840x2160. 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:9 atau 21:9. Grok Imagine: sama, tetapi 4:5 dan 5:4. FLUX 3: 15 bentuk, lihat panduan FLUX 3.
response_formatstring
url (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:

Rasio aspek1K2K4K
1:11024 × 10242048 × 20484096 × 4096
2:3848 × 12641696 × 25283392 × 5056
3:21264 × 8482528 × 16965056 × 3392
3:4896 × 12001792 × 24003584 × 4800
4:31200 × 8962400 × 17924800 × 3584
4:5928 × 11521856 × 23043712 × 4608
5:41152 × 9282304 × 18564608 × 3712
9:16768 × 13761536 × 27523072 × 5504
16:91376 × 7682752 × 15365504 × 3072
21:91584 × 6723168 × 13446336 × 2688

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 di url memiliki tanda tangan digital dan berlaku selama 24 jam. Unduh gambar yang ingin Anda simpan.
  • Gambar yang dikembalikan sebagai url juga disimpan selama 30 hari di Koleksi pada dasbor Anda, tempat Anda dapat mengunduh, menghapus, atau menggunakannya sebagai gambar referensi. Gambar yang dikembalikan sebagai b64_json tidak 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.