TR ▾

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

Nanobanana API Entegrasyonu: SillyTavern, LangChain, Cursor

Buradaki bir nanobanana api entegrasyonu, OpenAI uyumlu bir metin uç noktasını zaten kullandığınız araçlara bağlamaktır. Her biri için aynı üç değere ihtiyaç vardır: bir base URL, bir anahtar ve bir model kimliği.

güncellendi

Bir merkez bağlantılı kablolarla bir sohbet paneline, bir kod editörüne ve bir iş akışı grafiğine bağlanan izometrik illüstrasyon

Anahtar noktalar

  • Üç değer temel URL https://api.nanobananaapis.com/v1, anahtarınız ve model kimliği uncensored'dır.
  • Önce curl ile test edin, ardından SillyTavern, LangChain, Cursor veya herhangi bir OpenAI SDK'sını yapılandırın.
  • API yalnızca metindir; görüntü, ses veya gömme oluşturmaz.
  • Tam yetkili bir anahtarla 429 hatalarından kaçınmak için eşzamanlı istek sayısını 8 ile sınırlı tutun.

Her entegrasyon için gereken üç değer

nanobanana api entegrasyonu ile ilgili neredeyse her kılavuz, farklı bir yere aynı üç alanı doldurmaya indirgenir. Hizmet, OpenAI sohbet tamamlama protokolünü kullandığından, OpenAI uç noktasını geçersiz kılmaya olanak tanıyan bir araç onunla iletişim kurabilir.

AlanDeğer
Temel URLhttps://api.nanobananaapis.com/v1
API anahtarıAnahtarınız, Authorization: Bearer <key> olarak gönderilir
Model kimliğiuncensored

Başlamadan önce bir kapsam notu. Bu bir metin dil modelidir, bu nedenle görüntü oluşturma, konuşma veya gömme bekleyen yerlerde çalışmaz. Desteklenen yöntemler POST /v1/chat/completions ve GET /v1/models şeklindedir. Bir araç, arama için gömme modeli isterse, o kısmı farklı bir sağlayıcıya yönlendirin.

Anahtarınızı API anahtarı sayfasından alırsınız. Yeni hesaplar, kart gerekmeden ve 7 gün boyunca geçerli olacak şekilde tek tıkla $0,50 deneme kredisi talep edebilir (ödeme yalnızca kripto ile yapılır).

Herhangi bir araca dokunmadan önce uç noktayı test edin

Bir entegrasyon başarısız olduğunda, insanlar aracı suçlu bulur. Çoğu zaman anahtar veya URL yanlıştır. Otuz saniyelik bir curl testi bu şüpheyi ortadan kaldırır. İlk olarak modelleri listeleyin:

curl https://api.nanobananaapis.com/v1/models   -H "Authorization: Bearer YOUR_API_KEY"

Ardından kısa bir sohbet isteği gönderin:

curl https://api.nanobananaapis.com/v1/chat/completions   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}],"max_tokens":10}'

İkisi de çalışıyorsa, uç nokta ve anahtar iyidir ve sonraki tüm hatalar bir aracın yapılandırmasından kaynaklanır. İlk çağrı 401 hatası döndürürse, anahtar yanlış veya üst bilgi içinde Bearer kelimesi eksiktir. 404 hatası genellikle URL'nin /v1 eksik olduğunu veya ekstra bir yol içerdiğini gösterir.

SillyTavern

SillyTavern, rol yapma ve karakter sohbetleri için bir ön uçtur ve OpenAI uyumlu bir uç nokta eklemenize olanak tanır. Menü etiketleri sürümler arasında değiştiği için adımları tam bir metin olarak değil, bir harita olarak ele alın.

  1. API bağlantı panelini açın ve API türü olarak Chat Completion seçeneğini belirleyin.
  2. Özel (OpenAI uyumlu) kaynağını seçin.
  3. Uç nokta URL'si olarak https://api.nanobananaapis.com/v1 yapıştırın.
  4. Anahtar alanına anahtarınızı yapıştırın.
  5. uncensored model adını girin veya bağlantı düğmesine basıp GET /v1/models tarafından döndürülen listeden seçin.
  6. Bağlan'a basın ve bir test mesajı gönderin.

İki ayar notu. SillyTavern, karakter kartlarıyla uzun geçmişler gönderir, bu yüzden istem ve yanıt tarafından paylaşılan 100.000 token bağlam penceresine dikkat edin. Grup sohbetleri aynı anda birkaç istek tetiklediğinde, tam anahtar üzerinde 8 eşzamanlı istek sınırını ve deneme anahtarı üzerinde 2'yi unutmayın. Rol yapma ve arkadaş kurulumları yetişkinler içindir; model hiçbir istem altında reşit olmayanların cinsel içerikli olduğu içeriği üretmez.

