TR ▾

Hattınız için sansürsüz metin API'si

Nano Banana API iş akışlarını metin LLM ile nasıl kullanılır

Bu site görsel oluşturmaz. İnsanların görsel araçların yanında istem, açıklama ve betik yazmak için kullandığı, OpenAI uyumlu metin tabanlı bir LLM API'sidir. İşte kurulum ve kullanım rehberi.

güncellendi

Boş bir çerçeveye doğru akan metin kartlarının izometrik illüstrasyonu, istemlerin görsel iş akışını beslediğini gösterir

Anahtar noktalar

  • API yalnızca metin döndürür: görsel, ses veya video oluşturma yoktur.
  • Base URL https://api.nanobananaapis.com/v1, model kimliği sansürsüz ve bir Bearer anahtarı kullanın.
  • Yaygın bir kullanım, ham fikirleri JSON modu ile yapılandırılmış görsel istemlerine dönüştürmektir.
  • Girdi $0.15 ve çıktı $0.50 her 1M token için, başarısız istekler ücretsizdir.

Önce bunu okuyun: bu API'nin ne olduğu ve ne olmadığı

Buraya nano banana api kullanarak resim üretmek için mi geldiniz? Dürüst cevap, bu hizmetin bu kısmı yapamamasıdır. "Nano Banana", insanların genellikle bir görsel oluşturma modeline attığı bir addır ve görsel oluşturma burada sunulmaz. nanobananaapis.com'ın sattığı şey, OpenAI uyumlu bir uç nokta üzerinden bir metin dil modeline erişimdir.

Bu, birçok görsel iş akışına hala uyar, çünkü görsel araçlar yalnızca besledikleri metin kadar iyidir. Bir metin modeli istemleri yazabilir, çeşitlendirebilir, bir stil sayfasıyla karşılaştırabilir, açıklama ve alternatif metinler üretebilir ve bir boru hattını birleştiren betikleri taslak haline getirebilir. Bu sayfa bu kullanımı anlatır. Yalnızca resimlere ihtiyacınız varsa, bunun yerine bir görsel hizmet istersiniz ve bunu bununla eşleştirebilirsiniz.

Model, bağımsız bir sağlayıcı tarafından yönetilen tek bir açık ağırlıklı modeldir ve yasal yetişkin kullanımı için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır. Büyük bir satıcının resmi API'si değildir. Tek katı limit: reşit olmayanlar ile ilgili cinsel içerik yoktur.

Adım 1: anahtar alın

Google ile veya e-posta ve şifre ile kaydolun, ardından API anahtarı sayfasını açın. $0,50 değerinde deneme kredisi talep etmek için tek tıkla bir buton göreceksiniz. 7 gün boyunca geçerlidir, kart gerektirmez ve kişi başı bir kezle sınırlıdır. Bir deneme anahtarı dakikada 60 istek ve eşzamanlı 2 istek ile sınırlıdır; bu, denemeler için yeterlidir.

Anahtarı kopyalayın ve depo (repository) içinde tutmayın. Bir kabuk (shell) ortamında bunu şu şekilde saklayabilirsiniz:

export NANOBANANA_KEY="paste-your-key-here"

Adım 2: ilk isteğinizi gönderin

Üç değer önemlidir: base URL, model kimliği ve Authorization başlığı. Geri kalanı OpenAI chat-completions formatını takip eder. İşte curl ile ilk çağrı:

curl https://api.nanobananaapis.com/v1/chat/completions   -H "Authorization: Bearer $NANOBANANA_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}
    ],
    "max_tokens": 200
  }'

Resmi openai paketiyle Python'da aynı şey:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}],
)
print(r.choices[0].message.content)

Ve Node.js'te:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.nanobananaapis.com/v1",
  apiKey: process.env.NANOBANANA_KEY,
});

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write one detailed image prompt for a foggy harbor at dawn." }],
});
console.log(r.choices[0].message.content);

Yanıt başlıklarını bir kez kontrol edin. X-Balance-USD kalan kredinizi gösterir ve X-Request-Id yardıma ihtiyacınız olursa çağrıyı tanımlar. docs sayfası desteklenen tüm parametreleri listeler.

Adım 3: fikirleri yapılandırılmış istemlere dönüştürün

Bir görsel boru hattı için en faydalı hile, modelin serbest metin yerine yapılandırılmış veri döndürmesini sağlamaktır. JSON modu bunu yapar. Şemayı sistem mesajında tanımlarsınız ve yanıt doğrudan kodunuza ayrıştırılır, böylece kabaca hazırlanmış fikirler, sabit alanlara sahip bir istem tablosuna dönüşür.

