Görsel Oluştur

Bir prompt verildiğinde bir görsel oluşturur

​

Genel Bakış

Kod üreten ajanlar için önce GET /v1/models?recommended_for=image ile mevcut önerilen görsel shortlist’ini keşfedin, ardından seçilen modeli bu endpoint’e açıkça gönderin.

gpt-image-2, token bazlı ücretlendirilen bir GPT Image modelidir. LemonData; metin girdisi, görsel girdisi, raporlandığında önbellek girdisi ve görsel çıktı token’ları için OpenAI’ın resmi usage dökümünü izler; sabit görüntü başı fiyat olarak faturalandırılmaz.

gpt-image-2 görüntü oluşturma için desteklenen herkese açık parametreler prompt, n, size, quality, response_format, async, background, output_format, output_compression veya compression, moderation, partial_images ve user alanlarıdır. size veya quality gönderilmezse LemonData auto kullanır; özel size değerleri aşağıda belgelenen esnek WIDTHxHEIGHT sözleşmesini izlemelidir.

Uyumluluk notu: Bir gpt-image-2 isteği input_fidelity gönderirse LemonData bunu iletmeden önce kaldırır; çünkü GPT Image 2 görüntü girdilerini zaten otomatik olarak yüksek doğrulukta işler.

​

Model davranışı notları

Google Gemini görsel aileleri aynı selector sözleşmesini paylaşmaz:

• gemini-3-pro-image-preview ve nano-banana-pro, aspect_ratio ile birlikte resolution (1k, 2k, 4k) destekler.
• gemini-2.5-flash-image, gemini-3.1-flash-image-preview, nano-banana ve nano-banana-edit, aspect_ratio destekler fakat public resolution seçimi sunmaz.
• gemini-2.0-flash-preview-image-generation burada yalnızca prompt alan text-to-image olarak belgelenmiştir.

Google görsel aileleri için aspect_ratio kullanmayı tercih edin ve resolution’ı yalnızca model açıkça destekliyorsa gönderin.

xAI Grok Imagine görsel modelleri (grok-imagine-image, grok-imagine-image-quality ve legacy grok-imagine-image-pro) aspect_ratio ile birlikte resolution (1k, 2k) destekler. grok-imagine-image-pro uyumluluk ID’si olarak korunur ve upstream’de grok-imagine-image-quality modeline yönlendirilir.

​

İstek Gövdesi

Senkron istek zaman aşımı: Bazı yönlendirilmiş görsel sağlayıcıları son görseli inline döndürür ve üretimin tamamlanmasını bekler. Yüksek çözünürlüklü veya yüksek kaliteli istekler bir dakikaya yakın ya da daha uzun sürebilir; bu yüzden HTTP istemcisi zaman aşımını en az 120s olarak ayarlayın. Oluşturma yanıtı status: "pending", task_id veya poll_url içeriyorsa, dönen poll_url ile polling yapın.

model · string · varsayılan: "dall-e-3"

Kullanılacak model (ör. gpt-image-2, dall-e-3, flux-pro, midjourney).

prompt · string · gerekli

İstenen görselin metin açıklaması.

n · integer · varsayılan: "1"

Üretilecek görsel sayısı (1-10, modele bağlı).

size · string · varsayılan: "1024x1024"

Görüntü boyutu. OpenAI tarzı görüntü aileleri ve kesin piksel boyutlarını kabul eden diğer modeller için kullanın.

gpt-image-2 için size, auto veya WIDTHxHEIGHT kabul eder. Özel boyutlarda her iki kenar da 16’nın katı olmalı, en uzun kenar en fazla 3840px olmalı, uzun/kısa kenar oranı en fazla 3:1 olmalı ve toplam piksel sayısı 655,360 ile 8,294,400 arasında olmalıdır. aspect_ratio ve resolution, LemonData’nın gpt-image-2 için mevcut genel sözleşmesine dahil değildir.

Google Gemini görüntü ailelerinde size, modelin genel aspect_ratio sözleşmesine ve desteklendiğinde resolution sözleşmesine eşlenen bir uyumluluk alias’ı olarak değerlendirilir. Bu modellerde doğrudan aspect_ratio göndermeyi tercih edin.

aspect_ratio · string

Modele bağlı en-boy oranı seçici.

Google görsel ailelerinde yaygın değerler 1:1, 16:9, 9:16, 3:2 ve 2:3’tür.

resolution · string

Modele bağlı çıktı çözünürlüğü seçici.

