PL ▾

API tekstu bez cenzury do Twojego pipeline

Integracja API Nanobanana: SillyTavern, LangChain, Cursor

Integracja API nanobanana oznacza podpięcie tekstowego endpointu kompatybilnego z OpenAI do narzędzi, których już używasz. Każde z nich wymaga tych samych trzech wartości: adresu URL bazowego, klucza i identyfikatora modelu.

Zaktualizowano

Izometryczna ilustracja jednego centrum połączonego kablami z panelem czatu, edytorem kodu i grafem przepływu pracy

Kluczowe punkty

  • Trzy wartości to base URL https://api.nanobananaapis.com/v1, twój klucz i ID modelu uncensored.
  • Przetestuj najpierw za pomocą curl, a następnie skonfiguruj SillyTavern, LangChain, Cursor lub dowolne SDK OpenAI.
  • API jest tylko tekstowe; nie generuje obrazów, audio ani embeddingów.
  • Trzymaj się limitu 8 równoległych zapytań przy pełnym kluczu, aby uniknąć błędów 429 od agentów i rozszerzeń.

Trzy wartości potrzebne każdej integracji

Prawie każdy przewodnik na temat integracji API nanobanana sprowadza się do wypełnienia tych samych trzech pól w innym miejscu. Usługa obsługuje protokół chat-completions OpenAI, więc narzędzie pozwalające na nadpisanie endpointu OpenAI może się z nim komunikować.

PoleWartość
Bazowy URLhttps://api.nanobananaapis.com/v1
Klucz APITwój klucz wysyłany jako Authorization: Bearer <key>
ID modeluuncensored

Jedna uwaga dotycząca zakresu przed rozpoczęciem. To model językowy tekstowy, więc nie zadziała w miejscach, które oczekują generowania obrazów, mowy lub wektorów. Obsługiwane metody to POST /v1/chat/completions i GET /v1/models. Jeśli narzędzie pyta o model wektorów do wyszukiwania, wskaż tę część na innego dostawcę.

Klucz otrzymasz ze strony strony klucza API. Nowe konta mogą jednorazowo odebrać $0.50 kredytu próbnego jednym kliknięciem, bez karty, ważny przez 7 dni.

Przetestuj endpoint przed użyciem dowolnego narzędzia

Gdy integracja zawodzi, ludzie obwiniają narzędzie. Najczęściej klucz lub URL są błędne. Trzydziestosekundowy test curl usuwa tę wątpliwość. Najpierw wypisz modele:

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

Następnie wyślij krótkie zapytanie czatu:

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}'

Jeśli oba zadziałają, endpoint i klucz są poprawne, a każdy późniejszy błąd wynika z konfiguracji narzędzia. Jeśli pierwsze wywołanie zwróci 401, klucz jest błędny lub brakuje słowa Bearer w nagłówku. 404 zwykle oznacza, że URL nie ma /v1 lub ma dodatkową ścieżkę.

SillyTavern

SillyTavern to interfejs do czatu z postaciami i odgrywania ról, który pozwala dodać endpoint kompatybilny z OpenAI. Etykiety menu zmieniają się między wersjami, więc traktuj kroki jako mapę, a nie dokładne słowa.

  1. Otwórz panel połączenia API i wybierz Chat Completion jako typ API.
  2. Wybierz źródło Własny (kompatybilny z OpenAI).
  3. Wklej https://api.nanobananaapis.com/v1 jako URL endpointu.
  4. Wklej swój klucz w polu klucz.
  5. Wpisz uncensored jako nazwę modelu lub naciśnij przycisk połączenia i wybierz go z listy zwracanej przez GET /v1/models.
  6. Naciśnij connect i wyślij wiadomość testową.

Dwie uwagi dotyczące konfiguracji. SillyTavern wysyła długie historie z kartami postaci, więc obserwuj okno kontekstu 100 000 tokenów, które jest dzielone przez prompt i odpowiedź. Jeśli używasz czatów grupowych, które wysyłają wiele żądań naraz, pamiętaj o limicie 8 równoległych zapytań przy pełnym kluczu (2 przy kluczu próbnym). Konfiguracje do odgrywania ról i towarzyskie są dla dorosłych; model nie wygeneruje treści seksualnych z udziałem nieletnich niezależnie od promptu.

