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

Google, Nano Banana 2.1'i 6 Ekim 2026'da piyasaya sürdü ve Gemini API aracılığıyla gemini-nano-banana-2.1 olarak zaten çağrılabilir durumda. Bu, Nano Banana 2'nin (Gemini 3.1 Flash Image) daha iyi görsel kalite, maske tarzı düzenleme ve turlar arası daha güçlü karakter tutarlılığı ile güncellenmiş bir sürümüdür. Ayrıca, Nano Banana 2 ile paylaştıkları her çözünürlükte görsel başına yarı yarıya daha az maliyetlidir.

Bu kılavuz sizi boş bir terminalden kaydedilmiş bir görsele götürüyor, ardından en boy oranlarını, 2K ve 4K çıktıyı, düzenlemeyi, çok turlu değişiklikleri, referans görselleri, arama temelini ve maliyeti kapsıyor. Aşağıdaki her istek, 2.1'i bugün kullandığınız modelle karşılaştırabilmeniz için Apidog'da kaydedilebilir ve tekrar oynatılabilir.

button

Önce arka planı mı öğrenmek istiyorsunuz? Ne değiştiğini ve Google'ın henüz ne yayınlamadığını öğrenmek için Nano Banana 2.1 Nedir başlıklı yazıyı okuyun.

İhtiyacınız Olanlar

Tüm örnekler, Google'ın görsel oluşturma belgelerinin 2.1 için kullandığı Etkileşimler API'sini kullanır.

Adım 1: Bir Gemini API anahtarı edinin

1. Google AI Studio'yu açın ve oturum açın.
2. API anahtarı alın bölümüne gidin ve bir Google Cloud projesinde bir anahtar oluşturun.
3. Bu proje için faturalandırmayı etkinleştirin. Google'ın fiyatlandırma sayfası Nano Banana 2.1 için ücretsiz katmanı "Mevcut değil" olarak listelediğinden, API çağrıları için ücretli bir proje gereklidir.
4. Anahtarı dışa aktarın:

export GEMINI_API_KEY="your-key-here"

Google, 2.1'i istemleri test etmek için kullanışlı olan AI Studio oyun alanına bağlar, ancak ücretsiz bir hesabın orada ne kadar üretebileceğini yayınlamadı. Nano Banana 2.1'i ücretsiz nasıl kullanacağınız hakkındaki kılavuzumuz bu yolu kapsar ve bir Gemini API anahtarı alma, anahtar kurulumunu daha ayrıntılı olarak açıklar.

Adım 2: İlk görselinizi oluşturun

curl

curl -s -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": [
      {"type": "text", "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"}
    ]
  }'

Yanıt JSON formatındadır. Görsel, bir görsel içerik bloğu içinde base64 verisi olarak gelir, bu nedenle bunu çözmek için bir SDK'ya (veya bir betiğe) ihtiyacınız olacaktır.

Python

from google import genai
import base64

client = genai.Client()  # reads GEMINI_API_KEY

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme",
)

with open("generated_image.png", "wb") as f:
    f.write(base64.b64decode(interaction.output_image.data))

interaction.output_image, son oluşturulan görsel bloğunu döndürür. data alanı base64 olduğundan, dosyayı yazmadan önce onu çözmeniz gerekir.

JavaScript

import { GoogleGenAI } from "@google/genai";
import * as fs from "node:fs";

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-nano-banana-2.1",
  input: "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme",
});

const image = interaction.output_image;
if (image) {
  fs.writeFileSync("nano-banana.png", Buffer.from(image.data, "base64"));
}

Gemini 3 görsel modelleri çizim yapmadan önce düşünür. Model, kompozisyonu planlarken en fazla iki ara "düşünce görseli" üretebilir. Bunlar için ücretlendirilmezsiniz ve API'de düşünme kapatılamaz.

Adım 3: En boy oranını, çözünürlüğü ve yalnızca görsel çıktısını ayarlayın

Çıktıyı kontrol etmek için response_format kullanın. "type": "image" ayarı yalnızca görseli döndürür ve konuşma metnini atar, bu da yanıtları daha küçük ve ayrıştırmayı daha basit hale getirir.

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="A product shot of a matte black coffee grinder on a marble counter",
    response_format={
        "type": "image",
        "mime_type": "image/png",
        "aspect_ratio": "16:9",
        "image_size": "2K",
    },
)

Bilmeniz gerekenler:

• image_size, 1K, 2K ve 4K değerlerini kabul eder. Büyük harf K kullanın; 2k gibi küçük harfli değerler reddedilir.
• 2.1'de 512 piksel katmanı yoktur. Bu katman Nano Banana 2'ye aittir.
• Desteklenen oranlar arasında 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 ile birlikte aşırı 1:4, 4:1, 1:8 ve 8:1 bulunur. 2K'da 16:9 bir görsel 2752x1536; 4K'da ise 5504x3072'dir.
• Hem metin hem de görsel istiyorsanız, bir liste iletin: response_format=[{"type": "text"}, {"type": "image"}].