import json, os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

SYSTEM = (
    "You write prompts for an image model. Reply with JSON only: "
    '{"prompts": [{"subject": str, "style": str, "lighting": str, "negative": str, "full": str}]}'
)

def expand(idea: str, n: int = 3):
    r = client.chat.completions.create(
        model="uncensored",
        response_format={"type": "json_object"},
        temperature=0.9,
        messages=[
            {"role": "system", "content": SYSTEM},
            {"role": "user", "content": f"Give {n} distinct prompts for: {idea}"},
        ],
    )
    return json.loads(r.choices[0].message.content)["prompts"]

for p in expand("a lighthouse keeper's kitchen in winter"):
    print(p["full"])

Çeşitlilik istediğinizde temperature değerini artırın, tutarlılık için düşürün. seed parametresi doğrudan iletilir, böylece önceki bir dizi sonucu tekrar üretmek gerektiğinde sabitleyebilirsiniz. Her zaman json.loads işlemini bir try bloğu içine alın ve ayrıştırma başarısız olursa bir kez daha isteyin, çünkü herhangi bir dil modeli hata yapabilir.

Sitenin ayrıca görsel tarafına ilişkin ilgili bir açıklayıcısı vardır: istem oluşturma ve son işleme. Metin adımının bir oluşturucuya nasıl bağlandığını kapsar.

Bir görsel iş akışında metin modelinin iyi yaptığı diğer işler

  • Stil sayfaları. Sabit stil kurallarınızı içeren tek bir sistem mesajı tutun ve her yeni konuyu bunun üzerinden geçirin, böylece bir seri görsel olarak tutarlı kalır.
  • Açıklamalar ve alternatif metin. Görseller var olduktan sonra, her birini birkaç kelimeyle açıklayın. Görselin kendi açıklamasını girdi olarak iletin; model resimleri göremez çünkü API yalnızca metin alır.
  • Çekim listeleri ve betikler. Bir hikaye tahtası veya kısa video için sahne listesini, seslendirme metnini ve ekrandaki vuruşları metin olarak taslak haline getirin.
  • İstem eleştirisi. Kötü sonuçlar veren bir istemi yapıştırın ve değişiklikler açıklanarak üç yeniden yazım isteyin.
  • Kurgu ve karakter çalışmaları yetişkinler içindir. Hikayeler ve companion uygulamalar için karakter formları, arka plan hikayeleri ve diyaloglar; model yasal yetişkin temaları reddetmez.

Uzun işler için, bir kullanıcı arayüzünün metni geldiğinde göstermesi için stream: true ile akış yapın. Fonksiyon çağırma da desteklenir, bu da bir modelin kendi fonksiyonunuzu ne zaman çağıracağına karar vermesini sağlar; örneğin, kullandığınız görsel servise bir istem gönderen bir fonksiyon.

Limitler ve bir çalıştırma maliyeti

Bir toplu iş oluşturmadan önce sayıları bilin. Tam anahtar 8 eşzamanlı istek ve dakika başına 300 istek yapmanıza olanak tanır. Bağlam penceresi, istem ve tamamlama dahil olmak üzere 100,000 token kapsar; maksimum istek gövdesi 8 MB'dir ve max_tokens isteğe bağlıdır. Hız limitini aşmak, rate_limited veya concurrency koduyla birlikte HTTP 429 döndürür; bekleyip yeniden deneyin.

Fiyatlandırma 1M girdi token başına $0.15 ve 1M çıktı token başına $0.50'dir. Diyelim ki 500 istem kümesi oluşturuyorsunuz, her biri 400 token girdi ve 600 token çıktı ile:

  • Girdi: 500 x 400 = 200.000 token x $0.15 / 1M = $0,03
  • Çıktı: 500 x 600 = 300.000 token x $0.50 / 1M = $0,15
  • Toplam: $0,18

Yani $0.50 deneme kredisi bu boyuttaki yaklaşık 1.300 seti karşılar. Düzenli kullanım için, kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile $20 ile $500 arasında herhangi bir tam tutarı bakiye yükleyin. Bonuslar $50'den %5, $100'den %10 ve $200'den %15'tir. Tablo için fiyatlandırma sayfasına bakın. Kredi süresi dolmaz.

Bir görsel servisle eşleştirme

Yaygın kurulum iki aşamalıdır. Metin aşaması bu API'yi istemler üretmek için kullanır. Görsel aşaması bu istemleri kullandığınız herhangi bir görsel oluşturucuya gönderir ve bu oluşturucunun kendi hesabı, kendi fiyatlandırması ve kendi kuralları vardır; bunları sitenizde okumalısınız. İki aşamayı ayrı işlevlerde tutun, böylece bir tarafı değiştirdiğinizde diğerini yeniden yazmak zorunda kalmazsınız.

Pratik bir ipucu: Her istemi, oluşturmak için kullandığınız seed ve temperature değerleriyle birlikte kaydedin. Bir görüntü iyi çıktığında, onu üreten tam metne geri izleme yapabilirsiniz; bir dizi hayal kırıklığı yarattığında ise hatanın fikirde mi, istem yazarında mı yoksa görüntü modelinde mi olduğunu görebilirsiniz. Ayrıca, aynı fikir listesinde her iki sistemi çalıştırarak iki istem kümesini yan yana değerlendirerek karşılaştırma yapmanın ucuz bir yolunu da sağlar.

Küçük bir uçtan uca betik

Parçaları birleştirmek için, kabaca fikirler içeren bir dosyadan okuma yapan, her birini JSON modu ile istemlere dönüştüren ve sonucu görüntü aracınızın okuyabileceği bir dosyaya yazan kısa bir betik aşağıdadır. Aksi takdirde sizi rahatsız edecek bir hata durumunu yönetir: geçerli olmayan JSON yanıtı.

import json, os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

def one(idea: str):
    for _ in range(2):
        r = client.chat.completions.create(
            model="uncensored",
            response_format={"type": "json_object"},
            messages=[
                {"role": "system", "content": 'Reply with JSON only: {"prompt": str}'},
                {"role": "user", "content": f"Write a vivid, specific image prompt for: {idea}"},
            ],
            max_tokens=250,
        )
        try:
            return json.loads(r.choices[0].message.content)["prompt"]
        except (json.JSONDecodeError, KeyError):
            continue
    return None

ideas = [line.strip() for line in open("ideas.txt") if line.strip()]
out = {i: one(i) for i in ideas}
json.dump(out, open("prompts.json", "w"), indent=2)

Önce beş fikir üzerinde çalıştırın ve sonuçları gözle okuyun. İstemler istediğiniz stili yansıtana kadar sistem mesajını ayarlayın, sonra ölçeklendirin. Burada her istek küçük olduğu için, binlerce fikir hızlıca tamamlanır ve sentlere mal olur.

Yeni başlayanların yaptığı hatalar

  • Resim bekleniyor. Yanıt her zaman metindir. Kodunuz yanıtın ikili bir resmini kaydetmeye çalışırsa başarısız olur, çünkü böyle bir şey yoktur.
  • Farklı bir model adı aramak. Tek bir model vardır ve kimliği uncensored'dir. Bir öğreticiden bir satıcı model adını kopyalamak bulunamadı hatası verir.
  • Sistem mesajını unutmak. Onu olmadan modelin stil rehberliği yoktur ve kısa ve uzun istemler arasında kayar. Kurallarınızı oraya koyun.
  • Gizli bilgileri istemlere göndermek. İstemler eğitim için kullanılmaz, ancak yine de şifreleri veya özel anahtarları herhangi bir model girdisine yapıştırmaktan kaçınmalısınız.
  • Aynı anda yüz istek çalıştırma. Tam bir anahtar eşzamanlı olarak 8 istek ile sınırlıdır. Bir havuz veya semaphore kullanın ve 429 hatası için yeniden deneme ekleyin.

Bir şey garip davranıyorsa, destek sayfası soru sorabileceğiniz yerdir ve yanıt başlıklarından gelen istek kimliği soruyu çok daha kolay cevaplamayı sağlar.

Sorular ve cevaplar

Bu API Nano Banana görselleri oluşturabilir mi?

Hayır. Bu metin tabanlı bir LLM API'sidir. Görsel iş akışları için istem, açıklama ve betikler yazabilir ancak görsel, ses veya video üretmez.

Model adı olarak ne yazmalıyım?

Model kimliği olarak uncensored'ı, base URL olarak https://api.nanobananaapis.com/v1'i ve anahtarınızı Bearer token olarak kullanın.

Ödemeden test edebilir miyim?

Evet. Yeni kullanıcılar API anahtarı sayfasında tek tıkla $0.50 ücretsiz deneme kredisi alabilir. Kart gerekmez ve 7 gün geçerlidir.

Model resimlerimi görüyor mu?

Hayır. Sadece metni okur. Bir resimle ilgili yardıma ihtiyacınız varsa, mesajınızda onu açıklayın.

İstemlerim eğitim için kullanılıyor mu?

Hayır. İstemler eğitim için kullanılmaz.

Anahtarınız bir formu doldurarak hazır

Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.

API anahtarı al