Nano Banana 2 (Preview) API
Nano Banana 2 (Preview), Google'ın Gemini 3.1 Flash görsel rotasının önizleme sürümüdür ve aynı üretim ile düzenleme işlemlerini önizleme model kimliğiyle sunar.
- Model kimliği
- gemini-3.1-flash-image-preview
- Sağlayıcı
- Tür
- AI Görsel
- Başarılı çağrı başına
- $0,05
- Son doğrulama
- 2026-09-11
01
Nerede işe yarar
Önizleme kimliğini yalnızca yeni sürümü bilinçli olarak değerlendirmek için kullanın; üretimde çalıştıracağınız her şey için kararlı Nano Banana 2 model kimliğini seçin.
02
Neler yapar
Metinden görsele
Metin istemini yeni bir görsele dönüştürür.
Görsel düzenleme
Mevcut bir görseli istem ve referans girdisiyle değiştirir.
03
Nasıl çağrılır
Medya modelleri eşzamansız çalışır: görevi oluşturun, tamamlanana kadar sorgulayın, ardından imzalı varlık URL'sini indirin.
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: gemini-3.1-flash-image-preview-001" \
-d '{
"model": "gemini-3.1-flash-image-preview",
"type": "image",
"operation": "generate",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"size": "1024x1024", "quality": "medium"}
}'
# 2. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 3. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"04
Fiyatlandırma
Görsel işleri token başına değil, başarılı çağrı başına faturalandırılır. Başarısız veya iptal edilen işler otomatik iade edilir.
$0,05çağrı başına
Diğer Google görsel modelleri
Sık sorulan sorular
Nano Banana 2 (Preview) modelini OmniaKey üzerinde nasıl çağırırım?
Model kimliği, type "image" ve operation "generate" veya "edit" ile /v1/media/tasks adresine POST gönderin. Yeniden denemelerde aynı Idempotency-Key değerini kullanın; böylece bir zaman aşımı ikinci bir ücretli iş başlatmaz.
Nano Banana 2 (Preview) ne kadar?
Nano Banana 2 (Preview) $0,05 çağrı başına olarak faturalandırılır. Oluşturma sırasında bu tutar ön ödemeli bakiyenizden ön tahsil edilir; başarısız veya iptal edilen işler otomatik iade edilir.
API neden görsel yerine bir görev kimliği döndürüyor?
Sağlayıcı gecikmesi saniyeler ile yaklaşık bir dakika arasında değişir; bu yüzden OmniaKey her görsel rotasını tek bir eşzamansız akışta birleştirir. Durum succeeded olana kadar GET /v1/media/tasks/{id} adresini sorgulayın, sonra imzalı varlık URL'sini okuyun.