Adım 4: Mevcut bir görseli düzenleyin

Görselinizi, metin talimatının yanında base64 image bloğu olarak gönderin:

with open("living_room.png", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode("utf-8")

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input=[
        {"type": "text", "text": "Using the provided image of a living room, change only the blue sofa to be a vintage, brown leather chesterfield sofa. Keep the rest of the room, including the pillows on the sofa and the lighting, unchanged."},
        {"type": "image", "data": image_b64, "mime_type": "image/png"},
    ],
)

Maske dosyası olmadan maske tarzı inpainting

Ayrı bir maske yükleme yoktur. Maskeyi kelimelerle tanımlarsınız. Google'ın şablonu:

Sağlanan görseli kullanarak, yalnızca [belirli öğe] öğesini [yeni öğe/açıklama] olarak değiştirin. Görseldeki diğer her şeyi, orijinal stilini, aydınlatmasını ve kompozisyonunu koruyarak aynen bırakın.

Bir öğeyi adlandırın, değişimi somut bir şekilde açıklayın ve sabit kalması gerekenleri tekrarlayın. "Kanepenin daha güzel olmasını sağla" gibi belirsiz istemler, modeli tüm odayı yeniden çizmeye davet eder.

Adım 5: Çok turlu düzenleme ile yineleyin

Çok turlu düzenleme, Google'ın bir görseli iyileştirmek için önerdiği yöntemdir. Önceki etkileşimin id'sini previous_interaction_id olarak iletin ve yalnızca istediğiniz değişikliği gönderin:

interaction_2 = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="Update this infographic to be in Spanish. Do not change any other elements of the image.",
    previous_interaction_id=interaction.id,
    response_format={"type": "image", "mime_type": "image/png", "aspect_ratio": "16:9", "image_size": "2K"},
)

REST üzerinden, aynı alan gövdeye gider: "previous_interaction_id": "<PREVIOUS_INTERACTION_ID>". 2.1'in iyileştirilmiş çok turlu karakter tutarlılığının önemli olduğu yer burasıdır: bir karakter veya ürün, birkaç düzenleme turu boyunca tanınabilir kalmalıdır.

Adım 6: En fazla 14 referans görseli birleştirin

input listesine daha fazla image bloğu ekleyin. 2.1 için Google, en fazla 10 yüksek çözünürlüklü nesne görseli ve en fazla 4 karakter görseli, toplamda 14 görsel belgelendirir:

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input=[
        {"type": "text", "text": "An office group photo of these people, they are making funny faces."},
        {"type": "image", "data": person_1_b64, "mime_type": "image/png"},
        {"type": "image", "data": person_2_b64, "mime_type": "image/png"},
        {"type": "image", "data": person_3_b64, "mime_type": "image/png"},
    ],
    response_format={"type": "image", "aspect_ratio": "5:4", "image_size": "2K"},
)

Referans görselleri girdi jetonlarıdır ve 2.1 girdi maliyetleri Nano Banana 2'nin ücretlendirdiğinin üç katıdır. Yoğun referans iş akışları fiyat farkını daraltır, bu nedenle geçiş yapmadan önce ölçüm yapın.

Adım 7: Görselleri Google Arama ile ilişkilendirin

Hava durumu grafiği veya yakın zamanda gerçekleşen bir olay gibi güncel gerçeklere bağlı görseller için arama aracını ekleyin:

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="A detailed painting of a Timareta butterfly resting on a flower",
    tools=[{"type": "google_search", "search_types": ["web_search", "image_search"]}],
)

Yalnızca {"type": "google_search"} size web araması sağlar. image_search eklemek, modelin web görsellerini görsel bağlam olarak kullanmasına izin verir; bunu yalnızca 2.1 ve Nano Banana 2 destekler. İlişkilendirme, arama sonuçlarından insanların gerçek dünya görsellerini kullanamaz. İlişkilendirilmiş sonuçları kullanıcılara gösterirseniz, Google, google_search_result adımında döndürülen search_suggestions'ı görüntülemenizi gerektirir.

Adım 8: Apidog'da test edin

Betiikler oluşturma için uygundur. Bir istemin, bir anahtarın ve bir modelin hala doğru çalıştığını kontrol etmek için kaydedilmiş bir istek daha hızlıdır. Apidog'da:

