Nano Banana 2 API Nasıl Kullanılır

Nano Banana 2 — topluluğun Google’ın Gemini ailesindeki en yeni görüntü üretim modeli için kullandığı kısaltma — hızlı, yüksek sadakatli görüntü üretimi ve düzenleme konusundaki beklentileri hızla yeniden şekillendirdi. 2026 Şubat ayının sonunda piyasaya çıkan bu “Flash Image” varyantı (Gemini 3.1 Flash Image / Nano Banana 2), yüksek aktarım hızında ve düşük gecikmede profesyonel düzeyde çıktı ihtiyacı olan geliştiricileri ve ürün ekiplerini hedefliyor. Bu yazıda en güncel haber ve dokümantasyonu birleştirerek Nano Banana 2’nin ne olduğunu, kıyaslamalardaki performansını, nasıl erişilip çağrılacağını (CometAPI gibi üçüncü taraf geçitler üzerinden dahil) ve üretimde benimseyebileceğiniz pratik istem ile kullanım kalıplarını açıklıyorum.

CometAPI, pek çok modeli (görüntü modelleri dahil) tutarlı uç noktalar altında ortaya koyan tek bir HTTP tarzı arayüz sağlar. Bu, satıcılar arasında geçişi veya birden fazla modelin çıktısını birleştirmeyi kolaylaştırabilir. Nano Banana 2 (Gemini 3.1 Image) CometAPI’de Live durumdadır.

Nano Banana 2 nedir?

Nano Banana 2 (içeride Gemini 3.1 Flash Image ile hizalı), hız, görüntü başına daha düşük maliyet ve yaratıcı/editoryal görüntü görevleri için daha güçlü yönerge takibine öncelik veren, Google’ın odaklı ve yüksek verimli bir görüntü üretim modelidir. Daha yüksek sadakatli “Pro” varyantların yanında konumlanmak üzere tasarlanmıştır: yüksek hacim için Nano Banana 2 ve birinci sınıf, varlık kalitesinde çıktılar için Nano Banana Pro (Gemini 3 Pro Image).

Sunmak üzere tasarlanmıştır:

Hızlı çıkarım (çok düşük gecikmeyi hedefleyerek görüntü üretimi ve düzenlemelerin neredeyse anlık hissettirmesi).
Yüksek görsel kalite; “Pro” ailesine yaklaşırken daha düşük hesaplama/maliyetle.
Daha iyi yönerge takibi (istenen konuların, görüntü içi metnin ve çok karakterli sahnelerin daha doğru işlenmesi).
Geniş çözünürlük ve en-boy oranı desteği, hızlı küçük önizlemelerden nihai varlıklar için yerel 2K/4K hatlarına kadar.

Nano Banana 2’yi özgün Nano Banana / Pro’dan farklı kılan nedir?

Mimari / motor: Gemini’nin Flash çıkarım yığını (Gemini 3.1 Flash Image) üzerine kurulu olduğundan, maksimum kalite ayarlarının bir kısmını dramatik hız ve maliyet kazanımları için değişir.
Kullanım senaryoları: Büyük ölçekli otomasyon (pazarlama varlıkları, küçük resimler, UI’lar), neredeyse gerçek zamanlı düzenleme ve gecikme ile maliyetin önemli olduğu ancak yine de Pro düzeyinde konu sadakati gerektiği iş akışları için idealdir.

Nano Banana 2’nin Karşılaştırma Performansı

Nano Banana 2 API Nasıl Kullanılır

Kategorilerde Tutarlı

Gemini 3.1 Flash Image, Gemini 2.5 Flash’a kıyasla raporlanan her kategoride ölçülebilir iyileşme gösterir.

En büyük kazanımlar

Görsel kalite
Çoklu girdi bileşimsel düzenleme
Genel düzenleme sağlamlığı

Rekabetçi konumlandırma

İç GenAI-Bench genel tercihinde lider.
GPT-Image 1.5’i genel ve görsel metriklerde geride bırakır.
Dar, kademeli iyileştirmeler radikal bir değişimden ziyade mimari rafineleşmeye işaret eder.

Nano Banana 2’ye nasıl erişebilirim?

Nerede mevcut

Nano Banana 2, Google’ın Gemini araçları (Gemini uygulaması), Gemini API’si (Google’ın AI geliştirici dokümanlarında belgelenmiştir) aracılığıyla erişilebilir ve Vertex AI gibi bulut kurumsal ürünlerinde önizleme/kurumsal entegrasyonlar için sunulmaktadır. CometAPI ayrıca entegrasyonu kolaylaştırmak için destek ve sarmalayıcılar duyurmuştur.

Nano Banana 2 API’yi (CometAPI) nasıl kullanırım: seçenekler neler?

CometAPI’nin kılavuzu, Gemini tarzı generateContent yapısını kullanır ve görüntüleri candidates[0].content.parts[].inline_data.data içinde Base64 olarak döndürür. Bu Base64’ü istemci tarafında çözerek bir dosya olarak kaydetmelisiniz. Yalnızca https: //generativelanguage.googleapis.com adresini https://api.cometapi.com ile değiştirmeniz yeterlidir. Dönen görüntü genellikle Base64 ile kodlanmış inline_data olarak sağlanır. İstemci tarafında decode edip dosya olarak kaydetmeniz gerekir. CometAPI indirimler sunar ve Nano Banana 2 API’sini kullanmanıza yardımcı olur.

CometAPI, Gemini modelleri için birleşik bir REST sarmalayıcı ve açık uç noktalar sağlar — tek bir kimlik bilgisi tercih ediyor ve uygulama kodunu değiştirmeden sağlayıcılar arasında geçiş yapmak istiyorsanız idealdir. Nano Banana 2 için CometAPI sayfası, gemini-3.1-flash-image-preview:generateContent uç noktası için doğrudan bir curl örneği içerir. Aşağıda CometAPI dokümanlarına dayanan temizlenmiş bir curl örneği yer alır.

CometAPI üzerinden Nano Banana 2’yi kullanmak için önkoşullar

CometAPI Hesabı ve API Anahtarı: CometAPI üzerinde bir hesap oluşturun ve API erişim anahtarınızı (sk-…) üretin. Bu anahtar, CometAPI uç noktalarına yapılan tüm API isteklerini kimlik doğrulamak için kullanılacaktır.

Programlama Dilleri ve Çalışma Ortamları:

Node.js 18+ (JavaScript/TypeScript için)
Python 3.10+
(Veya HTTP isteği yapabilen herhangi bir dil)

HTTP Araçları veya SDK’lar:

JavaScript için: fetch, axios veya OpenAI uyumlu istemci
Python için: requests, httpx veya OpenAI istemci
Bu araçlar API çağrıları göndermenize ve yanıtları işlemenize yardımcı olur.

İstek desenine hızlı genel bakış

Temel URL: https://api.cometapi.com (CometAPI temeli).
Model adları: gemini-3.1-flash-image-preview (Nano Banana 2 / gemini 3.1 Flash Image) veya kullanılabilirliğe bağlı olarak gemini-2.5-flash-image.
Kimlik doğrulama: Authorization: sk-xxxx başlığı — CometAPI genellikle sk- tarzı anahtar kullanır.
Yanıt: görüntüler, response.candidates[0].content.parts[].inline_data.data altında Base64 olarak döner. Decode edip diske yazın.

Örnek iş akışı (üst düzey)

CometAPI’den bir API anahtarı edinin.
Model tanımlayıcınızı seçin (ör. kullanılabilirliğe bağlı olarak gemini-3.1-flash-image veya benzeri).
İsteminizle modelin üretim uç noktasına bir POST isteği gönderin.
Dönen görüntü verisini uygulamanızda işleyin (base64 çöz, PNG olarak sun, vb.).
Görüntü düzenleme için mevcut görüntü verisini ve düzenleme yönergelerini isteğinizde ekleyin.

Resmi Gemini API’sini kullanma (metin → görüntü)

Aşağıda gemini-3.1-flash-image-preview için Gemini generateContent uç noktasını çağırmayı gösteren kısa bir Node.js örneği yer alır (dokümanlardaki resmi örnekleri yansıtır). YOUR_API_KEY değerini kimlik bilginizle değiştirin ve üretim için hata işlemesini ekleyin.

# Get your CometAPI key from https://api.cometapi.com/console/token
# Export it as: export COMETAPI_KEY="your-key-here"

mkdir -p ./output

curl -s "https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Authorization: $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "A woman leaning on a wooden railing of a traditional Chinese building. She is wearing a blue cheongsam with pink and red floral motifs and a headdress made of colorful flowers, including roses and lilacs. Realistic painting style, focusing on the textural details of the clothing patterns and wooden buildings."
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "9:16"
      }
    }
  }' | python3 -c "
import sys, json, base64
data = json.load(sys.stdin)
parts = data['candidates'][0]['content']['parts']
for part in parts:
    if 'text' in part:
        print(part['text'])
    elif 'inlineData' in part:
        img = base64.b64decode(part['inlineData']['data'])
        with open('./output/gemini-3.1-flash-image-preview.png', 'wb') as f:
            f.write(img)
        print('Image saved to ./output/gemini-3.1-flash-image-preview.png')
"

CometAPI SDK’lar ve OpenAI uyumlu istemci sarmalayıcıları sağlar; böylece bazı ekipler, Base64 kodlu görüntü çıktıları veya yapılandırmanıza bağlı olarak barındırılan URL’ler talep ederek sağlayıcıları minimum kod değişikliğiyle değiştirebilir. Tam payload alanları için her zaman resmi generateContent şemasını kontrol edin.

