Die drei Werte, die jede Integration benötigt
Fast jeder Leitfaden zur Nanobanana-API-Integration reduziert sich darauf, dieselben drei Felder an einer anderen Stelle auszufüllen. Der Dienst spricht das OpenAI-Chat-Completions-Protokoll, daher kann ein Tool, das den OpenAI-Endpunkt überschreiben kann, damit kommunizieren.
| Feld | Wert |
|---|---|
| Base-URL | https://api.nanobananaapis.com/v1 |
| API-Schlüssel | Dein Schlüssel, gesendet als Authorization: Bearer <key> |
| Modell-ID | uncensored |
Ein kurzer Hinweis vor dem Start. Dies ist ein Text-Sprachmodell, daher funktioniert es nicht an Stellen, die Bildgenerierung, Sprache oder Embeddings erwarten. Die unterstützten Methoden sind POST /v1/chat/completions und GET /v1/models. Wenn ein Tool ein Embedding-Modell für die Suche anfordert, verweise diesen Teil auf einen anderen Anbieter.
Du erhältst einen Schlüssel von der API-Schlüssel-Seite. Neue Konten können $0,50 kostenloses Testguthaben mit einem Klick beanspruchen, ohne Karte, gültig für 7 Tage.
Teste den Endpunkt, bevor du ein Tool konfigurierst
Wenn eine Integration fehlschlägt, wird das Tool verantwortlich gemacht. Meistens ist der Schlüssel oder die URL falsch. Ein 30-Sekunden-curl-Test beseitigt diesen Zweifel. Liste zuerst die Modelle auf:
curl https://api.nanobananaapis.com/v1/models -H "Authorization: Bearer YOUR_API_KEY"
Sende dann eine kurze Chat-Anfrage:
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}'
Wenn beide funktionieren, sind Endpunkt und Schlüssel in Ordnung, und jeder spätere Fehler stammt aus der Konfiguration eines Tools. Wenn der erste Aufruf 401 zurückgibt, ist der Schlüssel falsch oder das Wort Bearer fehlt im Header. Ein 404 bedeutet normalerweise, dass die URL /v1 fehlt oder einen zusätzlichen Pfad hat.
SillyTavern
SillyTavern ist eine Benutzeroberfläche für Rollenspiel- und Charakter-Chats und ermöglicht das Hinzufügen eines OpenAI-kompatiblen Endpunkts. Die Menübezeichnungen ändern sich zwischen den Releases, betrachte die Schritte also als Karte und nicht als exakte Wortwahl.
- Öffne das API-Verbindungsfeld und wähle Chat Completion als API-Typ.
- Wähle die Quelle Custom (OpenAI-compatible).
- Füge
https://api.nanobananaapis.com/v1als Endpunkt-URL ein. - Füge deinen Schlüssel in das Schlüsselfeld ein.
- Gib
uncensoredals Modellname ein oder klicke auf Verbinden und wähle ihn aus der Liste, dieGET /v1/modelszurückgibt. - Klicke auf Verbinden und sende eine Testnachricht.
Zwei Hinweise zur Feinabstimmung. SillyTavern sendet lange Verläufe mit Charakterkarten, also achte auf das 100.000-Token-Kontextfenster, das von Prompt und Antwort gemeinsam genutzt wird. Und wenn du Gruppenchats nutzt, die mehrere Anfragen gleichzeitig auslösen, erinnere dich an das Limit von 8 parallelen Anfragen mit einem Voll-Key (2 mit einem Trial-Key). Rollenspiel- und Companion-Einrichtungen sind für Erwachsene gedacht; das Modell wird unter keinem Prompt sexuelle Inhalte mit Minderjährigen erzeugen.
LangChain
In Python bietet das Paket langchain-openai ChatOpenAI, das eine benutzerdefinierte Base URL akzeptiert. Installiere es mit 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, Prompt-Vorlagen und Output-Parsers funktionieren danach gleich, da sie nur die Chat-Schnittstelle benötigen. Tool Calling erfolgt über den Standardpfad, also sendet llm.bind_tools([...]) tools in der Anfrage. Teste einen einzelnen Tool-Aufruf, bevor du einen Agenten darum baust, und begrenze die Agenten-Parallelität auf 8. Ein Graph, der sich in zwanzig Zweige aufteilt, wird den concurrency-Fehler auslösen.
Das JavaScript-Paket @langchain/openai nutzt dieselbe Idee über eine configuration: { baseURL }-Option auf ChatOpenAI.
Cursor und andere Editoren
Cursor hat, wie einige andere Editoren, einen Einstellungsbereich für Modelle, in dem du deinen eigenen OpenAI-API-Schlüssel angeben und die Base URL überschreiben kannst. Grob: Öffne die Modelleinstellungen, aktiviere die Option für den benutzerdefinierten OpenAI-Schlüssel, setze die Base URL auf https://api.nanobananaapis.com/v1, füge deinen Schlüssel ein und füge uncensored als benutzerdefinierten Modellnamen hinzu.
Sei realistisch bezüglich dessen, was dir das bietet. Editoren bauen einige Funktionen, wie Inline-Vervollständigung, um ihre eigenen Backends und spezifische Modellnamen auf, daher gilt ein benutzerdefinierter Endpunkt möglicherweise nur für Chat oder einen Teil der Befehle. Die genauen Optionen ändern sich zwischen Versionen, also prüfe die aktuelle Dokumentation des Editors. Wenn eine Funktion etwas benötigt, das diese API nicht anbietet, wie Embeddings oder Bildeingaben, funktioniert sie nicht über diesen Endpunkt.
Dasselbe Muster gilt für andere OpenAI-kompatible Clients wie Open WebUI, Continue und ähnliche Chat-Oberflächen: Finde das Feld für einen benutzerdefinierten OpenAI-Endpunkt, gib die drei Werte ein und teste.
Einfache SDKs und Umgebungsvariablen
Wenn du eigenen Code schreibst, lesen die offiziellen SDKs Standard-Umgebungsvariablen, wodurch du Endpunkte wechseln kannst, ohne Quelldateien zu berühren. In den Python- und Node-SDKs reicht das Setzen von OPENAI_BASE_URL und OPENAI_API_KEY.
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", ...)
Ein expliziter Client in Node sieht so aus:
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 ?? "");
}
Streaming kommt über SSE, die Nutzung wird am Ende gemeldet. Vollständige Parameterdetails findest du auf der Dokumentationsseite, und der Artikel zur Prompt-Generierung zeigt, wie du einen Textschritt an eine Bildpipeline anschließt.
Häufige Fehler beheben
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| 401 Unauthorized | Falscher Schlüssel oder Header ohne Bearer | Kopiere den Schlüssel neu und teste mit curl |
| 404 Not Found | Base URL ohne /v1 oder doppelter Pfad | Verwende genau https://api.nanobananaapis.com/v1 |
| Modell nicht gefunden | Tool verwendet standardmäßig einen Vendor-Modellnamen | Setze das Modell auf uncensored |
429 mit rate_limited | Über 300 Anfragen pro Minute (60 im Trial) | Verlangsame und wiederhole |
429 mit concurrency | Mehr als 8 Anfragen gleichzeitig (2 im Trial) | Parallelität senken |
| 429 mit Retry-After: 5 | Vorübergehende Überlastung | Fünf Sekunden warten und erneut versuchen |
| Anfrage zu groß | Body über 8 MB | Anhänge oder Verlauf kürzen |
Behalte im Kopf, dass eine gestreamte Anfrage ihren Parallelitäts-Slot bis zum Ende des Streams belegt, daher kann ein Editor, der Streams verlässt, so aussehen, als würde er das Limit erreichen, obwohl er nicht beschäftigt ist. Logge den X-Request-Id-Header von fehlgeschlagenen Aufrufen; das ist das Erste, was der Support anfordern wird.
Kosten: Eine typische Chat-Nachricht mit 2.000 Input-Token und 500 Output-Token kostet $0,00055 bei $0,15 und $0,50 pro 1 Mio. Token, und fehlgeschlagene Anfragen werden nicht berechnet. Die Preisseite deckt Aufladungen von $20 bis $500 und die Bonusstufen ab.
Schlüssel, Sicherheit und wer sieht was
Jede Integration speichert deinen Schlüssel irgendwo, und einige speichern ihn besser als andere. In einer Desktop-Oberfläche liegt der Schlüssel in einer lokalen Einstellungsdatei. In einem browserbasierten Tool kann er im Browser gespeichert sein. In einem Editor lebt er in der App-Konfiguration. Denk daran, welchen du verwendest, bevor du einen Bildschirm teilst, eine Dotfile committest oder einen Laptop an jemand anderen gibst.
Einige Regeln machen das handhabbar. Nutze pro Tool, wo möglich, einen eigenen Schlüssel, damit du einen einzelnen austauschen kannst, ohne die anderen zu beeinträchtigen. Füge einen Schlüssel niemals in einen öffentlichen Issue-Tracker ein, wenn du um Hilfe bittest; teile stattdessen die Request-ID. Wenn ein Schlüssel geleakt wird, ersetze ihn über die Key-Seite und aktualisiere deine Tools. Prompts, die über die API gesendet werden, werden nicht zum Training verwendet. Die Datenschutzseite beschreibt den Rest der Datenverarbeitung.
Wenn du eine Oberfläche für andere hostest, liefere deinen Schlüssel nicht an den Browser. Platziere einen kleinen Server zwischen deinen Nutzern und der API, füge dort deine eigenen Limits hinzu und halte den Schlüssel auf dem Server. Deine Nutzer teilen sich dann deine 8 parallelen Anfragen, plane also, wie viele Personen gleichzeitig chatten können.
Welches Tool passt zu welchem Einsatz
Da die Integration überall gleich ist, hängt die Wahl des Tools davon ab, was du baust.
- SillyTavern oder ein ähnliches Chat-Frontend eignet sich für Charakter-Chat, Fiktion und Roleplay für Erwachsene, wenn du eine polierte Oberfläche und Charakterkarten möchtest, ohne Code schreiben zu müssen.
- LangChain eignet sich für Pipelines im Code: Loader, Prompt-Templates, Parser und Mehrschrittketten. Es fügt Struktur hinzu, was eine weitere Abhängigkeit kostet.
- Ein einfacher SDK-Aufruf eignet sich für kleine Skripte und Dienste. Wenn deine Aufgabe aus einem Prompt und einer Antwort besteht, ist das OpenAI-Paket allein weniger wartungsintensiv als ein Framework.
- Ein Editor wie Cursor eignet sich für Chats über Code. Prüfe, welche seiner Funktionen einen benutzerdefinierten Endpunkt akzeptieren, bevor du dich darauf verlässt.
Starte mit dem einfachen curl-Test, dann dem SDK, und füge erst ein Framework hinzu, wenn du das Gefühl hast, es zu brauchen. Ein späterer Wechsel ist einfach, da sich die drei Werte nie ändern. Lies die Dokumentation für die erste Anfrage und die vollständige Parameterliste.
