Görsel Üretimi

Google’ın Gemini görsel üretim modelleri /v1/images/generations endpoint’i üzerinden text-to-image, image-to-image ve çoklu referans görsel üretimi için çağrılır. Imagen modelleri bu gateway üzerinde text-to-image olarak çalışır. OpenAI gpt-image-2 text-to-image kullanımı için Gateway görsel üretimi sayfasına bakın.

Text-to-image

curl "$LLMTR_BASE_URL/v1/images/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image",
    "prompt": "A minimalist modern workspace with warm light",
    "size": "1K",
    "aspect_ratio": "16:9",
    "n": 1
  }'

Image-to-image (referans görsel)

Önce Files API ile kaynak görseli yükleyin, dönen file_id değerini kullanın. Bu tekil alan geriye uyumluluk için desteklenir:

curl "$LLMTR_BASE_URL/v1/images/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image",
    "prompt": "Bu ürün fotosunu reklam afişine çevir",
    "file_id": "file_xxx",
    "size": "1K",
    "aspect_ratio": "1:1",
    "n": 1
  }'

Çoklu referans görsel

Gemini image modellerinde birden fazla referans görsel göndermek için file_ids kullanın. Toplam referans görsel limiti file_id, file_ids, image_url ve image_urls birlikte sayıldığında 8’dir.

curl "$LLMTR_BASE_URL/v1/images/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image",
    "prompt": "Bu iki ürün fotoğrafını aynı reklam kompozisyonunda birleştir",
    "file_ids": ["file_front", "file_back"],
    "size": "1K",
    "aspect_ratio": "16:9",
    "n": 1
  }'

Uzak veya inline görsel referansları için image_url ve image_urls alanları da desteklenir. Dosya tabanlı kullanım büyük görseller ve tekrar kullanılan referanslar için önerilir.

file_ids vs image_urls — hangisi ne zaman?

Boyut	file_ids (önce /v1/files upload)	image_urls (data URL veya https URL)
HTTP istek sayısı	İki istek (upload + generations)	Tek istek
Büyük görsel (> 1-2 MB)	Önerilir — JSON body limiti sorun olmaz	JSON body büyük; data URL’de base64 ~%33 büyür
Aynı referansı birden çok kez kullanma	Önerilir — bir kez yükle, 7 gün boyunca her istekte aynı file_id’yi yeniden kullan	Her istekte yeniden gönderirsiniz
Tek seferlik, hızlı deneme	Daha yavaş (iki istek)	Önerilir — direkt data URL veya https URL ver
Public bir görsele yönlendirme	İndir + yükle gerekir	Direkt https URL ver
Otomatik temizlik	7 gün sonra otomatik silinir	Storage yok, istek başına geçici

Pratik kural: try-on, image-to-image ve büyük referansları olan tekrarlanan kompozisyonlar için file_ids; tek seferlik hızlı kompozisyonlar veya doğrudan public URL referansları için image_urls kullanın. Bir istekte ikisi birden de kullanılabilir; toplam referans görsel limiti 8’dir.

Try-on: iki görseli birleştirme

Bir kişiyi modele giydirmek, ürünü bir ortama yerleştirmek veya iki görseli bağlamsal olarak birleştirmek için file_ids ile iki ayrı referansı tek isteğe verin. Akış üç adımdır: her görseli /v1/files’a yükleyin, dönen file_id’leri toplayın, /v1/images/generations’a file_ids listesi olarak gönderin.

# 1) Model fotoğrafını yükle, file_id'yi al
curl "$LLMTR_BASE_URL/v1/files" \
  -H "Authorization: Bearer llmtr-your_key" \
  -F "provider=google" \
  -F "purpose=vision_reference" \
  -F "file=@./model.jpg"
# → {"id": "file_model_xxx", ...}

# 2) Giysi fotoğrafını yükle, file_id'yi al
curl "$LLMTR_BASE_URL/v1/files" \
  -H "Authorization: Bearer llmtr-your_key" \
  -F "provider=google" \
  -F "purpose=vision_reference" \
  -F "file=@./giysi.jpg"
# → {"id": "file_giysi_yyy", ...}

# 3) İki referansı tek istekte birleştir
curl "$LLMTR_BASE_URL/v1/images/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image",
    "prompt": "İlk görseldeki kişiye ikinci görseldeki tişörtü doğal biçimde giydir. Aydınlatma ve gölgeleri model fotoğrafıyla tutarlı tut, deseni ve renkleri ürün fotoğrafından koru.",
    "file_ids": ["file_model_xxx", "file_giysi_yyy"],
    "n": 1
  }'

Try-on dahil tüm referans görselli akışlar /v1/images/generations üzerinden çalışır. /v1/images/edits LLMTR’de sadece xAI image modelleri için açıktır; Google modeliyle /v1/images/edits’e istek atarsanız yanıt sizi bu sayfadaki akışa yönlendirir. Imagen modelleri yalnızca text-to-image desteklediği için file_ids ile çağrılamaz.

Parametreler

Alan	Değerler
size	512, 1K, 2K
aspect_ratio	1:1, 3:4, 4:3, 9:16, 16:9
n	1-4
file_id	Opsiyonel tek referans görsel
file_ids	Opsiyonel çoklu referans görsel listesi
image_url	Opsiyonel tek uzak veya inline referans görsel
image_urls	Opsiyonel çoklu uzak veya inline referans görsel listesi

file_id, file_ids, image_url ve image_urls birlikte kullanıldığında tekrar eden değerler tekilleştirilir. Google Imagen modellerinde referans görsel alanları desteklenmez; sadece prompt ile text-to-image istekleri gönderin.

Yanıt

{
  "created": 1739200000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "revised_prompt": "A minimalist modern..."
    }
  ]
}

Fiyatlandırma

Modelin fiyatı image başına native unit üzerinden faturalanır. Dashboard > Modeller üzerinden model kartına bakarak birim fiyatı kontrol edin.