LangChain

W Pythonie pakiet langchain-openai dostarcza ChatOpenAI, który akceptuje niestandardowy base URL. Zainstaluj go za pomocą pip install langchain-openai.

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)

Chains, szablony promptów i parsery wyjścia działają tak samo dalej, ponieważ interesuje ich tylko interfejs czatu. Wywoływanie narzędzi przebiega przez standardową ścieżkę, więc llm.bind_tools([...]) wysyła tools w zapytaniu. Przetestuj pojedyncze wywołanie narzędzia przed zbudowaniem agenta wokół niego i ogranicz równoległość agenta do 8. Graf rozgałęziający się na dwadzieścia gałęzi napotka błąd concurrency.

Pakiet JavaScript @langchain/openai wykorzystuje tę samą ideę poprzez opcję configuration: { baseURL } w ChatOpenAI.

Cursor i inne edytory

Cursor, podobnie jak kilka innych edytorów kodu, ma obszar ustawień modeli, w którym możesz podać własny klucz API OpenAI i nadpisać base URL. W przybliżeniu: otwórz ustawienia modeli, włącz opcję niestandardowego klucza OpenAI, ustaw nadpisany base URL na https://api.nanobananaapis.com/v1, wklej swój klucz i dodaj uncensored jako niestandardową nazwę modelu.

Bądź realistyczny co do tego, co Ci to daje. Edytory budują niektóre funkcje, takie jak uzupełnianie w miejscu, wokół własnych backendów i specyficznych nazw modeli, więc niestandardowy endpoint może dotyczyć tylko czatu lub podzbioru poleceń. Dokładne opcje zmieniają się między wersjami, więc sprawdź aktualną dokumentację edytora. Jeśli funkcja wymaga czegoś, czego to API nie oferuje, np. embeddingów lub obrazu wejściowego, nie zadziała przez ten endpoint.

Ten sam wzorzec dotyczy innych klientów kompatybilnych z OpenAI, takich jak Open WebUI, Continue i podobne interfejsy czatu: znajdź pole dla niestandardowego endpointu OpenAI, wpisz trzy wartości i przetestuj.

Czyste SDK i zmienne środowiskowe

Jeśli piszesz własny kod, oficjalne SDK odczytują standardowe zmienne środowiskowe, co pozwala przełączać endpointy bez dotykania plików źródłowych. W SDK Python i Node ustawienie OPENAI_BASE_URL i OPENAI_API_KEY wystarczy.

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", ...)

Jawny klient w Node wygląda tak:

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 ?? "");
}

Strumieniowanie przychodzi przez SSE z raportem użycia na końcu. Pełne szczegóły parametrów są na stronie dokumentacji, a artykuł o generowaniu promptów pokazuje, jak połączyć krok tekstowy z potokiem obrazowym.

Poprawianie typowych błędów

ObjawPrawdopodobna przyczynaNaprawa
401 NieautoryzowanyBłędny klucz lub brak Bearer w nagłówkuSkopiuj ponownie klucz i przetestuj za pomocą curl
404 Nie znalezionoBase URL bez /v1 lub podwojona ścieżkaUżyj dokładnie https://api.nanobananaapis.com/v1
Model nie znalezionyDomyślne narzędzie używa nazwy modelu dostawcyUstaw model na uncensored
429 z rate_limitedPowyżej 300 zapytań na minutę (60 na próbnym)Zwolnij i spróbuj ponownie
429 z concurrencyWięcej niż 8 zapytań naraz (2 przy kredycie próbnym)Obniż równoległość
429 z Retry-After: 5Tymczasowe przeciążeniePoczekaj pięć sekund i wyślij ponownie
Zapytanie zbyt dużeTreść powyżej 8 MBObetnij załączniki lub historię

Pamiętaj, że strumieniowane zapytanie zajmuje slot równoległości do końca strumieniowania, więc edytor, który porzuca strumienie, może wyglądać na przekraczający limit, gdy nie jest obciążony. Zaloguj nagłówek X-Request-Id z nieudanych wywołań; to pierwsza rzecz, o którą poprosi wsparcie.

