ES ▾

API de texto sin censura para tu canalización

Cómo usar los flujos de trabajo de la API Nano Banana con un LLM de texto

Este sitio no genera imágenes. Es una API de LLM compatible con OpenAI solo de texto que la gente usa junto a herramientas de imagen para escribir prompts, descripciones y scripts. Aquí te explicamos cómo configurarla y usarla.

Actualizado

Ilustración isométrica de tarjetas de texto fluyendo hacia un marco vacío, mostrando prompts alimentando un flujo de trabajo de imagen

Puntos clave

  • La API devuelve solo texto: no genera imágenes, audio ni video.
  • Usa la URL base https://api.nanobananaapis.com/v1, el ID del modelo uncensored y una clave Bearer.
  • Un uso común es convertir ideas vagas en prompts de imagen estructurados con modo JSON.
  • El costo de entrada es $0.15 y el de salida $0.50 por 1M de tokens, y las peticiones fallidas son gratuitas.

Lee esto primero: qué es y qué no es esta API

Si llegaste aquí preguntándote cómo usar la api de nano banana para producir imágenes, la respuesta honesta es que este servicio no puede hacer esa parte. "Nano Banana" es un nombre que la gente suele asociar a un modelo de generación de imágenes, y la generación de imágenes no se ofrece aquí. Lo que nanobananaapis.com vende es acceso a un modelo de lenguaje de texto a través de un endpoint compatible con OpenAI.

Aún así, encaja en muchos flujos de trabajo de imágenes, porque las herramientas de imagen son tan buenas como el texto que les alimentas. Un modelo de texto puede escribir los prompts, variarlos, verificarlos contra una hoja de estilos, producir descripciones y texto alternativo, y redactar los scripts que unen una tubería. Esta página recorre ese uso. Si solo necesitas imágenes, quieres un servicio de imágenes en su lugar, y puedes emparejarlo con este.

El modelo es un único modelo de pesos abiertos, ejecutado por un proveedor independiente, ajustado para responder sin rechazos de contenido para uso adulto lícito. No es la API oficial de ningún proveedor grande. La única limitación estricta: no hay contenido sexual que involucre a menores de edad.

Paso 1: obtener una clave

Regístrate con Google, o con un correo electrónico y contraseña, luego abre la página de clave de API. Verás un botón de un clic para reclamar $0,50 de crédito de prueba. Es válido por 7 días, no necesita tarjeta y está limitado a uno por persona. Una clave de prueba permite 2 peticiones simultáneas y 60 peticiones por minuto, lo cual es suficiente para probar cosas.

Copia la clave y mantenla fuera de tu repositorio. En un shell puedes almacenarla así:

export NANOBANANA_KEY="paste-your-key-here"

Paso 2: envía tu primera petición

Tres valores importan: la URL base, el ID del modelo y la cabecera Authorization. Todo lo demás sigue el formato de chat-completions de OpenAI. Aquí tienes una primera llamada con curl:

curl https://api.nanobananaapis.com/v1/chat/completions   -H "Authorization: Bearer $NANOBANANA_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}
    ],
    "max_tokens": 200
  }'

Lo mismo en Python con el paquete oficial openai:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}],
)
print(r.choices[0].message.content)

Y en Node:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.nanobananaapis.com/v1",
  apiKey: process.env.NANOBANANA_KEY,
});

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write one detailed image prompt for a foggy harbor at dawn." }],
});
console.log(r.choices[0].message.content);

Comprueba las cabeceras de respuesta una vez. X-Balance-USD muestra tu crédito restante y X-Request-Id identifica la llamada si necesitas ayuda. La página de documentación lista todos los parámetros admitidos.

Paso 3: convierte ideas en prompts estructurados

El truco más útil para un flujo de trabajo de imágenes es hacer que el modelo devuelva datos estructurados en lugar de texto libre. El modo JSON hace eso. Describes el esquema en el mensaje del sistema, y la respuesta se analiza directamente en tu código, de modo que una lista de ideas aproximadas se convierte en una tabla de prompts con campos fijos.

import json, os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

SYSTEM = (
    "You write prompts for an image model. Reply with JSON only: "
    '{"prompts": [{"subject": str, "style": str, "lighting": str, "negative": str, "full": str}]}'
)

def expand(idea: str, n: int = 3):
    r = client.chat.completions.create(
        model="uncensored",
        response_format={"type": "json_object"},
        temperature=0.9,
        messages=[
            {"role": "system", "content": SYSTEM},
            {"role": "user", "content": f"Give {n} distinct prompts for: {idea}"},
        ],
    )
    return json.loads(r.choices[0].message.content)["prompts"]

for p in expand("a lighthouse keeper's kitchen in winter"):
    print(p["full"])

Aumenta la temperatura cuando quieras variedad y bájala para la consistencia. El parámetro seed se reenvía, así que puedes fijarlo cuando necesites reproducir un lote anterior. Envuelve siempre json.loads en un bloque try y reintenta la petición una vez si el análisis falla, ya que cualquier modelo de lenguaje puede fallar.

El sitio también tiene una explicación relacionada sobre el lado de las imágenes: generación de prompts y postprocesamiento. Cubre cómo la etapa de texto se conecta con un generador.

Más tareas que un modelo de texto hace bien en un flujo de trabajo de imagen

  • Hojas de estilo. Mantén un mensaje del sistema con tus reglas de estilo fijas y alimenta cada nuevo sujeto a través de él, para que toda una serie se mantenga visualmente consistente.
  • Leyendas y texto alternativo. Una vez que existen las imágenes, descríbelas con unas pocas palabras cada una. Pasa tu propia descripción de la imagen como entrada; el modelo no puede ver imágenes, porque la API solo acepta texto.
  • Listas de planos y guiones. Para un storyboard o un video corto, redacta la lista de escenas, la narración y los momentos en pantalla como texto.
  • Crítica de prompts. Pega un prompt que da malos resultados y pide tres reescrituras con los cambios explicados.
  • Ficción y trabajo de personajes para adultos. Hojas de personajes, historias previas y diálogos para historias y aplicaciones complementarias, con el modelo sin rechazar temas lícitos para adultos.

Para trabajos largos, transmite la salida con stream: true para que una interfaz de usuario pueda mostrar el texto a medida que llega. También se admiten llamadas a funciones, lo que permite que un modelo decida cuándo llamar a tu propia función, por ejemplo una que envía un prompt al servicio de imagen que usas.

Límites y costo de una ejecución

Conoce los números antes de construir un lote. Una clave completa permite 8 peticiones simultáneas y 300 peticiones por minuto. La ventana de contexto es de 100.000 tokens que cubren el prompt y el completado, el cuerpo de la petición máximo es de 8 MB, y max_tokens es opcional. Superar el límite de peticiones devuelve HTTP 429 con el código rate_limited o concurrency; espera y reintenta.

Los precios son $0.15 por 1M de tokens de entrada y $0.50 por 1M de tokens de salida. Supongamos que generas 500 conjuntos de prompts, cada uno con una entrada de 400 tokens y una salida de 600 tokens:

  • Entrada: 500 x 400 = 200.000 tokens x $0,15 / 1M = $0,03
  • Salida: 500 x 600 = 300.000 tokens x $0,50 / 1M = $0,15
  • Total: $0,18

Así que el crédito de prueba de $0,50 cubre aproximadamente 1.300 conjuntos de ese tamaño. Para uso regular, recarga cualquier cantidad entera de $20 a $500, con cripto (USDT en TRC20, USDC en Base). Los bonos son del 5% desde $50, del 10% desde $100 y del 15% desde $200. Consulta la página de precios para la tabla. El crédito no caduca.

Emparejarlo con un servicio de imagen

