Görsel üretimi

OpenAI’ın Images API’siyle bir istemden görseller üretin: Nano Banana, GPT Image, Grok Imagine ve FLUX 3 için tek bir çağrı yeterli.

Görsel üretin

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)

{
  "created": 1790870400,
  "data": [
    { "url": "https://...signed link, valid for 24 hours..." }
  ]
}

Parametreler

Boyutlar

Nano Banana çözünürlüğe göre fiyatlandırılır ve tam olarak istenen boyutta üretir: daha küçük dönen bir görsel teslim edilmez, yeniden denenir. 1K için:

Grok Imagine, kendi belirlediği boyutlarda (1K çözünürlükte 16:9 için 1280 × 720) 1K’da yaklaşık bir, 2K’da dört megapiksel üretir; farklı en boy oranı veya çözünürlükteki görseller teslim edilmez, yeniden denenir. Grok Imagine Image rehberine bakın.

FLUX 3, 21:9 ile 9:21 arasında 15 en boy oranında, 1K’da yaklaşık bir, 2K’da dört ve 4K’da on altı megapiksel üretir; istenenden küçük veya farklı en boy oranındaki görseller teslim edilmez, yeniden denenir. FLUX 3 rehberine bakın.

GPT Image 2 her boyutta aynı fiyattadır: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 3840x2160, 2160x3840. GPT Image 2.5 Flare ve Sunburst boyuta göre fiyatlandırılır: 1024 × 1024’e kadar 1K, 2560 × 1440’a kadar 2K, daha büyük boyutlar ise 4K sayılır. Boyut belirtilmezse veya auto seçilirse 1024 × 1024 üretirler.

Bağlantılar ve geçmiş

• url içindeki bağlantılar imzalıdır ve 24 saat geçerlidir. Saklamak istediklerinizi indirin.
• url olarak döndürülen görseller, panelinizdeki Kütüphane bölümünde de 30 gün saklanır. Buradan görselleri indirebilir, silebilir veya referans olarak kullanabilirsiniz. b64_json olarak döndürülen görseller saklanmaz.
• Saklanan her görselle birlikte, onu üreten istem de tutulur ve panelde yanında gösterilir. İkisi de aynı 30 günlük sürenin sonunda silinir.

Süre

Çoğu görsel 10 ile 60 saniye içinde gelir; 4K’da bu süre uzar. Bir deneme takılırsa istek otomatik olarak başka bir yol üzerinden yeniden denenir. Bu nedenle istemcinizin zaman aşımını 10 dakika olarak ayarlayın. Ya da hiç beklemeyin: bir callback_url ekleyin, görseller hazır olduğunda sunucunuza gelsin (Geri çağrılar bölümüne bakın).

Görsel üretilemediğinde

Model bir istemi reddederse (örneğin içerik politikası nedeniyle), modelin gerekçesiyle birlikte 400 image_not_generated alırsınız ve ücret alınmaz. n değeri 1’den büyükse üretilen görselleri alır, yalnızca onlar için ödeme yaparsınız.