Jeśli chodzi o koszt, typowa wiadomość czatu o długości 2000 tokenów na wejściu i 500 na wyjściu kosztuje $0,00055 przy cenie $0,15 i $0,50 za 1 mln tokenów, a nieudane zapytania nie są rozliczane. Strona cen obejmuje doładowania od $20 do $500 oraz poziomy bonusów.

Klucze, bezpieczeństwo i kto widzi co

Każda integracja przechowuje twój klucz w jakimś miejscu, a niektóre robią to lepiej niż inne. W aplikacji desktopowej klucz znajduje się w lokalnym pliku ustawień. W narzędziu opartym na przeglądarce może być zapisany w przeglądarce. W edytorze żyje w konfiguracji aplikacji. Wiedz, którego używasz, zanim udostępnisz ekran, zatwierdzisz plik ukryty lub oddasz laptop komuś.

Kilka zasad sprawia, że to jest zarządzalne. Używaj jednego klucza na narzędzie, gdzie możesz, więc możesz zastąpić jeden bez psucia reszty. Nigdy nie wklejaj klucza w publicznym trackerze problemów pytając o pomoc; udostępnij ID zapytania zamiast tego. Jeśli klucz wycieknie, zastąp go ze strony kluczy i zaktualizuj swoje narzędzia. Prompty wysłane przez API nie są używane do trenowania, a strona prywatności opisuje resztę obsługi danych.

Jeśli hostujesz front-end dla innych ludzi, nie wysyłaj swojego klucza do przeglądarki. Postaw mały serwer między użytkownikami a API, dodaj swoje własne limity tam i trzymaj klucz na serwerze. Twoi użytkownicy dzielą się wtedy Twoimi 8 równoległymi zapytaniami, więc zaplanuj, ilu ludzi może rozmawiać jednocześnie.

Które narzędzie pasuje do jakiej pracy

Ponieważ integracja jest taka sama wszędzie, wybór narzędia sprowadza się do tego, co tworzysz.

  • SillyTavern lub podobny front-end czatu pasuje do czatu postaci, fikcji i roleplay dla dorosłych, gdzie chcesz wygładzonego interfejsu i kart postaci bez pisania kodu.
  • LangChain pasuje do potoków w kodzie: ładowarek, szablonów promptów, parserów i wieloetapowych łańcuchów. Dodaje strukturę kosztem jednej dodatkowej zależności.
  • Zwykłe wywołanie SDK pasuje do małych skryptów i usług. Jeśli Twoim zadaniem jest jeden prompt wejściowy i jedna odpowiedź wyjściowa, pakiet OpenAI sam jest mniej do utrzymania niż framework.
  • Edytor taki jak Cursor pasuje do czatu o kodzie. Sprawdź, które z jego funkcji akceptują niestandardowy endpoint przed poleganiem na nim.

Zacznij od zwykłego testu curl, potem SDK, potem dodaj framework tylko wtedy, gdy poczujesz potrzebę. Przeniesienie później jest łatwe, ponieważ trzy wartości nigdy się nie zmieniają. Na pierwsze zapytanie i pełną listę parametrów przeczytaj dokumentację.

Pytania i odpowiedzi

Jakiego adresu URL bazowego używam dla integracji nanobanana?

Użyj https://api.nanobananaapis.com/v1 z Twoim kluczem jako tokenem Bearer i uncensored jako ID modelu.

Czy to działa z SillyTavern?

Tak. SillyTavern akceptuje niestandardowy endpoint kompatybilny z OpenAI pod Chat Completion. Wprowadź base URL, klucz i ID modelu, potem połącz.

Czy mogę go używać do embeddingów lub generowania obrazów w LangChain?

Nie. API obsługuje tylko chat completions i listę modeli. Użyj innego dostawcy do embeddingów lub obrazów.

Dlaczego mój agent dostaje błędy 429?

Pełny klucz pozwala na 8 równoległych zapytań i 300 na minutę. Ogranicz liczbę równoległych wywołań i ponów próbę po krótkim oczekiwaniu.

Czy moje dane są używane do trenowania modeli?

Nie. Prompty nie są używane do trenowania.

Twój klucz jest o jeden formularz stąd

Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.

Pobierz klucz API