La configuración habitual tiene dos etapas. La etapa de texto usa esta API para producir prompts. La etapa de imagen envía esos prompts a cualquier generador de imágenes que uses, y ese generador tiene su propia cuenta, sus propios precios y sus propias reglas, que debes leer en su sitio. Mantén las dos etapas en funciones separadas, para que puedas cambiar cualquiera de los dos lados sin reescribir el otro.

Un consejo práctico: guarda cada prompt junto con la semilla y la temperatura que usaste para crearla. Cuando una imagen sale bien, puedes rastrearla hasta el texto exacto que la produjo, y cuando un lote decepciona, puedes ver si la culpa fue de la idea, del escritor de prompts o del modelo de imagen. También te da una forma barata de comparar dos mensajes del sistema ejecutando ambos en la misma lista de ideas y juzgando los dos conjuntos de prompts lado a lado.

Un script pequeño de extremo a extremo

Para unir las piezas, aquí tienes un script corto que lee un archivo de ideas aproximadas, expande cada una en prompts con modo JSON y escribe el resultado en un archivo que tu herramienta de imágenes puede leer. Maneja un modo de fallo que de otro modo te morderá: la respuesta que no es JSON válido.

import json, os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

def one(idea: str):
    for _ in range(2):
        r = client.chat.completions.create(
            model="uncensored",
            response_format={"type": "json_object"},
            messages=[
                {"role": "system", "content": 'Reply with JSON only: {"prompt": str}'},
                {"role": "user", "content": f"Write a vivid, specific image prompt for: {idea}"},
            ],
            max_tokens=250,
        )
        try:
            return json.loads(r.choices[0].message.content)["prompt"]
        except (json.JSONDecodeError, KeyError):
            continue
    return None

ideas = [line.strip() for line in open("ideas.txt") if line.strip()]
out = {i: one(i) for i in ideas}
json.dump(out, open("prompts.json", "w"), indent=2)

Ejecútalo en cinco ideas primero y lee los resultados a ojo. Ajusta el mensaje del sistema hasta que los prompts coincidan con el estilo que deseas, luego escala. Como cada petición aquí es pequeña, mil ideas terminan rápido y cuestan centavos.

Errores comunes de principiantes

  • Esperando imágenes. La respuesta es siempre texto. Si tu código intenta guardar una imagen binaria de la respuesta, fallará, porque no hay ninguna.
  • Buscando un nombre de modelo diferente. Hay un modelo, y su ID es uncensored. Copiar un nombre de modelo de proveedor de un tutorial da un error de no encontrado.
  • Olvidando el mensaje del sistema. Sin él, el modelo no tiene guía de estilo y se desvía entre prompts cortos y largos. Pon tus reglas allí.
  • Enviando secretos en prompts. Los prompts no se usan para entrenamiento, pero aún así deberías evitar pegar contraseñas o claves privadas en cualquier entrada de modelo.
  • Ejecutando cien peticiones a la vez. Una clave completa permite 8 a la vez. Usa un pool o un semáforo, y añade un reintento para 429.

Si algo se comporta de forma extraña, la página de soporte es el lugar para preguntar, y el ID de petición de los encabezados de respuesta hace que la pregunta sea mucho más fácil de responder.

Preguntas y respuestas

¿Puede esta API generar imágenes Nano Banana?

No. Es una API de LLM solo de texto. Puede escribir prompts, descripciones y guiones para flujos de trabajo de imágenes, pero no genera imágenes, audio ni video.

¿Qué pongo como nombre del modelo?

Usa uncensored como ID del modelo, con la URL base https://api.nanobananaapis.com/v1 y tu clave como token Bearer.

¿Puedo probarlo sin pagar?

Sí. Los nuevos usuarios pueden reclamar $0.50 de crédito de prueba con un clic en la página de la clave de API. No requiere tarjeta y es válido por 7 días.

¿El modelo ve mis imágenes?

No. Solo lee texto. Si necesitas ayuda con una imagen, descríbela en tu mensaje.

¿Se utilizan mis prompts para el entrenamiento?

No. Los prompts no se utilizan para entrenamiento.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.

Obtener clave de API