Google, metinden görüntü oluşturma, görüntü düzenleme ve gelişmiş kompozisyon kontrolünde üstün başarı gösteren son teknoloji çok modlu bir model olan Nano Banana Pro'yu, yani Gemini 3 Pro Image'ın resmi kod adını yayınladı. Geliştiriciler artık Gemini API aracılığıyla bu güçlü araca programlı olarak erişebiliyorlar. Küçük yapılandırma detayları genellikle entegrasyonunuzun hızla başarılı olup olmayacağını veya başarısız olup olmayacağını belirler.
Bu rehber, Nano Banana Pro API'ye etkili bir şekilde erişmek ve kullanmak için her adımda size yol gösterecektir.
Nano Banana Pro Nedir ve API'si Neden Kullanılmalıdır?
Google DeepMind, Nano Banana Pro'yu Gemini 3 Pro temelinde inşa etti. Önceki modellerin eşleşemediği stüdyo kalitesinde görüntü çıktıları sunar. İlk olarak, metinleri görüntüler içinde olağanüstü bir doğrulukla işler — sahneyle mükemmel uyum sağlayan okunaklı logolar, çok dilli tabelalar veya stilize edilmiş kaligrafi düşünün. Ardından, beş konuya kadar tutarlılığı korurken karıştırma için 14 adede kadar giriş görüntüsünü destekler. Ek olarak, geliştiriciler kamera açılarını, aydınlatmayı, alan derinliğini, renk derecelendirmeyi ve hatta 4K'ya kadar çözünürlüğü kontrol edebilirler.
Ayrıca, bu özelliği etkinleştirdiğinizde model, gerçek zamanlı Google Arama verileriyle üretimleri destekler. Bu, diyagramlar, infografikler veya ürün maketleri için gerçek doğruluğu sağlar. Her çıktı, köken takibi için SynthID filigranı taşır.
Nano Banana Pro'ya standart Gemini API aracılığıyla erişirsiniz, ancak belirli model tanımlayıcısını (gemini-3-pro-image-preview veya kararlı halefi) seçersiniz. Bu yaklaşım, profesyonel düzeyde görüntü yeteneklerinin kilidini açarken kodunuzu diğer Gemini varyantlarıyla uyumlu tutar.
Adım Adım: Gemini API Anahtarınızı Alın
Kimlik bilgilerinizi almak için şu eylemleri izleyin:
Google AI Studio'ya gidin ve Google hesabınızla oturum açın.
Sol kenar çubuğundaki "API anahtarını al" düğmesine tıklayın.
Yeni bir anahtar oluşturun veya mevcut birini kullanın.
Alternatif olarak, Vertex AI'da:
- Vertex AI Studio kontrol panelini açın.
- "Üretken Yapay Zeka" → "Model Bahçesi"ni seçin.
- Nano Banana Pro'yu (Gemini 3 Pro Image olarak listelenir) bulun.
- "API'yi Etkinleştir"e tıklayın ve kimlik bilgileri oluşturun.
Anahtarı ortam değişkenlerinde güvenli bir şekilde saklayın. Kaynak dosyalarında asla sabit kodlamayın.
Google AI Studio'dan Nano Banana Pro API'yi Çağırın (Hızlı Başlangıç)
Hızlı deneyler için genellikle Google AI Studio'da başlarsınız. İlk olarak, ai.studio/banana-pro adresini ziyaret edin. Model açılır listesinden "Nano Banana Pro"yu seçin.
Ardından, anahtarınızla otomatik olarak doldurulan curl örneklerini görmek için "API" sekmesine geçin.
İşte temel bir curl isteği:
curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent \
-H 'Content-Type: application/json' \
-H "x-goog-api-key: YOUR_API_KEY" \
-d '{
"contents": [{
"role": "user",
"parts": [{
"text": "Dünya arka planda yüzen sarı bir muzun 4K fotogerçekçi bir görüntüsünü oluşturun, metin katmanı ekleyin: \"Nano Banana Pro\""
}]
}],
"generationConfig": {
"responseModal": "IMAGE"
}
}'
Bu uç nokta, diğer Gemini modelleriyle aynı kalır — yalnızca model adı değişir.
Nano Banana Pro için Resmi Python SDK'sını Kullanın
Çoğu geliştirici, yeniden denemeleri, akışı ve mime türlerini otomatik olarak işlediği için Python istemci kitaplığını tercih eder. Önce onu yükleyin:
pip install -U google-generativeai
Kütüphaneyi yapılandırın ve bir görüntü oluşturun:
import google.generativeai as genai
genai.configure(api_key="YOUR_API_KEY")
model = genai.GenerativeModel('models/gemini-3-pro-image-preview')
response = model.generate_content(
"Uçan arabaların ve bir reklam panosunda '2042'ye Hoş Geldiniz' yazısının bulunduğu altın saatlerde fütüristik bir şehir manzarası, 4K çözünürlük",
generation_config=genai.types.GenerationConfig(
response_mime_type="image/png"
)
)
response.candidates[0].content.parts[0].inline_data.data # base64 görüntü
Çıktıyı şu şekilde kaydedin:
with open("output.png", "wb") as f:
f.write(response.candidates[0].content.parts[0].inline_data.data)
SDK, düşük seviyeli detayları soyutlar, böylece istem mühendisliğine odaklanırsınız.
Görüntü Düzenleme ve Çoklu Görüntü Girişlerini Yönetme
Nano Banana Pro, düzenleme görevlerinde parlar. Görüntüleri istemin bir parçası olarak yükleyin. Örneğin:
import PIL.Image
img = PIL.Image.open("reference.jpg")
response = model.generate_content(
[img, "Bu fotoğrafı düzenleyin: gündüzü dramatik gün batımına çevirin, bokeh efekti ekleyin, konuyu değiştirmeyin"]
)
Birden çok görüntüyü ve metni sorunsuz bir şekilde birleştirirsiniz. Model, referanslar arasında konu tutarlılığını korur.
Gelişmiş Özellikler: Dayandırma, Güvenlik Ayarları ve Kontroller
Gerçek zamanlı olguları eklemek için Google Arama dayandırmayı etkinleştirin:
"systemInstruction": {
"parts": [{"text": "Gerçek unsurlar için arama dayandırma kullanın"}]
}
Kategorileri engellemek veya izin vermek için güvenlik ayarlarını yapın:
model = genai.GenerativeModel(
'models/gemini-3-pro-image-preview',
safety_settings=[
{"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "BLOCK_NONE"}
]
)
En boy oranını ve kaliteyi belirtin:
generation_config=genai.types.GenerationConfig(
candidate_count=1,
temperature=0.7,
extra_params={
"aspect_ratio": "16:9",
"quality": "highest"
}
)
Apidog ile Nano Banana Pro API Çağrılarını Test Etme ve Hata Ayıklama
Tek seferlik testler için manuel curl komutları işe yarar, ancak Apidog iş akışınızı dönüştürür. Resmi Gemini OpenAPI spesifikasyonunu Apidog'a aktarın, Nano Banana Pro varyantları da dahil olmak üzere tüm uç noktaları otomatik olarak oluşturur.
İşte nasıl fayda sağlayacağınız:
- generateContent istekleri için JSON şemalarını görselleştirin.
- Ortamları (geliştirme/hazırlık/üretim anahtarları) kaydedin.
- İstekleri zincirleyin ve yanıtları doğrulayın.
- Çevrimdışı geliştirmek için API'yi yerel olarak taklit edin.
- 20'den fazla dilde istemci kodunu anında oluşturun.
Örneğin, Apidog'da yeni bir istek oluşturun, Gemini uç noktasını yapıştırın, API anahtarınızı bir başlık olarak ekleyin ve yüklenen görüntülerle karmaşık çok parçalı yükleri saniyeler içinde gönderin. Apidog, "Gönder"e basmadan önce bile gerekli alanları doğrular, yaygın 400 hatalarını önler.
Birçok ekip, Gemini API testleri için Apidog'a geçtikten sonra %50-70 daha hızlı yineleme döngüleri bildirmektedir.
Üretim İçin Vertex AI'da Nano Banana Pro'yu Dağıtın
Kurumsal kullanıcılar Vertex AI ile ölçeklenir. Özel bir uç nokta oluşturun:
- Vertex AI → Model Bahçesi'ne gidin.
- "Gemini 3 Pro Image (Nano Banana Pro)"yu dağıtın.
- Makine türünü ve otomatik ölçeklendirmeyi yapılandırın.
- Tahmin uç noktasını Vertex SDK ile çağırın.
Bu yol, Cloud Operations ile özel uç noktalar, günlük kaydı ve izleme entegrasyonu sağlar.
Fiyatlandırma, Oran Sınırları ve En İyi Uygulamalar
Nano Banana Pro, daha yüksek hesaplama gereksinimleri nedeniyle daha hafif modellere göre daha pahalıdır. Önizleme sırasında ayarlandıkları için en son oranları Gemini API fiyatlandırma sayfasından kontrol edin.
Yeniden denemeler için üstel geri çekilmeyi uygulayın. Mümkün olduğunda yaygın istemleri önbelleğe alın. Ayrıca, ilgili olmayan istekleri yalnızca kullanım durumunuz izin veriyorsa gruplandırın — görüntü oluşturma henüz gerçek gruplamayı desteklemiyor.
Her zaman açık, yapılandırılmış istemler ekleyin. Kaliteyi en üst düzeye çıkarmak için Nano Banana Pro'nun resmi istem rehberine başvurun.
Yaygın Sorun Giderme
Yanlış tanımlayıcıyı kullanırsanız "model bulunamadı" hatalarıyla karşılaşırsınız. Ücretli önizleme aşamasında gemini-3-pro-image-preview'u hedeflediğinizi onaylayın.
Kimlik doğrulama hataları için anahtarınızı yeniden oluşturun ve sondaki boşluk olmadığını doğrulayın. Görüntüler beklenmedik bir şekilde filigranlı görünüyorsa, yalnızca belirli katmanların görünür ışıltıyı kaldırdığını unutmayın.
Çıktılar sansürlenmiş görünüyorsa, güvenlik eşiklerini açıkça ayarlayın.
Sonuç
Artık Nano Banana Pro API'ye etkili bir şekilde erişmek ve entegre etmek için tüm bilgilere sahipsiniz. Anında sonuçlar için Google AI Studio ile başlayın, betik oluşturma için Python SDK'sına geçin ve test ile hata ayıklamayı kolaylaştırmak için Apidog'dan yararlanın.
Nano Banana Pro çatısı altındaki Gemini 3 Pro Image yeteneklerinin birleşimi, otomatik tasarım, kişiselleştirilmiş pazarlama varlıkları ve veri görselleştirme araçları için yeni olanaklar açıyor. Bu adımları uygulayın, cesurca deney yapın ve uygulamalarınızın profesyonel stüdyolarla rekabet edebilecek görseller üretmesini izleyin.
Apidog'u bugün indirin ve Nano Banana Pro geliştirmenizi hızlandırın — ilk oturumunuzdan sonra üretkenlikteki fark belirginleşecektir.