Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
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.

​
İ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.
​
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
Unix timestamp of creation.
​
task_id
string
Unique task identifier for polling.
​
status
string
Initial status: pending.
​
poll_url
string
Relative URL to poll for results, for example /v1/tasks/{id}.
​
data
array
Empty while the task is pending. Completed image tasks return generated image URLs in data[].url.
When you receive status: "pending", use poll_url or GET /v1/tasks/{task_id} to retrieve the result. 
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
  }'

{
  "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

ModelTipÖzellikler
dall-e-3Genelde inlineEn iyi kalite, prompt iyileştirme
dall-e-2Genelde inlineDaha hızlı, daha uygun maliyetli
flux-proSıklıkla task tabanlıFotogerçekçi, yüksek kalite
flux-schnellGenelde inlineÇok hızlı
midjourneySıklıkla task tabanlıSanatsal stil
ideogram-v3Sıklıkla task tabanlıEn iyi metin oluşturma
stable-diffusion-3Genelde inlineAçı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: