Nano Banana ile nasıl geliştirme yapılır: Kapsamlı Geliştirici Eğitimi

İşte İngilizce'den Türkçe'ye (Türkçe) yapılmış çeviri:

Kaynak: @patloeber : Google kısa süre önce Gemini 2.5 Flash Image'i yayınladı. Nano Banana kod adıyla da bilinen bu güçlü yeni model, görüntü oluşturma ve düzenleme için son teknoloji yetenekler sunarak çok çeşitli yeni uygulamaların önünü açıyor.

Bu rehber, geliştiricilerin Gemini 2.5 Flash Image (namıdiğer Nano Banana) uygulamalarına Gemini Developer API aracılığıyla entegre etmeleri için kapsamlı bir yol haritası sunuyor.

Bu rehber şu konuları kapsayacak:

1. Nano Banana'yı AI Studio'da Kullanma
2. Proje Kurulumu
3. Görsel Oluşturma
4. Görsel Düzenleme
5. Fotoğraf Onarımı
6. Birden Fazla Girdi Görseli
7. Konuşma Tarzında Görsel Düzenleme
8. En İyi Uygulamalar ve Etkili Promptlama
9. Topluluk Örnekleri ve İlham
10. Kaynaklar

Bu eğitimde neler yapacağınıza dair bir örnek:

1prompt = "1932'den kalma bu görseli onar ve renklendir"
2
3response = client.models.generate_content(
4    model="gemini-2.5-flash-image-preview",
5    contents=[prompt, image],
6)

Hadi başlayalım!

1. Nano Banana'yı Google AI Studio'da Kullanma

Son kullanıcılar Nano Banana'ya Gemini uygulaması üzerinden erişebilirken, geliştiricilerin prototip oluşturma ve prompt test etme için en iyi ortamı Google AI Studio'dur. AI Studio, herhangi bir kod yazmadan önce mevcut tüm AI modellerini deneyebileceğiniz bir oyun alanıdır ve aynı zamanda Gemini API ile uygulama geliştirmek için giriş noktasıdır.

Nano Banana'yı AI Studio içinde ücretsiz olarak kullanabilirsiniz. Başlamak için aistudio.google.com adresine gidin, Google hesabınızla oturum açın ve model seçiciden Nano Banana'yı seçin.

Doğrudan erişim için, modelle yeni bir oturum başlatmak üzere şu bağlantıyı kullanın: ai.studio/banana

İpucu

: Nano Banana web uygulamalarını doğrudan AI Studio'da

ai.studio/apps adresinden vibe kodlayabilir veya

mevcut uygulamalardan birini inceleyip remiksleyebilirsiniz.

2. Proje Kurulumu

Bu rehberi takip etmek için aşağıdakilere ihtiyacınız olacak:

• Google AI Studio'dan bir API anahtarı.
• Projeniz için faturalandırmanın ayarlanmış olması.
• Python veya JavaScript/TypeScript için Google Gen AI SDK'sı.

Adım A: API Anahtarı Oluşturun

Şu adımları izleyin:

• Google AI Studio'da sol navigasyon panelinde API anahtarı al'a tıklayın.
• Bir sonraki sayfada API anahtarı oluştur'a tıklayın.
• Mevcut bir Google Cloud projesini seçin veya yeni bir tane oluşturun. Bu proje, API kullanımı için faturalandırmayı yönetmek amacıyla kullanılır.

İşlem tamamlandığında API anahtarınız görüntülenecektir. Kopyalayın ve güvenli bir şekilde saklayın.

Adım B: Faturalandırmayı Etkinleştirin

AI Studio'da prototip oluşturma ücretsiz olsa da, modeli API aracılığıyla kullanmak ücretli bir hizmettir. Google Cloud projenizde faturalandırmayı etkinleştirmelisiniz.

API anahtarı yönetim ekranında, projenizin yanındaki Faturalandırmayı ayarla'ya tıklayın ve ekrandaki talimatları izleyin.

Nano Banana'nın maliyeti nedir?

Nano Banana ile görsel oluşturma maliyeti görsel başına $0.039'dur *. 1$'a yaklaşık 25 görsel oluşturabilirsiniz.

* Resmi fiyatlandırma, giriş token'ları için $0.30/1M token ve çıkış token'ları için $30/1M token şeklindedir. Standart bir 1024x1024 piksel çıkış görseli 1290 token tüketir, bu da görsel başına $0.039'a denk gelir. Detaylar için

Gemini 2.5 Flash Image fiyatlandırma tablosuna bakın.

Adım C: SDK'yı Kurun

Tercih ettiğiniz dil için SDK'yı seçin.

1pip install -U google-genai
2# Görsel işleme için Pillow kütüphanesini kurun
3pip install Pillow

1npm install @google/genai

Aşağıdaki örneklerde gösterim amacıyla Python SDK'sı kullanılmıştır. JavaScript'te Nano Banana kullanmak için eşdeğer kod parçacıkları bu

GitHub Gist 'te sağlanmıştır.

3. Metinden Görsel Oluşturma

Açıklayıcı bir metin promptu kullanarak Nano Banana ile bir veya daha fazla görsel oluşturun. Tüm API istekleri için şu model ID'sini kullanın: gemini-2.5-flash-image-preview

1from google import genai
2from PIL import Image
3from io import BytesIO
4
5# İstemciyi API anahtarınızla yapılandırın
6client = genai.Client(api_key="API_ANAHTARINIZ")
7
8prompt = """Bir kanepede oturan yeşil gözlü
9turuncu bir kedinin fotogerçekçi bir görselini oluştur."""
10
11# Görsel içerik oluşturmak için API'yi çağırın
12response = client.models.generate_content(
13    model="gemini-2.5-flash-image-preview",
14    contents=prompt,
15)
16
17# Yanıt hem metin hem de görsel verileri içerebilir.
18# Görseli bulup kaydetmek için parçalar arasında döngü yapın.
19for part in response.candidates[0].content.parts:
20    if part.text is not None:
21        print(part.text)
22    elif part.inline_data is not None:
23        image = Image.open(BytesIO(part.inline_data.data))
24        image.save("kedi.png")

Çıktı

Model çok modlu olduğundan, yanıt iç içe geçmiş metin ve görsel verileri (inline_data) içerebilen bir parça listesi olarak yapılandırılmıştır. Yukarıdaki kod, oluşturulan görseli çıkarmak ve kaydetmek için bu parçalar arasında döngü yapar.

4. Metin ve Görsel Girdileriyle Görsel Düzenleme

Mevcut bir görseli bir metin promptuyla birlikte sağlayarak düzenlemeler yapın. Model, girdi görselindeki karakter ve içerik tutarlılığını korumada başarılıdır.

1from google import genai
2from PIL import Image
3from io import BytesIO
4
5client = genai.Client(api_key="API_ANAHTARINIZ")
6
7prompt = """Kedi görselini kullanarak, bir New York City mahallesinde
8bir kaldırımda yürüyen bir kedinin, arka planda geçen yayaların
9bulanık bacakları ve sarı taksilerle birlikte fotogerçekçi,
10sokak seviyesinde bir görünümünü oluştur."""
11
12image = Image.open("kedi.png")
13
14# Metin promptunu ve görseli 'contents' listesinde birlikte iletin
15response = client.models.generate_content(
16    model="gemini-2.5-flash-image-preview",
17    contents=[prompt, image],
18)
19
20for part in response.candidates[0].content.parts:
21    if part.text is not None:
22        print(part.text)
23    elif part.inline_data is not None:
24        image = Image.open(BytesIO(part.inline_data.data))
25        image.save("kedi2.png")

Girdi ve Çıktı

5. Nano Banana ile Fotoğraf Onarımı

Modelin güçlü uygulamalarından biri de fotoğraf onarımıdır. Basit bir promptla, eski fotoğrafları etkileyici sonuçlarla onarabilir ve renklendirebilir.

1from google import genai
2from PIL import Image
3from io import BytesIO
4
5client = genai.Client(api_key="API_ANAHTARINIZ")
6
7prompt = "1932'den kalma bu görseli onar ve renklendir"
8
9image = Image.open("oglen.jpg")  # "Bir Gökdelende Öğle Yemeği, 1932"
10
11response = client.models.generate_content(
12    model="gemini-2.5-flash-image-preview",
13    contents=[prompt, image],
14)
15
16for part in response.candidates[0].content.parts:
17    if part.text is not None:
18        print(part.text)
19    elif part.inline_data is not None:
20        image = Image.open(BytesIO(part.inline_data.data))
21        image.save("oglen-onarildi.png")

Orijinal ve Çıktı

6. Birden Fazla Girdi Görseliyle Çalışma

Daha karmaşık düzenleme görevleri için girdi olarak birden fazla görsel sağlayabilirsiniz.

1from google import genai
2from PIL import Image
3from io import BytesIO
4
5client = genai.Client(api_key="API_ANAHTARINIZ")
6
7prompt = "Kızın bu tişörtü giymesini sağla. Arka planı değiştirme."
8
9image1 = Image.open("kiz.png")
10image2 = Image.open("tisort.png")
11
12response = client.models.generate_content(
13    model="gemini-2.5-flash-image-preview",
14    contents=[prompt, image1, image2],
15)
16
17for part in response.candidates[0].content.parts:
18    if part.text is not None:
19        print(part.text)
20    elif part.inline_data is not None:
21        image = Image.open(BytesIO(part.inline_data.data))
22        image.save("kiz-tisortlu.png")

Girdiler 1 ve 2 ile Çıktı

7. Konuşma Tarzında Görsel Düzenleme

