Gemini 3.1 Flash Görsel Önizleme

• Model: gemini-3.1-flash-image-preview (sabit)
• Özellikler: Metinden görsele, görselden görsele (14 referansa kadar), 4K'ya kadar, aşırı en-boy oranları, isteğe bağlı Google arama temellendirmesi

Bu modeli /v1/chat/completions üzerinden çağırmayın — 400 hatası alırsınız ve Images API'sini kullanmanız gerektiğine dair bir ipucu görürsünüz.

Uç Noktalar

Mod	Uç Nokta	Ne zaman kullanılır
Senkron (önerilen)	POST https://apimaster.ai/v1/images/generations	Tek bir HTTP gidiş-dönüşü; platform yukarı akışı sorgular ve { "data": [{ "url" }] } döndürür
Asenkron	POST https://apimaster.ai/v1/images/generations/async → GET https://apimaster.ai/v1/tasks/{task_id}?model=gemini-3.1-flash-image-preview	Uzun işler, özel kuyruklar

Hızlı başlangıç (senkron)

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "Cyberpunk city at night, neon lights",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

Başarılı

{
  "created": 1782633696,
  "data": [{ "url": "https://apimaster.ai/imgs/1782633695067198543.jpg" }]
}

2K/4K için HTTP okuma zaman aşımını ≥ 180s olarak ayarlayın. URL'leri hemen indirin veya yansıtın — süreleri dolar.

Asenkron akış

Gönder

curl -s "https://apimaster.ai/v1/images/generations/async" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "a corgi astronaut on the moon",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Gönderim yanıtı

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" }]
}

Yokla

curl -s "https://apimaster.ai/v1/tasks/TASK_ID?model=gemini-3.1-flash-image-preview" \
  -H "Authorization: Bearer YOUR_API_KEY"

Başarılı olduğunda data.result.images[0].url'yi okuyun. Tipik yoklama durumları: in_progress → succeeded / completed.

İlk yoklamadan önce 10–20s bekleyin, ardından her 3–5s'de bir yoklayın.

Kimlik Doğrulama

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Gövde Parametreleri

Alan	Tür	Zorunlu	Notlar
model	string	evet	gemini-3.1-flash-image-preview
prompt	string	evet	Sahne açıklaması
size	string	hayır	En-boy oranı; aşağıya bakın
resolution	string	hayır	0.5K / 1K / 2K / 4K, varsayılan 1K; büyük-küçük harf duyarsız
n	integer	hayır	Yalnızca 1 desteklenir (sayısal, dize değil)
image_urls	array	hayır	Referans görseller (URL veya data URI)
google_search	boolean	hayır	Google metin arama temellendirmesi
google_image_search	boolean	hayır	google_search: true gerektirir

Çözünürlük ve faturalandırma katmanları

Değer	~piksel	1K tabanına göre fiyat
0.5K	~512	1K ile aynı
1K	~1024	taban
2K	~2048	× 4/3
4K	~4096	× 2

Gerçek ücret = kanal fiyatı × çözünürlük çarpanı × grup oranı. Marketplace veya konsol günlüklerine bakın.

Hatalar

HTTP	Anlamı
400	Kötü parametreler veya yanlış uç nokta (sohbet)
401	Geçersiz API anahtarı
402	Yetersiz bakiye
408	Senkron yoklama zaman aşımı — asenkron ile tekrar deneyin veya çözünürlüğü düşürün
500 / 502	Yukarı akış veya platform hatası

Yalnızca bir kanal yapılandırıldığında geçersiz en-boy oranları 500 olarak görünebilir.

Notlar

• Kullanım günlükleri, görsel önizleme için result_url ve request_data.effective_resolution içerir.
• Fiyatlandırma kanala ve çözünürlüğe göre değişir — marketplace'e bakın.