Görüntü→Görüntü (düzenleme) akışı

Mevcut bir görüntüyü düzenlemek için:

Kaynak görüntünüzü Base64’e dönüştürün (data:image/...;base64, önek olmadan).
inline_data.data içinde bu Base64 dizesini ve düzenleme istemini (“arka planı alacakaranlık gökyüzüne çevir, filigranı kaldır” gibi) içeren bir payload ile POST yapın.
Yanıt, decode edilip kaydedilecek yeni bir Base64 çıktı içerecektir.

curl 
--location 
--request POST 'https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent' \ 
--header 'Authorization: ' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{ "contents": 
[ { "role": "user", "parts": 
[ { "text": "Blend three images to output a high-resolution image" }, { "inline_data": { "mime_type": "image/jpeg", "data": "<your_first_image_base64_data_here>" } }, { "inline_data": { "mime_type": "image/jpeg", "data": "<your_second_image_base64_data_here>" } }, { "inline_data": { "mime_type": "image/jpeg", "data": "<your_third_image_base64_data_here>" } } 
] } 
], "generationConfig": { "responseModalities": [ "TEXT", "IMAGE" 
] } }'

Ayarlanabilecek tipik parametreler

model: gemini-3.1-flash-image-preview (Nano Banana 2) veya gemini-3-pro-image-preview (Pro) seçin.
imageConfig.aspect_ratio ve imageConfig.image_size (512, 1K, 2K, 4K) — maliyet ve gecikmeyi etkiler.
responseModalities: çok modlu akışlar için ["Image"] veya ["Text","Image"].

Nano Banana 2 için istemleri nasıl oluşturmalıyım?

Görüntü modelleri için istem mühendisliği; kompozisyon, stil, kamera/aydınlatma ipuçları ve kısıt ifadelerini harmanlar. Nano Banana 2 yönergeleri güvenilir şekilde takip edecek şekilde ayarlanmıştır; bu nedenle özlülük ile açıklığı dengeleyin.

İstem yapısı (önerilir)

Birincil konu: görüntüde kim/ne var.
Eylem veya durum: konu ne yapıyor.
Ortam ve ruh hali: mekân, aydınlatma, atmosfer.
Teknik direktifler: kamera lensi, en-boy oranı, çözünürlük, kompozisyon.
Stil ve referanslar: sanat tarzı, sanatçı referansları (telif kurallarına dikkat edin), dönem.
Kısıtlar: karakter/nesne sayısı, belirli renklerden kaçın, okunaklı metin ekle.

Örnek istem:

“Güneş ışığı alan bir stüdyoda, cilalı maun bir masanın üzerinde dinlenen, vintage roket şeklinde minik sarı bir muzun fotogerçekçi görüntüsü. 50mm lens, sığ alan derinliği, sıcak altın saat ışığı, yüksek detay, görünür logo yok, 2048×1152.”

Düzenleme istemleri için ipuçları (inpainting / değiştirme)

Maskeyi net biçimde sağlayın ve hangi bölgelerin değişmesi gerektiğini belirtin.
Korunacak alanlar için “koru” ifadeleri kullanın (ör. “konunun yüz özelliklerini koru, yalnızca arka planı değiştir”).
Görüntü içi metin için, metni tam olarak verin ve font/stil belirtin (ör. “okunaklı sans-serif, ortalanmış”). Nano Banana 2 daha iyi metin işleme vurgusu yapar, ancak açıkça belirtmek faydalıdır.

İstem hata ayıklama kontrol listesi

Çıktı hedef dışıysa basitleştirin: önce yaratıcı stil yönergelerini azaltın, sonra detayları yeniden ekleyin.
Metin okunaksızsa: istemde font, boyut ve kontrastı belirtin ve çözünürlüğü artırın.
Kompozisyon yanlışsa: kamera açısı ve lens belirteçlerini kullanın.

Yaygın tuzaklar nelerdir ve nasıl önlenir?

Tuzak: Tek seferlik istemlere aşırı güven

Budama, yerleşim ve çok adımlı düzenlemelerin tek bir istemle halledileceğini beklemekten kaçının. Çalışmayı şu şekilde bölün: temel üretim → düzenleme/değiştirme → son cilalama. Hassasiyet için seed ve maskeler kullanın.

Tuzak: Kaynak doğruluğu ve telif kontrollerini göz ardı etmek

SynthID/C2PA veya diğer kaynak doğrulama yöntemleri olmadan büyük ölçekte yayına geçmeyin. Pek çok işletme, AI kaynaklı içerik için izlenebilirlik gerektirir.