Tekrarlayan iyileştirmeler için, birden fazla istek arasında bağlamı korumak amacıyla bir sohbet oturumu kullanabilirsiniz. Bu sayede görselleri konuşma tarzında düzenleyebilirsiniz.

1from google import genai
2from PIL import Image
3from io import BytesIO
4
5client = genai.Client(api_key="API_ANAHTARINIZ")
6
7# Bir sohbet oluşturun
8chat = client.chats.create(
9    model="gemini-2.5-flash-image-preview"
10)
11
12# İlk görsel düzenlemesini yapın
13response1 = chat.send_message(
14    [
15        "Kediyi bir bengal kedisiyle değiştir, diğer her şeyi aynı bırak",
16        Image.open("kedi.png"),
17    ]
18)
19# görseli göster/kaydet...
20
21# Sohbete devam edin ve düzenleyin
22response2 = chat.send_message("Kedi komik bir parti şapkası takmalı")
23# görseli göster/kaydet...

Girdi ile Çıktılar 1 ve 2

İpucu

: Birçok konuşma düzenlemesinden sonra görsel özelliklerinde bozulma veya "kayma" fark ederseniz, yüksek kaliteyi korumak için en son görselle ve daha ayrıntılı, derlenmiş bir promptla yeni bir oturum başlatmanız en iyisidir.

8. Nano Banana için En İyi Uygulamalar ve Promptlama İpuçları

Nano Banana ile en iyi sonuçları elde etmek için şu promptlama yönergelerini izleyin:

• Aşırı Spesifik Olun: Konular, renkler, aydınlatma ve kompozisyon hakkında ne kadar çok detay verirseniz, çıktı üzerinde o kadar fazla kontrole sahip olursunuz.
• Bağlam ve Niyet Sağlayın: Görselin amacını veya istenen ruh halini açıklayın. Modelin bağlamı anlaması, yaratıcı seçimlerini etkileyecektir.
• Yineleyin ve İyileştirin: İlk denemede mükemmellik beklemeyin. Kademeli değişiklikler yapmak ve görselinizi iyileştirmek için modelin konuşma yeteneğini kullanın.
• Adım Adım Talimatlar Kullanın: Karmaşık sahneler için promptunuzu bir dizi net, sıralı talimata bölün.
• Olumlu Çerçeveleme Kullanın: "araba yok" gibi olumsuz promptlar yerine, istenen sahneyi olumlu bir şekilde tanımlayın: "hiçbir trafik belirtisi olmayan boş, ıssız bir sokak."
• Kamerayı Kontrol Edin: Kompozisyonu yönlendirmek için "geniş açı çekim", "makro çekim" veya "alçak açı perspektifi" gibi fotoğrafçılık ve sinema terimlerini kullanın.

En iyi uygulamalar hakkında daha derinlemesine bilgi için, promptlama en iyi uygulamaları ile ilgili resmi blog yazısını ve dokümantasyondaki promptlama rehberini inceleyin.

9. Topluluk Örnekleri ve İlham

Topluluğun Nano Banana ile neler yaptığını keşfedin:

• Kamera perspektifini değiştirme @henrydaubrez: X gönderisi
• Tutarlı karakter tasarımı için az örnekle öğrenme @multimodalart: X gönderisi
• "Kırmızı ok ne görüyor?" Google Maps dönüşümleri @tokumin: X gönderisi
• Çubuk figür açıklamalarından görsel oluşturma @yachimat_manga: X gönderisi
• Durağan görsellerden 3D modeller oluşturma @deedydas: X gönderisi
• Konum tabanlı AR deneyimleri oluşturma @bilawalsidhu: X gönderisi
• 2D haritayı 3D grafiğe dönüştürme @demishassabis: X gönderisi

10. Kaynaklar ve Sonraki Adımlar

Bu rehber, Nano Banana (namıdiğer Gemini 2.5 Flash Image) ile uygulama geliştirmenin temellerini kapsamıştır. Ortamınızı nasıl kuracağınızı, görselleri nasıl oluşturup düzenleyeceğinizi ve ileri düzey teknikleri nasıl uygulayacağınızı öğrendiniz. Artık bu güçlü yetenekleri kendi projelerinize dahil etmeye hazırsınız.

Daha fazla bilgi için resmi kaynaklara göz atın:

• Google AI Studio
• Gemini API dökümanları
• Nano Banana Gemini API dökümanları
• En iyi sonuçlar için Gemini 2.5 Flash Image Generation'a nasıl prompt verilir
• Nano Banana dökümantasyonu promptlama rehberi.
• AI Studio'da Pixshop uygulaması

Bununla havalı bir şey yapıyorsanız, görmeyi çok isterim! Bana DM atabilir veya X'te beni etiketleyebilirsiniz: @patloeber.

\Orjinal gönderi [Dev.to adresinde]