1. Bir ortam oluşturun ve anahtarınızla birlikte GEMINI_API_KEY adında bir değişken ekleyin.
2. Bir istek oluşturun: POST https://generativelanguage.googleapis.com/v1beta/interactions.
3. x-goog-api-key: {{GEMINI_API_KEY}} başlığını ekleyin.
4. model, input ve response_format içeren bir JSON gövdesi yapıştırın, ardından Gönder'e tıklayın.
5. İki onaylama içeren bir yanıt sonrası betiği ekleyin:

pm.test("status is 200", () => {
  pm.response.to.have.status(200);
});

pm.test("response contains an image block", () => {
  const steps = pm.response.json().steps || [];
  const hasImage = steps.some(s =>
    s.type === "model_output" &&
    (s.content || []).some(c => c.type === "image" && c.data)
  );
  pm.expect(hasImage).to.be.true;
});

6. İsteği çoğaltın ve model'i gemini-3.1-flash-image olarak değiştirin. Her ikisini de aynı istemle gönderin.

Artık 2.1'i Nano Banana 2 ile yan yana kontrol edebilir, her çalıştırma için durum, zamanlama ve yanıt boyutunu görebilirsiniz. Daha geniş bir özellik karşılaştırması için Nano Banana 2.1 vs Nano Banana 2 vs Pro makalesine bakın.

Maliyeti Nedir

Ücretli katman, Google'ın 7 Ekim 2026 tarihli fiyatlandırma sayfasına göre:

2.1 için görsel çıktısı 1 milyon jeton başına 30 dolardır. 1K bir görsel 1.120 jeton, 2K 1.680 ve 4K 2.520 jetondur, görsel başına fiyatlar buradan gelmektedir. Metin ve düşünme çıktısı 1 milyon başına 7.50 dolardır. Arama ilişkilendirmesi, Gemini 3.x modelleri arasında paylaşılan aylık 5.000 ücretsiz isteği içerir, ardından her 1.000 istek için 14 dolar alınır.

Örnek: Kısa metin istemlerinden (her biri yaklaşık 100 girdi jetonu) 2K çözünürlükte 1.000 ürün görseli.

• Çıktı: 1.000 x 0.0504 $ = 50.40 $
• Girdi: 100.000 jeton x 1.50 $ / 1M = 0.15 $
• Toplam: yaklaşık 50.55 $, artı varsa düşünme metni jetonları

Nano Banana 2'de aynı işin maliyeti yaklaşık 101 dolardır. Toplu API aracılığıyla, 2.1'in 2K fiyatı 0.0252 dolara düşer, bu nedenle bekleyebilirseniz çıktı tarafı 25.20 dolara iner. Toplu işler, daha yüksek oran limitleri karşılığında 24 saate kadar bir geri dönüş süresi sunar. Nano Banana 2 fiyatlandırması hakkında daha fazla ayrıntı Nano Banana 2 API fiyatlandırma dökümümüzde bulunmaktadır.

Sık karşılaşılan hatalar

Bunlar genel Gemini API davranışlarıdır, 2.1'e özgü belgelenmiş hatalar değildir:

Sıkça Sorulan Sorular

Nano Banana 2.1 API için ücretsiz bir katman var mı? Hayır. Google, API ücretsiz katmanını "Mevcut değil" olarak listeler. AI Studio oyun alanı 2.1'e bağlantı verir, ancak Google bunun için ücretsiz bir limit yayınlamadı.

2.1, Nano Banana 2 için doğrudan bir yedek mi? Çoğunlukla evet. Model Kimliğini gemini-nano-banana-2.1 olarak değiştirmeniz yeterlidir. 512 piksel katmanını kaybedersiniz ve girdi jetonları daha pahalıya mal olur, bu nedenle referans ağırlıklı düzenlemeler için bir maliyet kontrolü gerekir.

Oluşturulan görseller filigran taşır mı? Evet. Tüm çıktılar bir SynthID filigranı içerir.

Videodan görsel oluşturabilir miyim? Evet. 2.1, metin isteminizin yanı sıra bir YouTube URL'si gibi bir video girdi bloğunu kabul eder.

Eski Nano Banana 2 API kılavuzu hala geçerli mi? Kavramlar geçerlidir. Daha önceki model için Nano Banana 2 API kılavuzumuza bakın.

Özet

Nano Banana 2.1, Nano Banana 2'nin görsel başına fiyatının yarısına, aynı Etkileşimler API şekliyle daha iyi görseller vaat ediyor. Faturalandırılmış bir anahtar edinin, bir görsel oluşturun, ardından isteği durum ve görsel onaylamalarıyla Apidog'a kaydedin. Eski model Kimliği ile çoğaltın, ve 2.1'in istemleriniz için geçişi hak edip etmediğini bir öğleden sonra içinde öğreneceksiniz.