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.
| Alan | Değer |
|---|---|
| Temel URL | https://api.nanobananaapis.com/v1 |
| API anahtarı | Anahtarınız, Authorization: Bearer <key> olarak gönderilir |
| Model kimliği | uncensored |
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.
- API bağlantı panelini açın ve API türü olarak Chat Completion seçeneğini belirleyin.
- Özel (OpenAI uyumlu) kaynağını seçin.
- Uç nokta URL'si olarak
https://api.nanobananaapis.com/v1yapıştırın. - Anahtar alanına anahtarınızı yapıştırın.
uncensoredmodel adını girin veya bağlantı düğmesine basıpGET /v1/modelstarafından döndürülen listeden seçin.- 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
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 401 Yetkisiz | Yanlış anahtar veya Bearer eksik üstbilgi | Anahtarı 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ır | Modeli uncensored olarak ayarlayın |
rate_limited ile 429 | Dakikada 300 istekten fazla (denemede 60) | Hızı düşürün ve tekrar deneyin |
429 ile concurrency | Aynı anda 8'den fazla istek (deneme anahtarında 2) | Paralelliği düşürün |
| Retry-After: 5 ile 429 | Geçici aşırı yüklenme | Beş saniye bekleyin ve yeniden deneyin |
| İstek çok büyük | Gövde 8 MB'ın üzerinde | Ekleri 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.
