De drie waarden die elke integratie nodig heeft
Bijna elke handleiding over nanobanana api-integratie komt neer op het invullen van dezelfde drie velden op een andere plek. De service gebruikt het OpenAI chat-completions-protocol, dus een tool die het OpenAI-endpoint kan overschrijven, kan ermee communiceren.
| Veld | Waarde |
|---|---|
| Basis-URL | https://api.nanobananaapis.com/v1 |
| API-sleutel | Je sleutel, verzonden als Authorization: Bearer <key> |
| Model-ID | uncensored |
Een belangrijke opmerking voordat je begint. Dit is een teksttaalmodel, dus het werkt niet op plekken die beeldgeneratie, spraak of embeddings verwachten. De ondersteunde methoden zijn POST /v1/chat/completions en GET /v1/models. Als een tool om een embeddings-model voor zoeken vraagt, wijs dat deel dan naar een andere provider.
Je krijgt een sleutel van de API-sleutel pagina. Nieuwe accounts kunnen met één klik $0,50 aan gratis proeftegoed claimen, zonder kaart, geldig voor 7 dagen.
Test de endpoint voordat je een tool aanraakt
Als een integratie faalt, wijzen mensen de tool de schuld. Meestal is de sleutel of URL verkeerd. Een curl-test van dertig seconden weert die twijfel. Lijst eerst de modellen:
curl https://api.nanobananaapis.com/v1/models -H "Authorization: Bearer YOUR_API_KEY"
Stuur dan een kort chat-verzoek:
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}'
Als beide werken, zijn de endpoint en de sleutel in orde, en komt elke latere fout door hoe een tool is geconfigureerd. Als de eerste aanroep 401 retourneert, is de sleutel verkeerd of mist het woord Bearer in de header. Een 404 betekent meestal dat de URL /v1 mist of een extra pad heeft.
SillyTavern
SillyTavern is een front end voor rollenspel en karaktergesprekken, en je kunt er een OpenAI-compatibel endpoint aan toevoegen. De menu-items verschillen per release, dus behandel de stappen als een kaart in plaats van exacte tekst.
- Open het API-verbindingpaneel en kies Chat Completion als API-type.
- Selecteer de bron Custom (OpenAI-compatible).
- Plak
https://api.nanobananaapis.com/v1als de endpoint URL. - Plak je sleutel in het sleutelveld.
- Voer
uncensoredin als modelnaam, of druk op de connect-knop en kies het uit de lijst dieGET /v1/modelsretourneert. - Druk op connect en stuur een testbericht.
Twee tuning-notities. SillyTavern stuurt lange gespreksgeschiedenissen met karakterkaarten, dus houd de 100.000-token contextvenster in de gaten, die gedeeld wordt door prompt en antwoord. En als je groepschats gebruikt die meerdere verzoeken tegelijk afvuren, onthoud dan de limiet van 8 gelijktijdige verzoeken op een volledige sleutel (2 op een proefsleutel). Rollenspel en companion-instellingen zijn voor volwassenen; het model zal geen seksuele inhoud genereren die minderjarigen betrekt onder welke prompt ook.
LangChain
In Python biedt het langchain-openai-pakket ChatOpenAI, dat een aangepaste basis-URL accepteert. Installeer het met 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 templates en output parsers werken daarna op dezelfde manier, omdat ze alleen geïnteresseerd zijn in de chat-interface. Tool calling gaat via het standaardpad, dus llm.bind_tools([...]) stuurt tools in het verzoek. Test een enkele tool call voordat je een agent eromheen bouwt, en beperk de paralleliteit van de agent tot 8. Een grafiek die uitwaaiert naar twintig takken raakt de concurrency-fout.
Het JavaScript-pakket @langchain/openai neemt hetzelfde idee door een configuration: { baseURL }-optie op ChatOpenAI.
Cursor en andere editors
Cursor heeft, net als enkele andere code-editors, een instellingengebied voor modellen waar je je eigen OpenAI API-sleutel kunt opgeven en de basis-URL kunt overschrijven. Ruwweg: open de modelinstellingen, schakel de optie voor een aangepaste OpenAI-sleutel in, stel de override basis-URL in op https://api.nanobananaapis.com/v1, plak je sleutel en voeg uncensored toe als een aangepaste modelnaam.
Wees realistisch over wat dit je oplevert. Editors bouwen sommige functies, zoals inline completion, rond hun eigen backends en specifieke modelnamen, dus een aangepaste endpoint geldt mogelijk alleen voor chat of een subset van commando's. De exacte opties verschillen per versie, dus raadpleeg de huidige documentatie van de editor. Als een functie iets vereist dat deze API niet biedt, zoals embeddings of image input, werkt het niet via deze endpoint.
Hetzelfde patroon geldt voor andere met OpenAI compatibele clients zoals Open WebUI, Continue en vergelijkbare chat-interfaces: zoek het veld voor een aangepast OpenAI-endpoint, voer de drie waarden in en test.
Platte SDK's en omgevingsvariabelen
Als je je eigen code schrijft, lezen de officiële SDK's standaard omgevingsvariabelen, waardoor je endpoints kunt wisselen zonder bestanden aan te passen. In de Python- en Node SDK's is het instellen van OPENAI_BASE_URL en OPENAI_API_KEY genoeg.
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", ...)
Een expliciete client in Node ziet er als volgt uit:
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 komt via SSE met verbruik gerapporteerd aan het einde. Gedetailleerde parameterinformatie staat op de docs pagina, en het artikel over prompt generatie laat zien hoe je een tekststap aan een afbeeldingspipeline koppelt.
Veelvoorkomende fouten verhelpen
| Symptoom | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
| 401 Niet geautoriseerd | Verkeerde sleutel, of header mist Bearer | Kopieer de sleutel opnieuw en test met curl |
| 404 Niet gevonden | Base URL zonder /v1, of dubbel pad | Gebruik precies https://api.nanobananaapis.com/v1 |
| Model niet gevonden | Tool gebruikt standaard een vendor modelnaam | Stel het model in op uncensored |
429 met rate_limited | Maximaal 300 verzoeken per minuut (60 op proef) | Vertraag en probeer het opnieuw |
429 met concurrency | Maximaal 8 verzoeken tegelijk (2 op proef) | Beperk paralleliteit |
| 429 met Retry-After: 5 | Tijdelijke overbelasting | Wacht vijf seconden en probeer het opnieuw |
| Verzoek te groot | Body boven 8 MB | Verwijder bijlagen of geschiedenis |
Houd er rekening mee dat een gestreamd verzoek zijn gelijktijdigheids-slot vasthoudt tot de stream eindigt, dus een editor die streams verlaat, kan lijken alsof hij de limiet raakt terwijl hij niet druk is. Log de X-Request-Id header van mislukte verzoeken; dit is het eerste waar support om zal vragen.
Wat betreft kosten kost een typisch chatbericht van 2.000 tokens in en 500 tokens uit $0,00055 bij $0,15 en $0,50 per 1M tokens, en mislukte verzoeken worden niet in rekening gebracht. De prijzenpagina behandelt het opladen van $20 tot $500 en de bonusniveaus.
Sleutels, veiligheid en wie ziet wat
Elke integratie bewaart je sleutel ergens, en sommige bewaren hem beter dan anderen. In een desktop front-end ligt de sleutel in een lokaal configuratiebestand. In een browsergebaseerde tool kan deze in de browser zijn opgeslagen. In een editor leeft hij in de app-configuratie. Weet welke je gebruikt voordat je je scherm deelt, een dotfile commit of een laptop aan iemand anders geeft.
Een paar regels houden dit beheersbaar. Gebruik één sleutel per tool waar je kunt, zodat je er één kunt vervangen zonder de rest te breken. Plak nooit een sleutel in een openbare issue tracker als je hulp vraagt; deel in plaats daarvan de verzoek-ID. Als een sleutel lekt, vervang hem dan via de sleutelpagina en update je tools. Prompts die via de API worden verzonden, worden niet gebruikt voor training, en de privacy pagina beschrijft de rest van de gegevensverwerking.
Als je een front-end voor anderen host, stuur je sleutel dan niet naar de browser. Zet een kleine server tussen je gebruikers en de API, voeg daar je eigen limieten toe en houd de sleutel op de server. Je gebruikers delen dan jouw 8 gelijktijdige verzoeken, dus plan hoeveel mensen er tegelijk kunnen chatten.
Welke tool past bij welke taak
Omdat de integratie overal hetzelfde is, komt de keuze van de tool neer op wat je maakt.
- SillyTavern of een vergelijkbaar chat front-end is geschikt voor karakterchat, fictie en roleplay voor volwassenen, waar je een gepolijste interface en karakterkaarten wilt zonder code te schrijven.
- LangChain is geschikt voor pipelines in code: loaders, prompt templates, parsers en multi-step chains. Het voegt structuur toe ten koste van één extra afhankelijkheid.
- Een gewone SDK-verzoek is geschikt voor kleine scripts en services. Als je taak uit één prompt in en één antwoord uit bestaat, is het OpenAI package alleen minder onderhoudswaardig dan een framework.
- Een editor zoals Cursor is geschikt voor chat over code. Controleer welke van zijn functies een aangepast endpoint accepteren voordat je erop leunt.
Begin met de gewone curl test, dan de SDK, en voeg pas een framework toe als je het nodig voelt. Later verplaatsen is eenvoudig, omdat de drie waarden nooit veranderen. Lees voor een eerste verzoek en de volledige parameterlijst de docs.