LangChain

Python'da langchain-openai paketi, özel bir temel URL kabul eden ChatOpenAI sağlar. pip install langchain-openai ile yükleyin.

import os
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
    model="uncensored",
    temperature=0.7,
)

print(llm.invoke("Give me three names for a fictional smuggler ship.").content)

Zincirler, istem şablonları ve çıktı ayrıştırıcıları daha sonra aynı şekilde çalışır çünkü yalnızca sohbet arayüzünü kullanırlar. Araç çağırma standart yolu izler, bu nedenle llm.bind_tools([...]) istekte tools gönderir. Bir ajan etrafında oluşturmadan önce tek bir araç çağırmasını test edin ve ajan eşzamanlılığını 8 ile sınırlayın. Yirmi dalda yayılan bir grafik concurrency hatası ile karşılaşacaktır.

JavaScript paketi @langchain/openai, configuration: { baseURL } seçeneği üzerinden ChatOpenAI ile aynı fikri uygular.

Cursor ve diğer editörler

Cursor, diğer birkaç kod editörü gibi, kendi OpenAI API anahtarınızı sağlayabileceğiniz ve temel URL'yi geçersiz kılabilen modeller için bir ayar alanına sahiptir. Kabaca: model ayarlarını açın, özel OpenAI anahtarı seçeneğini etkinleştirin, geçersiz kılma temel URL'sini https://api.nanobananaapis.com/v1 olarak ayarlayın, anahtarınızı yapıştırın ve özel model adı olarak uncensored ekleyin.

Size ne verdiğini gerçekçi değerlendirin. Editörler, iç tamamlama gibi bazı özellikleri kendi arka uçları ve belirli model adları etrafında oluşturur, bu nedenle özel bir uç nokta yalnızca sohbet veya komutların bir alt kümesi için geçerli olabilir. Tam seçenekler sürümler arasında değişir, bu nedenle editörün güncel belgelerine bakın. Bu API'nin sunmadığı bir şey (gömme veya görüntü girişi gibi) gerektiren bir özellik varsa, bu uç nokta üzerinden çalışmaz.

Aynı desen Open WebUI, Continue ve benzeri sohbet ön uçları gibi diğer OpenAI uyumlu istemciler için de geçerlidir: özel bir OpenAI uç noktası için alanı bulun, üç değeri girin ve test edin.

Saf SDK'lar ve ortam değişkenleri

Kendi kodunuzu yazarsanız, resmi SDK'lar standart ortam değişkenlerini okur, bu da kaynak dosyalarına dokunmadan uç noktaları değiştirmenize olanak tanır. Python ve Node SDK'larında, OPENAI_BASE_URL ve OPENAI_API_KEY ayarlamak yeterlidir.

export OPENAI_BASE_URL="https://api.nanobananaapis.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python app.py   # app.py calls client.chat.completions.create(model="uncensored", ...)

Node'da açık bir istemci şöyle görünür:

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a short product description for a paper lantern." }],
  stream: true,
});

for await (const part of stream) {
  process.stdout.write(part.choices[0]?.delta?.content ?? "");
}

Akış, SSE üzerinden gelir ve kullanım sonu bildirilir. docs sayfası üzerinde tam parametre detayları yer alır ve istem oluşturma makalesi, bir metin adımını bir iş akışına nasıl bağlayacağınızı gösterir.

Yaygın hataların giderilmesi

BelirtiOlası nedenÇözüm
401 YetkisizYanlış anahtar veya Bearer eksik üstbilgiAnahtarı yeniden yazın ve curl ile test edin
404 BulunamadıTemel URL'de /v1 eksik veya yol iki kez yazılmışTam olarak https://api.nanobananaapis.com/v1 kullanın
Model bulunamadıAraç, varsayılan olarak bir satıcı model adını kullanırModeli uncensored olarak ayarlayın
rate_limited ile 429Dakikada 300 istekten fazla (denemede 60)Hızı düşürün ve tekrar deneyin
429 ile concurrencyAynı anda 8'den fazla istek (deneme anahtarında 2)Paralelliği düşürün
Retry-After: 5 ile 429Geçici aşırı yüklenmeBeş saniye bekleyin ve yeniden deneyin
İstek çok büyükGövde 8 MB'ın üzerindeEkleri veya geçmişi kısaltın

Akışlı bir istek, akış sona erene kadar eşzamanlılık slotunu tutar, bu nedenle akışları terk eden bir editör meşgul değilken sınırı aşıyormuş gibi görünebilir. Başarısız çağrıların X-Request-Id üst bilgisini günlüğe kaydedin; destek ilk olarak bunu soracaktır.

Maliyet konusunda, 2.000 token girdisi ve 500 token çıktısı olan tipik bir sohbet mesajı, 1 milyon token başına $0.15 ve $0.50 fiyatlarla $0.00055 tutarındadır ve başarısız istekler ücretlendirilmez. fiyatlandırma sayfası, $20 ile $500 arasındaki bakiye yükleme işlemlerini ve bonus aşamalarını kapsar.

Anahtarlar, güvenlik ve verinin kimin tarafından görüleceği

Her entegrasyon anahtarınızı bir yere kaydeder ve bazıları diğerlerinden daha iyi kaydeder. Masaüstü bir ön uçta anahtar yerel bir ayarlar dosyasında bulunur. Tarayıcı tabanlı bir araçta tarayıcıda kaydedilmiş olabilir. Bir editörde uygulama yapılandırmasında yer alır. Bir ekranı paylaşmadan, bir dotfile'ı commit etmeden veya bir dizüstü bilgisayarı birine vermeden önce hangisini kullandığınızı bilin.

Bu durumu yönetilebilir kılan birkaç kural vardır. Mümkünse her araç için tek bir anahtar kullanın, böylece birini değiştirdiğinizde diğerlerini bozmadan yalnızca birini değiştirebilirsiniz. Yardım isterken bir anahtarı herkese açık bir sorun izleyiciye yapıştırmayın; bunun yerine istek kimliğini paylaşın. Bir anahtar sızarsa, anahtar sayfasından değiştirin ve araçlarınızı güncelleyin. API üzerinden gönderilen istemler eğitim için kullanılmaz ve gizlilik sayfası veri işlemenin geri kalanını açıklar.

Başkaları için bir ön uç barındırıyorsanız, anahtarınızı tarayıcıya göndermeyin. Kullanıcılarınız ile API arasında küçük bir sunucu yerleştirin, buraya kendi sınırlarınızı ekleyin ve anahtarı sunucuda tutun. Kullanıcılarınız daha sonra 8 eşzamanlı isteğinizi paylaşır, bu nedenle aynı anda kaç kişinin sohbet edebileceğini planlayın.

Hangi araç hangi işe uygun

Entegrasyon her yerde aynı olduğu için, araç seçimi ne yaptığınıza bağlıdır.

  • SillyTavern veya benzeri bir sohbet ön ucu, karakter sohbeti, kurgu ve yetişkinler için rol yapma için kod yazmadan gelişmiş bir arayüz ve karakter kartları istediğinizde uygundur.
  • LangChain, kod içindeki iş akışları için uygundur: yükleyiciler, istem şablonları, ayrıştırıcılar ve çok adımlı zincirler. Bir bağımlılık daha ekleyerek yapı sağlar.
  • Saf bir SDK çağrısı küçük betikler ve hizmetler için uygundur. Göreviniz bir istem girmek ve bir yanıt almaksa, OpenAI paketi bir çerçeveden daha az bakım gerektirir.
  • Cursor gibi bir editör kod hakkında sohbet için uygundur. Ona güvenmeden önce hangi özelliklerinin özel bir uç nokta kabul ettiğini kontrol edin.

Sadece curl testiyle başlayın, ardından SDK'ya geçin ve ihtiyacınızı hissettiğinizde bir çerçeve ekleyin. Sonradan geçiş kolaydır, çünkü üç değer hiç değişmez. İlk istek ve tam parametre listesi için belgeler sayfasını okuyun.

Sorular ve cevaplar

Bir nanobanana entegrasyonu için hangi temel URL'yi kullanmalıyım?

https://api.nanobananaapis.com/v1 adresini anahtarınızı Bearer token olarak kullanarak ve model kimliği olarak uncensored belirterek kullanın.

SillyTavern ile çalışıyor mu?

Evet. SillyTavern, Chat Completion altında özel bir OpenAI uyumlu uç nokta kabul eder. Temel URL'yi, anahtarı ve model kimliğini girin, ardından bağlanın.

LangChain'de gömme veya görüntü oluşturma için kullanabilir miyim?

Hayır. API yalnızca sohbet tamamlamaları ve model listesini destekler. Gömme veya görüntüler için başka bir sağlayıcı kullanın.

Ajanım neden 429 hatası veriyor?

Tam bir anahtar 8 eşzamanlı istek ve dakikada 300 istek izni verir. Paralel çağrıları sınırlayın ve kısa bir bekleme süresinden sonra yeniden deneyin.

Verilerim modelleri eğitmek için kullanılıyor mu?

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

Anahtarınız tek bir formun uzağında

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

API anahtarı al