gemini-3-pro-image-preview, nano-banana-pro, nano-banana-2 ve benzeri yüksek çözünürlüklü ailelerde desteklenir. Tipik değerler 1k, 2k ve 4k’tür. Model bunu açıkça belgelemiyorsa bu parametreyi Gemini Flash image ailelerine göndermeyin. xAI Grok Imagine görsel modelleri için 1k veya 2k kullanın.

quality · string · varsayılan: "standard"

Görüntü kalitesi. DALL-E modelleri standard veya hd kullanır; gpt-image-2 gibi GPT Image modelleri auto, low, medium veya high kullanır.

response_format · string · varsayılan: "url"

Yanıt formatı: url veya b64_json. Varsayılan url değeridir.

Azure Official veya Azure-compatible gpt-image-2 rotalarında LemonData response_format alanını upstream’e iletmez. Gateway, upstream görüntü verisini her zaman b64_json olarak alır; url isteklerinde her görseli CDN’e yükler ve data[].url döndürür. CDN depolama kullanılamıyorsa veya upload başarısız olursa istek Base64’e düşmek yerine başarısız olur. b64_json için ham Base64 döndürülür.

async · boolean · varsayılan: "false"

gpt-image-2 veya resmi FLUX/BFL görüntü modelleriyle önce bir görev oluşturmak için true yapın. Tamamlanan asenkron görüntü görevleri, istenen response_format ne olursa olsun URL döndürür; b64_json gerekiyorsa senkron istek kullanın.

style · string · varsayılan: "vivid"

DALL-E 3 için stil: vivid veya natural.

user · string

Son kullanıcı için benzersiz bir identifier.

​

Yanıt

​

Senkron Yanıt

created · integer

Oluşturulma zamanının Unix timestamp’i.

data · array

Üretilen görsellerin dizisi.

Her object şunları içerir:

• url (string): Üretilen görselin URL’si
• b64_json (string): Base64 kodlanmış görsel (istenirse)
• revised_prompt (string): Kullanılan prompt (DALL-E 3)

​

Asenkron görev yanıtı

gpt-image-2 veya resmi FLUX/BFL görüntü modelleriyle async: true kullanarak oluşturma isteğinde nihai görüntüyü beklemek yerine bir görev oluşturun. Yanıt status: "pending", task_id ve poll_url içerir. Görev completed veya failed durumuna gelene kadar /v1/tasks/{task_id} adresini sorgulayın.

Asenkron görüntü görevleri yalnızca nihai görüntü URL’lerini döndürür. Ham b64_json görüntü verisi gerekiyorsa senkron istek kullanın.

Görev oluşturulurken tahmini tutar rezerve edilebilir. Tamamlanan görevler gerçek kullanıma göre ücretlendirilir; başarısız olan veya zaman aşımına uğrayan görevlerin rezervi serbest bırakılır veya iade edilir.

created · integer

Oluşturma zamanının Unix zaman damgası.

task_id · string

Sorgulama için benzersiz görev kimliği.

status · string

İlk durum: pending.

poll_url · string

Sonuçları sorgulamak için göreli URL, örneğin /v1/tasks/{id}.

data · array

Görev beklemedeyken boştur. Tamamlanan görsel görevleri, data[].url içinde oluşturulan görsel URL’lerini döndürür.

status: "pending" aldığınızda, sonucu almak için poll_url veya GET /v1/tasks/{task_id} kullanın.

cURL

curl -X POST "https://api.lemondata.cc/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "A cinematic portrait of a white cat sitting on a rainy windowsill",
    "aspect_ratio": "16:9",
    "resolution": "2k",
    "n": 1
  }'

Senkron Yanıt

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "A fluffy white cat with bright eyes sitting peacefully on a wooden windowsill, watching raindrops stream down the glass window..."
    }
  ]
}

​

Kullanılabilir Modeller

Model	Tip	Özellikler
dall-e-3	Genelde inline	En iyi kalite, prompt iyileştirme
dall-e-2	Genelde inline	Daha hızlı, daha uygun maliyetli
flux-pro	Sıklıkla task tabanlı	Fotogerçekçi, yüksek kalite
flux-schnell	Genelde inline	Çok hızlı
midjourney	Sıklıkla task tabanlı	Sanatsal stil
ideogram-v3	Sıklıkla task tabanlı	En iyi metin oluşturma
stable-diffusion-3	Genelde inline	Açık kaynak, özelleştirilebilir

Bir modeli her zaman senkron ya da her zaman asenkron olarak hard-code etmeyin. Create yanıtı status: "pending" döndürürse, poll_url’ı takip edin ve tamamlanana kadar polling yapın.

​

Task Tabanlı Yanıtları İşleme

Görsel modeller için, yanıtın status: "pending" içerip içermediğini her zaman kontrol edin: