Nano Banana API Kılavuzu: TokenLab Üzerinden Görsel Oluşturma ve Düzenleme

Nano Banana API, geliştiricilere TokenLab'in birleşik API katmanı üzerinden doğrudan erişilebilen yüksek verimli görsel oluşturma ve düzenleme yetenekleri sunar. Bu kılavuz, kimlik doğrulamanın, yük yapılandırmasının ve bu görsel oluşturma hatlarının üretim uygulamalarınıza nasıl entegre edileceğini göstermektedir.

Önemli Çıkarımlar

• Nano Banana API, hızlı görsel oluşturma ve hassas düzenleme görevlerinde uzmanlaşmıştır.
• TokenLab, birden fazla model sağlayıcısı için tek bir SDK ve birleşik faturalandırma sunarak entegrasyonu basitleştirir.
• Yük yapıları, optimum çıktı için belirli boyutlar, istem formatları ve güç parametreleri gerektirir.
• Geliştiriciler, Nano Banana'nın performans ve fiyatlandırma metriklerini diğer endüstri standardı modellerle doğrudan TokenLab üzerinde karşılaştırabilirler.

Nano Banana API Nedir?

Nano Banana API, düşük gecikmeli görsel oluşturma ve manipülasyon için tasarlanmış özel bir arayüzdür. Kendi kendine barındırılan difüzyon modellerini yönetme yükü olmadan hızlı prototipleme ve ölçeklenebilir üretim iş akışlarına ihtiyaç duyan geliştiricilere hitap eder. İstekleri TokenLab üzerinden yönlendirerek, geliştiriciler bu modele daha geniş bir araç paketiyle birlikte erişebilirler.

2026'daki en iyi yapay zeka görsel modelleri API'sini değerlendirirken, geliştiriciler genellikle Nano Banana'yı Stable Diffusion XL veya Midjourney gibi daha büyük modellerle karşılaştırırlar. Bu modeller karmaşık istemler için yüksek sadakatli çıktılar sunarken, Nano Banana yürütme hızına ve maliyet verimliliğine odaklanır. Bu modelin teknik özelliklerini ve kullanılabilirliğini TokenLab model dizininde inceleyebilirsiniz (gözlem tarihi: 2026-07-07).

TokenLab Üzerinden Kimlik Doğrulama ve Kurulum

Nano Banana API ile etkileşim kurmak için isteklerinizi TokenLab ağ geçidi üzerinden yönlendirmeniz gerekir. Bu, bir API anahtarı ve standart bir HTTP istemcisi gerektirir. Aşağıdaki kontrol listesi, geliştirme ortamınızı hazırlamak için gereken adımları özetlemektedir.

Entegrasyon Kontrol Listesi

• TokenLab'de aktif bir geliştirici hesabı oluşturun.
• TokenLab kontrol panelinden bir üretim API anahtarı oluşturun.
• API anahtarını TOKENLAB_API_KEY adlı bir ortam değişkeni olarak kaydedin.
• Python'da requests veya Node.js'te axios gibi bir HTTP istemci kütüphanesi yükleyin.
• Kesintisiz API çağrıları sağlamak için hesap bakiyenizi veya faturalandırma yapılandırmanızı doğrulayın.

Bu adımları tamamladıktan sonra, istemcinizi TokenLab uç noktasına işaret edecek şekilde yapılandırın. Tüm istekler için temel URL https://api.tokenlab.sh/v1 şeklindedir ve API anahtarı yetkilendirme başlığında iletilmelidir.

# Kimlik doğrulamayı doğrulamak için örnek curl komutu
curl -X GET "https://api.tokenlab.sh/v1/models" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Nano Banana API ile Görsel Oluşturmayı Uygulama

Metinden görsele oluşturma, Nano Banana API için birincil giriş noktasıdır. API; metin istemini, istenen boyutları ve çıkarım parametrelerini içeren bir JSON yükünü kabul eder.

Nano Banana'nın operasyonel maliyetlerinin diğer modellerle nasıl karşılaştırıldığını anlamak için TokenLab fiyatlandırma karşılaştırma kılavuzuna başvurun. Model fiyatlandırması sağlayıcı güncellemelerine göre değişebileceğinden, okuyucular güncel fiyatlandırmayı bağlantılı kaynaktan doğrulamalıdır.

Aşağıdaki Python betiği, TokenLab aracılığıyla Nano Banana API'ye nasıl metinden görsele isteği gönderileceğini göstermektedir.

import os
import requests
import json

def generate_image(prompt, width=512, height=512):
    api_key = os.getenv("TOKENLAB_API_KEY")
    if not api_key:
        raise ValueError("TOKENLAB_API_KEY ortam değişkeni ayarlanmamış.")

    url = "https://api.tokenlab.sh/v1/images/generations"
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
    
    payload = {
        "model": "nano-banana",
        "prompt": prompt,
        "width": width,
        "height": height,
        "num_inference_steps": 30,
        "guidance_scale": 7.5,
        "response_format": "url"
    }

    response = requests.post(url, headers=headers, json=payload)
    
    if response.status_code == 200:
        data = response.json()
        return data["data"][0]["url"]
    else:
        raise Exception(f"API Hatası {response.status_code}: {response.text}")

# Örnek kullanım
if __name__ == "__main__":
    prompt_text = "Ahşap bir masa üzerinde seramik bir vazonun minimalist stüdyo portresi"
    try:
        image_url = generate_image(prompt_text)
        print(f"Oluşturulan Görsel URL'si: {image_url}")
    except Exception as e:
        print(f"Oluşturma başarısız oldu: {e}")

İstemlerinizi yapılandırırken tanımlayıcı, somut isimler kullanın. Nano Banana API, istem ağırlıklarını sırayla işler; yani istemin başında yer alan terimler, sonunda yer alan terimlere göre nihai çıktı üzerinde daha güçlü bir etkiye sahiptir.

Görsel Düzenleme ve Inpainting İş Akışları

Standart metinden görsele oluşturmanın ötesinde, Nano Banana API görselden görsele değişiklikleri ve yerel inpainting (iç boyama) işlemlerini destekler. Bu iş akışları, bir başlangıç kaynak görseli ve inpainting durumunda, değiştirilecek bölgeyi gösteren siyah-beyaz bir maske gerektirir.

Görselden görsele bir görev yürütmek için kaynak görseli base64 kodlu bir dize veya herkese açık bir URL olarak sağlamanız gerekir. strength (güç) parametresi, modelin orijinal görseli ne kadar değiştireceğini belirler. 0.0 değerindeki bir güç parametresi kaynak görseli değiştirmeden bırakırken, 1.0 değeri orijinal yapıyı tamamen terk ederek yeni istemi tercih eder.

# Görselden görsele düzenleme için kavramsal yük yapısı
edit_payload = {
    "model": "nano-banana",
    "prompt": "Yumuşak beyaz bulutlu mavi bir gökyüzü ekle",
    "image": "data:image/jpeg;base64,...", # Base64 kodlu kaynak görsel
    "strength": 0.6,
    "guidance_scale": 8.0
}

Inpainting görevleri için maske görseli, kaynak görselin boyutlarıyla eşleşmelidir. Maskedeki beyaz pikseller yeniden çizilecek alanları temsil ederken, siyah pikseller kilitli kalır. Bu yaklaşım, ürünün kendisini korurken bir ürün fotoğrafının arka planını değiştirmek gibi e-ticaret uygulamaları için oldukça etkilidir.

Bu modeli yığınınıza entegre etmeye başlamak için bugün TokenLab ile Başlayın.

Nano Banana'yı Alternatif API'lerle Karşılaştırma

Doğru modeli seçmek, uygulamanızın gecikme süresi, çıktı kalitesi ve maliyet konusundaki özel gereksinimlerine bağlıdır. Aşağıdaki tablo, Nano Banana API'yi sektörde mevcut olan diğer önde gelen modellerle karşılaştırmaktadır.

Model / API	Birincil Kullanım Durumu	Temel Güçlü Yönü	Fiyatlandırma Referans Kaynağı
Nano Banana API	Hızlı görsel oluşturma ve düzenleme	Düşük gecikme, basit yük yapısı	TokenLab Modelleri (gözlem tarihi: 2026-07-07)
Google Gemini (Imagen)	Çok modlu görevler ve yüksek çözünürlüklü oluşturma	Kurumsal güvenlik, Google ekosistemi entegrasyonu	Google AI Fiyatlandırması (gözlem tarihi: 2026-07-07)
Stable Diffusion	Son derece özelleştirilebilir oluşturma	Açık kaynak esnekliği, özel LoRA desteği	TokenLab Görsel Kategorisi

Karmaşık sistemler kuran geliştiriciler için API yönlendiricilerini karşılaştırmak da kritik bir adımdır. Çoklu sağlayıcı API ağ geçitlerinin yönlendirme ve hata toleransını nasıl yönettiğini anlamak için OpenRouter karşılaştırmamızı okuyabilirsiniz.

Uygulamanız statik görsellerin ötesinde yetenekler gerektiriyorsa, 2026'daki en iyi yapay zeka video modelleri API'sini incelemek veya geliştirme iş akışlarınızı desteklemek için 2026'daki kodlama için en iyi yapay zeka modellerini keşfetmek isteyebilirsiniz.

Uygulamanız için hız, maliyet ve kalite arasındaki optimum dengeyi bulmak üzere TokenLab üzerinde görsel modellerini karşılaştırın.

SSS

Nano Banana API tarafından desteklenen maksimum çözünürlük nedir?

Nano Banana API, yerel olarak 1024x1024 piksele kadar çözünürlükleri destekler. 16:9 veya 4:3 gibi kare olmayan en boy oranları talep edebilseniz de, toplam piksel sayısını yerel çözünürlüğe yakın tutmak, yinelenen nesneler gibi görsel bozulmaları önlemeye yardımcı olur.

TokenLab, Nano Banana API için hız sınırlarını (rate limits) nasıl yönetir?

TokenLab, hız sınırlarını hesap seviyenize göre dinamik olarak yönetir. Uygulamanız dakika başına izin verilen istek sayısını aşarsa, API 429 Too Many Requests durum kodunu döndürür. Bu sınırları düzgün bir şekilde yönetmek için HTTP istemcinizde üstel geri çekilme (exponential backoff) uygulamanız önerilir.

Nano Banana'yı ticari uygulamalar için kullanabilir miyim?

Evet, TokenLab aracılığıyla Nano Banana API kullanılarak oluşturulan görseller genellikle ticari kullanım için onaylanmıştır. Ancak geliştiriciler, giriş istemlerinin ve kaynak görsellerinin üçüncü taraf fikri mülkiyet haklarını veya platformun kabul edilebilir kullanım politikalarını ihlal etmediğinden emin olmalıdır.