Tuzak: Bütçe sürprizleri

Kullanımı model ve uç nokta düzeyinde izleyin, sağlayıcı veya bir proxy aracılığıyla sert kullanım limitleri belirleyin. Flash katmanları daha ucuzdur ancak yanlışlıkla binlerce 4K görüntü üretirseniz maliyet yine de artabilir.

Nano Banana 2 ile önerilen en iyi uygulamalar?

Görüntü üretimini üretime taşımak; maliyet, gecikme, kalite kontrolü, köken ve güvenlik konularına dikkat gerektirir. Aşağıda saha raporları, Google dokümanları ve topluluk testlerinden damıtılmış pratik en iyi uygulamalar yer alır.

İstem mühendisliği ve deterministik çıktılar

İstemlerinizi şablonlayın: tekrarlanabilir çıktılar (ör. ürün çekimleri) için konu, kamera, aydınlatma, doku, post-prod gibi sabit segmentleri olan yapılandırılmış istemler kullanın. Bu, çağrılar arasında sapmayı azaltır.
Referans görüntüler ve maske talimatlarını düzenlemeler için kullanın; salt metinle karmaşık lokal düzenleme denemektense anlamsal hataları ve artefaktları azaltır.

Maliyet ve performans ayarı

Yüksek hacim için Flash/“Nano Banana 2” modunu seçin: çok sayıda hızlı yineleme ihtiyacınız varsa Flash katmanlı modelleri ve daha küçük boyutları (2K vs 4K) kullanarak maliyet ve gecikmeyi düşürün.
İstekleri mümkünse toplu yapın: bazı sağlayıcılar çoklu istem toplulaştırmaya izin verir — yüksek hacimli hatlarda varlık başına toplam gecikmeyi azaltır. (Sağlayıcı dokümanlarını kontrol edin.)

Güvenlik, köken ve yasal

SynthID ve C2PA meta verilerini oluşturulan varlıklarda etkinleştirin; aşağı akış denetim ve uyumluluğu destekler (özellikle görüntüler reklam/PR’da kullanılıyorsa). Google ve ortaklar, köken mekanizması olarak SynthID’yi vurgular.
Duyarlı içerik için insan müdahalesi: otomatik politika katmanları güçlüdür ancak kusursuz değildir — halka açık kampanyalar veya kamu figürlerini içeren içerik için manuel kontroller kullanın.

Kalite güvencesi

QA kontrollerini otomatikleştirin: beklenmeyen artefaktlar (metin hatalı işleme, düşük yüz sadakati, kazara logo oluşumu) için hızlı bir üretim sonrası sınıflandırıcı çalıştırın. Bir puanlama sistemi tutun ve otomatik kontrol başarısızsa Pro katmanlı render’a emniyetli geri dönüş uygulayın.
İstemleri ve seed değerlerini saklayın: denetlenebilirlik ve yeniden üretilebilirlik için istemi, zaman damgasını, model sürümünü ve kullanılan seed veya deterministik parametreleri kaydedin.

Gecikmeye duyarlı UX

Aşamalı UX: önce düşük çözünürlüklü/hızlı bir taslak döndürün, hazır olduğunda yüksek çözünürlüklü/Pro render ile değiştirin. Bu, uygulamanızı duyarlı tutar (pek çok sağlayıcı “taslak” veya Flash tat sunar).

Son notlar ve sonraki adımlar

Nano Banana 2, görüntü odaklı üretim iş akışlarının ekonomisini değiştirmek için tasarlanmıştır: daha düşük gecikme ve çağrı başına daha düşük maliyet, isteğe bağlı reklam varlığı üretimi, hızlı A/B yaratıcı testleri ve gerçek zamanlı işbirlikçi tasarım araçları gibi kullanım senaryolarını mümkün kılar. Model, Google’ın tüketici ve bulut yüzeylerine zaten entegre edilmiştir; hızla canlıya geçmek isteyen geliştiriciler için CometAPI, Gemini görüntü uç noktalarını ve diğer modelleri destekleyen kullanışlı bir pazar sarmalayıcısı sunar — birden fazla motorla denemek istediğinizde uygulama kodunu değiştirmeden pratik bir hamledir.
Geliştiriciler Nano Banana 2’ye CometAPI üzerinden şimdi erişebilir. Başlamak için, modelin yeteneklerini Playground içinde keşfedin ve ayrıntılı talimatlar için API kılavuzu’na başvurun. Erişmeden önce, CometAPI’ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. CometAPI resmi fiyattan çok daha düşük bir fiyat sunarak entegrasyonunuza yardımcı olur.

Hazır mısınız?→ Bugün Nano Banana 2 için kaydolun !

Daha fazla ipucu, rehber ve AI haberleri için bizi VK, X ve Discord üzerinden takip edin!