Guía de la API de Nano Banana: Generación y edición de imágenes a través de TokenLab

La API de Nano Banana proporciona a los desarrolladores capacidades de generación y edición de imágenes de alto rendimiento, accesibles directamente a través de la capa de API unificada de TokenLab. Esta guía demuestra cómo autenticarse, estructurar cargas útiles (payloads) e integrar estos flujos de trabajo de generación de imágenes en sus aplicaciones de producción.

Puntos clave

• La API de Nano Banana se especializa en la generación rápida de imágenes y tareas de edición precisas.
• TokenLab simplifica la integración al proporcionar un SDK único y facturación unificada para múltiples proveedores de modelos.
• Las estructuras de carga útil requieren dimensiones, formatos de prompt y parámetros de intensidad específicos para obtener un resultado óptimo.
• Los desarrolladores pueden comparar el rendimiento y las métricas de precios de Nano Banana frente a otros modelos estándar de la industria directamente en TokenLab.

¿Qué es la API de Nano Banana?

La API de Nano Banana es una interfaz especializada diseñada para la generación y manipulación de imágenes de baja latencia. Está dirigida a desarrolladores que requieren prototipado rápido y flujos de trabajo de producción escalables sin la carga de gestionar modelos de difusión autohospedados. Al enrutar las solicitudes a través de TokenLab, los desarrolladores pueden acceder a este modelo junto con un conjunto más amplio de herramientas.

Al evaluar la mejor API de modelos de imagen de IA en 2026, los desarrolladores suelen comparar Nano Banana con modelos más grandes como Stable Diffusion XL o Midjourney. Si bien esos modelos ofrecen resultados de alta fidelidad para prompts complejos, Nano Banana se centra en la velocidad de ejecución y la eficiencia de costos. Puede revisar las especificaciones técnicas y la disponibilidad de este modelo en el directorio de modelos de TokenLab (observado el 07-07-2026).

Autenticación y configuración a través de TokenLab

Para interactuar con la API de Nano Banana, debe enrutar sus solicitudes a través de la puerta de enlace de TokenLab. Esto requiere una clave de API y un cliente HTTP estándar. La siguiente lista de verificación describe los pasos necesarios para preparar su entorno de desarrollo.

Lista de verificación de integración

• Cree una cuenta de desarrollador activa en TokenLab.
• Genere una clave de API de producción desde el panel de control de TokenLab.
• Guarde la clave de API como una variable de entorno llamada TOKENLAB_API_KEY.
• Instale una biblioteca de cliente HTTP como requests en Python o axios en Node.js.
• Verifique el saldo de su cuenta o la configuración de facturación para garantizar llamadas a la API sin interrupciones.

Una vez que haya completado estos pasos, configure su cliente para que apunte al endpoint de TokenLab. La URL base para todas las solicitudes es https://api.tokenlab.sh/v1, y la clave de API debe pasarse en el encabezado de autorización.

# Ejemplo de comando curl para verificar la autenticación
curl -X GET "https://api.tokenlab.sh/v1/models" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Implementación de la generación de imágenes con la API de Nano Banana

La generación de texto a imagen es el punto de entrada principal para la API de Nano Banana. La API acepta una carga útil JSON que contiene el prompt de texto, las dimensiones deseadas y los parámetros de inferencia.

Para comprender cómo se comparan los costos operativos de Nano Banana con otros modelos, consulte la guía de comparación de precios de TokenLab. Debido a que los precios de los modelos pueden cambiar según las actualizaciones del proveedor, los lectores deben verificar los precios actuales en la fuente vinculada.

El script de Python a continuación demuestra cómo enviar una solicitud de texto a imagen a la API de Nano Banana a través de TokenLab.

import os
import requests
import json

def generate_image(prompt, width=512, height=512):
    api_key = os.getenv("TOKENLAB_API_KEY")
    if not api_key:
        raise ValueError("La variable de entorno TOKENLAB_API_KEY no está configurada.")

    url = "https://api.tokenlab.sh/v1/images/generations"
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
    
    payload = {
        "model": "nano-banana",
        "prompt": prompt,
        "width": width,
        "height": height,
        "num_inference_steps": 30,
        "guidance_scale": 7.5,
        "response_format": "url"
    }

    response = requests.post(url, headers=headers, json=payload)
    
    if response.status_code == 200:
        data = response.json()
        return data["data"][0]["url"]
    else:
        raise Exception(f"Error de API {response.status_code}: {response.text}")

# Ejemplo de uso
if __name__ == "__main__":
    prompt_text = "Un retrato de estudio minimalista de un jarrón de cerámica sobre una mesa de madera"
    try:
        image_url = generate_image(prompt_text)
        print(f"URL de la imagen generada: {image_url}")
    except Exception as e:
        print(f"La generación falló: {e}")

