NL ▾

Ongecensureerde tekst-API voor je pipeline

Nanobanana API-integratie: SillyTavern, LangChain, Cursor

Een nanobanana api-integratie betekent hier het koppelen van een OpenAI-compatible tekst-endpoint aan de tools die je al gebruikt. Ieder van hen vereist dezelfde drie waarden: een basis-URL, een sleutel en een model ID.

Bijgewerkt

Isometrische illustratie van één hub verbonden met kabels aan een chatpaneel, een code-editor en een workflow-grafiek

Belangrijkste punten

  • De drie waarden zijn base URL https://api.nanobananaapis.com/v1, je sleutel en model ID uncensored.
  • Test eerst met curl, configureer dan SillyTavern, LangChain, Cursor of een OpenAI SDK.
  • De API is alleen tekst; deze genereert geen afbeeldingen, audio of embeddings.
  • Blijf binnen 8 gelijktijdige verzoeken met een volledige sleutel om 429-fouten van agents en extensies te voorkomen.

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.

VeldWaarde
Basis-URLhttps://api.nanobananaapis.com/v1
API-sleutelJe sleutel, verzonden als Authorization: Bearer <key>
Model-IDuncensored

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.

  1. Open het API-verbindingpaneel en kies Chat Completion als API-type.
  2. Selecteer de bron Custom (OpenAI-compatible).
  3. Plak https://api.nanobananaapis.com/v1 als de endpoint URL.
  4. Plak je sleutel in het sleutelveld.
  5. Voer uncensored in als modelnaam, of druk op de connect-knop en kies het uit de lijst die GET /v1/models retourneert.
  6. 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

SymptoomWaarschijnlijke oorzaakOplossing
401 Niet geautoriseerdVerkeerde sleutel, of header mist BearerKopieer de sleutel opnieuw en test met curl
404 Niet gevondenBase URL zonder /v1, of dubbel padGebruik precies https://api.nanobananaapis.com/v1
Model niet gevondenTool gebruikt standaard een vendor modelnaamStel het model in op uncensored
429 met rate_limitedMaximaal 300 verzoeken per minuut (60 op proef)Vertraag en probeer het opnieuw
429 met concurrencyMaximaal 8 verzoeken tegelijk (2 op proef)Beperk paralleliteit
429 met Retry-After: 5Tijdelijke overbelastingWacht vijf seconden en probeer het opnieuw
Verzoek te grootBody boven 8 MBVerwijder 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.

Vragen en antwoorden

Welke basis-URL gebruik ik voor een nanobanana-integratie?

Gebruik https://api.nanobananaapis.com/v1 met je sleutel als Bearer token en uncensored als model ID.

Werkt het met SillyTavern?

Ja. SillyTavern accepteert een aangepaste OpenAI-compatible endpoint onder Chat Completion. Voer de basis-URL, sleutel en model ID in en maak verbinding.

Kan ik het gebruiken voor embeddings of afbeeldingsgeneratie in LangChain?

Nee. De API ondersteunt alleen chat-completions en de lijst van modellen. Gebruik een andere provider voor embeddings of afbeeldingen.

Waarom krijgt mijn agent 429-fouten?

Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 per minuut toe. Beperk parallelle aanroepen en probeer het opnieuw na een korte wachttijd.

Worden mijn gegevens gebruikt om modellen te trainen?

Nee. Prompts worden niet gebruikt voor training.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de basis-URL aan. Dat is de hele configuratie.

API-sleutel aanvragen