Los tres valores que necesita toda integración
Casi toda la guía sobre integración de la API de nanobanana se reduce a rellenar los mismos tres campos en lugares distintos. El servicio usa el protocolo de chat-completions de OpenAI, por lo que una herramienta que te permita anular el endpoint de OpenAI puede hablar con él.
| Campo | Valor |
|---|---|
| URL base | https://api.nanobananaapis.com/v1 |
| Clave de API | Tu clave, enviada como Authorization: Bearer <key> |
| ID del modelo | uncensored |
Una nota de alcance antes de empezar. Esto es un modelo de lenguaje de texto, por lo que no funcionará en lugares que esperen generación de imágenes, voz o incrustaciones. Los métodos admitidos son POST /v1/chat/completions y GET /v1/models. Si una herramienta pide un modelo de incrustaciones para búsqueda, apunta esa parte a otro proveedor.
Obtienes una clave desde la página de clave de API. Las cuentas nuevas pueden reclamar $0,50 de crédito de prueba con un clic, sin tarjeta, válido por 7 días.
Prueba el endpoint antes de tocar cualquier herramienta
Cuando una integración falla, la gente culpa a la herramienta. La mayoría de las veces la clave o la URL están mal. Una prueba de curl de treinta segundos elimina esa duda. Primero lista los modelos:
curl https://api.nanobananaapis.com/v1/models -H "Authorization: Bearer YOUR_API_KEY"
Luego envía una solicitud de chat corta:
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}'
Si ambas funcionan, el endpoint y la clave están bien, y cualquier error posterior proviene de cómo está configurada una herramienta. Si la primera llamada devuelve 401, la clave está mal o le falta la palabra Bearer en el encabezado. Un 404 suele significar que la URL le falta /v1 o tiene una ruta extra.
SillyTavern
SillyTavern es una interfaz para roleplay y chat de personajes, y te permite añadir un endpoint compatible con OpenAI. Las etiquetas del menú cambian entre versiones, así que trata los pasos como un mapa en lugar de texto exacto.
- Abre el panel de conexión API y elige Completado de Chat como tipo de API.
- Selecciona la fuente Personalizada (compatible con OpenAI).
- Pega
https://api.nanobananaapis.com/v1como URL del endpoint. - Pega tu clave en el campo de clave.
- Introduce
uncensoredcomo nombre de modelo, o presiona el botón conectar y selecciónalo de la lista queGET /v1/modelsdevuelve. - Presiona conectar y envía un mensaje de prueba.
Dos notas de ajuste. SillyTavern envía historiales largos con tarjetas de personaje, así que vigila la ventana de contexto de 100.000 tokens, que se comparte entre prompt y respuesta. Y si usas chats grupales que disparan varias solicitudes a la vez, recuerda el límite de 8 peticiones simultáneas en una clave completa (2 en una clave de prueba). Las configuraciones de roleplay y compañero son para adultos; el modelo no producirá contenido sexual que involucre menores de edad bajo ningún prompt.
LangChain
En Python, el paquete langchain-openai proporciona ChatOpenAI, que acepta una URL base personalizada. Instálalo con 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)
Las cadenas, plantillas de prompt y analizadores de salida funcionan igual después, ya que solo les importa la interfaz de chat. La llamada a funciones sigue la ruta estándar, por lo que llm.bind_tools([...]) envía tools en la petición. Prueba una llamada a herramienta única antes de construir un agente alrededor de ella, y limita la paralelización del agente a 8. Un gráfico que se ramifica en veinte ramas alcanzará el error de concurrency.
El paquete de JavaScript @langchain/openai toma la misma idea a través de una opción configuration: { baseURL } en ChatOpenAI.
Cursor y otros editores
Cursor, como varios editores de código, tiene un área de configuración para modelos donde puedes proporcionar tu propia clave de API de OpenAI y anular la URL base. Aproximadamente: abre la configuración de modelos, habilita la opción de clave personalizada de OpenAI, establece la URL base de anulación en https://api.nanobananaapis.com/v1, pega tu clave y añade uncensored como nombre de modelo personalizado.
Sé realista sobre lo que esto te ofrece. Los editores construyen algunas funciones, como la finalización en línea, alrededor de sus propios backends y nombres de modelos específicos, por lo que un endpoint personalizado puede aplicarse solo al chat o a un subconjunto de comandos. Las opciones exactas cambian entre versiones, así que consulta la documentación actual del editor. Si una función requiere algo que esta API no ofrece, como incrustaciones o entrada de imagen, no funcionará a través de este endpoint.
El mismo patrón se aplica a otros clientes compatibles con OpenAI como Open WebUI, Continue y interfaces de chat similares: encuentra el campo para un endpoint personalizado de OpenAI, introduce los tres valores y prueba.
SDKs básicos y variables de entorno
Si escribes tu propio código, los SDK oficiales leen variables de entorno estándar, lo que te permite cambiar endpoints sin tocar archivos de origen. En los SDK de Python y Node, configurar OPENAI_BASE_URL y OPENAI_API_KEY es suficiente.
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", ...)
Un cliente explícito en Node se ve así:
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 ?? "");
}
El streaming llega sobre SSE con el uso reportado al final. Los detalles completos de los parámetros están en la página de documentación, y el artículo sobre generación de prompts muestra cómo conectar un paso de texto a una tubería de imágenes.
Solución de fallos comunes
| Síntoma | Causa probable | Solución |
|---|---|---|
| 401 No autorizado | Clave incorrecta o falta el encabezado Bearer | Vuelve a copiar la clave y prueba con curl |
| 404 No encontrado | URL base sin /v1, o ruta duplicada | Usa exactamente https://api.nanobananaapis.com/v1 |
| Modelo no encontrado | La herramienta usa por defecto un nombre de modelo de proveedor | Establece el modelo a uncensored |
429 con rate_limited | Más de 300 peticiones por minuto (60 en prueba, 2 simultáneas) | Ralentiza y reintenta |
429 con concurrency | Más de 8 peticiones simultáneas (2 en prueba) | Reduce la paralelización |
| 429 con Retry-After: 5 | Sobrecarga temporal | Espera cinco segundos y reintenta |
| Petición demasiado grande | Cuerpo superior a 8 MB | Recorta adjuntos o historial |
Ten en cuenta que una petición en streaming mantiene su espacio de concurrencia hasta que finalice el flujo, por lo que un editor que abandone los flujos puede parecer que está alcanzando el límite cuando no está ocupado. Registra el encabezado X-Request-Id de las llamadas fallidas; es lo primero que solicitará soporte.
En cuanto al costo, un mensaje de chat típico de 2,000 tokens de entrada y 500 de salida cuesta $0.00055 a $0.15 y $0.50 por 1M de tokens, y las peticiones fallidas no se cobran. La página de precios cubre recargas desde $20 hasta $500 y los niveles de bonificación.
Claves, seguridad y quién ve qué
Cada integración almacena tu clave en algún lugar, y algunas lo hacen mejor que otras. En un front end de escritorio, la clave reside en un archivo de configuración local. En una herramienta basada en navegador, puede guardarse en el navegador. En un editor, vive en la configuración de la aplicación. Conoce cuál estás usando antes de compartir tu pantalla, hacer commit de un archivo oculto o prestar un portátil a alguien.
Algunas reglas mantienen esto manejable. Usa una clave por herramienta donde puedas, para que puedas reemplazar una sola sin romper el resto. Nunca pegues una clave en un rastreador de incidencias público cuando pidas ayuda; comparte la ID de petición en su lugar. Si una clave se filtra, reemplázala desde la página de claves y actualiza tus herramientas. Los prompts enviados a través de la API no se utilizan para entrenamiento, y la página de privacidad describe el resto del manejo de datos.
Si alojas un front end para otras personas, no envíes tu clave al navegador. Coloca un pequeño servidor entre tus usuarios y la API, añade tus propios límites allí y mantén la clave en el servidor. Tus usuarios comparten entonces tus 8 peticiones simultáneas, así que planifica cuántas personas pueden chatear a la vez.
Qué herramienta se ajusta a cada trabajo
Dado que la integración es la misma en todas partes, la elección de la herramienta depende de lo que estés creando.
- SillyTavern o un front end de chat similar se adapta al chat de personajes, ficción y juego de roles para adultos, donde deseas una interfaz pulida y tarjetas de personajes sin escribir código.
- LangChain se adapta a procesos en código: cargadores, plantillas de prompt, analizadores y cadenas de múltiples pasos. Añade estructura al costo de una dependencia adicional.
- Una llamada SDK directa se adapta a scripts pequeños y servicios. Si tu tarea es un prompt de entrada y una respuesta de salida, el paquete de OpenAI por sí solo requiere menos mantenimiento que un framework.
- Un editor como Cursor se adapta al chat sobre código. Comprueba qué características de este aceptan un endpoint personalizado antes de depender de él.
Comienza con la prueba curl directa, luego el SDK, y añade un framework solo cuando sientas la necesidad. Moverse más tarde es fácil, ya que los tres valores nunca cambian. Para una primera petición y la lista completa de parámetros, lee la documentación en docs.