Al estructurar sus prompts, utilice sustantivos descriptivos y concretos. La API de Nano Banana procesa los pesos de los prompts de forma secuencial, lo que significa que los términos colocados al principio del prompt ejercen una mayor influencia en el resultado final que los términos colocados al final.

Flujos de trabajo de edición de imágenes e inpainting

Más allá de la generación estándar de texto a imagen, la API de Nano Banana admite modificaciones de imagen a imagen e inpainting localizado. Estos flujos de trabajo requieren una imagen de origen inicial y, en el caso del inpainting, una máscara en blanco y negro que indique la región a modificar.

Para ejecutar una tarea de imagen a imagen, debe proporcionar la imagen de origen como una cadena codificada en base64 o una URL accesible públicamente. El parámetro strength determina cuánto altera el modelo la imagen original. Un valor de intensidad de 0.0 deja la imagen de origen sin cambios, mientras que un valor de 1.0 descarta por completo la estructura original en favor del nuevo prompt.

# Estructura conceptual de carga útil para edición de imagen a imagen
edit_payload = {
    "model": "nano-banana",
    "prompt": "Añadir un cielo azul con nubes blancas suaves",
    "image": "data:image/jpeg;base64,...", # Imagen de origen codificada en base64
    "strength": 0.6,
    "guidance_scale": 8.0
}

Para tareas de inpainting, la imagen de la máscara debe coincidir con las dimensiones de la imagen de origen. Los píxeles blancos en la máscara representan las áreas que se volverán a dibujar, mientras que los píxeles negros permanecen bloqueados. Este enfoque es altamente efectivo para aplicaciones de comercio electrónico, como cambiar el fondo de la foto de un producto manteniendo el producto intacto.

Para comenzar a integrar este modelo en su stack, comience hoy con TokenLab.

Comparación de Nano Banana con APIs alternativas

La selección del modelo correcto depende de los requisitos específicos de su aplicación con respecto a la latencia, la calidad de salida y el costo. La siguiente tabla compara la API de Nano Banana con otros modelos destacados disponibles en la industria.

Modelo / API	Caso de uso principal	Fortaleza clave	Fuente de referencia de precios
API de Nano Banana	Generación y edición rápida de imágenes	Baja latencia, estructura de carga útil simple	Modelos de TokenLab (observado el 07-07-2026)
Google Gemini (Imagen)	Tareas multimodales y generación de alta resolución	Seguridad empresarial, integración con el ecosistema de Google	Precios de Google AI (observado el 07-07-2026)
Stable Diffusion	Generación altamente personalizable	Flexibilidad de código abierto, soporte para LoRA personalizado	Categoría de imagen de TokenLab

Para los desarrolladores que crean sistemas complejos, comparar enrutadores de API también es un paso crítico. Puede leer nuestra comparación de OpenRouter para comprender cómo las puertas de enlace de API de múltiples proveedores gestionan el enrutamiento y la conmutación por error.

Si su aplicación requiere capacidades más allá de las imágenes estáticas, es posible que desee revisar la mejor API de modelos de video de IA en 2026 o explorar los mejores modelos de IA para programación en 2026 para respaldar sus flujos de trabajo de desarrollo.

Compare modelos de imagen en TokenLab para encontrar el equilibrio óptimo de velocidad, costo y calidad para su aplicación.

Preguntas frecuentes

¿Cuál es la resolución máxima admitida por la API de Nano Banana?

La API de Nano Banana admite de forma nativa resoluciones de hasta 1024x1024 píxeles. Si bien puede solicitar relaciones de aspecto no cuadradas como 16:9 o 4:3, mantener el recuento total de píxeles cerca de la resolución nativa ayuda a prevenir artefactos visuales como sujetos duplicados.

¿Cómo maneja TokenLab los límites de tasa para la API de Nano Banana?

TokenLab gestiona los límites de tasa dinámicamente según el nivel de su cuenta. Si su aplicación excede las solicitudes permitidas por minuto, la API devuelve un código de estado 429 Too Many Requests. Se recomienda implementar un retroceso exponencial (exponential backoff) en su cliente HTTP para manejar estos límites correctamente.

¿Puedo usar Nano Banana para aplicaciones comerciales?

Sí, las imágenes generadas a través de la API de Nano Banana mediante TokenLab generalmente están autorizadas para uso comercial. Sin embargo, los desarrolladores deben asegurarse de que sus prompts de entrada e imágenes de origen no violen la propiedad intelectual de terceros ni las políticas de uso aceptable de la plataforma.