Nano Banana 2 API
Genera imágenes a partir de texto con Nano Banana 2 mediante la API independiente de GoEnhance. Elige una relación de aspecto admitida y un tamaño de salida de 0.5K–4K, y luego consulta el estado o recibe callbacks con el resultado. GoEnhance no es Google, y este endpoint no es la API oficial de Gemini de Google.
Crear una API Key
Generación flexible de texto a imagen
Control del prompt y de la salida
Envía model con el valor nano-banana-2 y un prompt de 1–2000 caracteres. Elige una relación de aspecto documentada, un tamaño de salida y, si quieres, la profundidad de razonamiento.
Entrega asíncrona de la tarea
Un envío correcto devuelve img_uuid. Consulta GET /api/v1/jobs/detail mediante polling o indica una URL de callback HTTPS de acceso público para recibir las actualizaciones de estado.
Verifica el ID exacto del modelo y los campos documentados antes de enviar una tarea de generación.
Parámetros de la API de Nano Banana 2
Modelo
Obligatorio. Define <code>model</code> exactamente como <code>nano-banana-2</code>.
Prompt
Descripción de texto obligatoria, de 1 a 2000 caracteres.
Relación de aspecto
Parámetro opcional <code>ratio</code>. Los valores admitidos son auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 4:5, 5:4, 21:9, 1:4, 4:1, 1:8 y 8:1.
Tamaño de imagen
El parámetro opcional <code>image_size</code> tiene como valor predeterminado <code>1k</code>; los valores disponibles son <code>0.5k</code>, <code>1k</code>, <code>2k</code> y <code>4k</code>.
Controles de generación
Entre los controles opcionales están <code>web_search</code> y los valores de <code>thinking_level</code>, que distinguen mayúsculas y minúsculas: <code>High</code> o <code>Minimal</code>.
Autorización y callback
Envía la cabecera <code>Authorization</code>. La <code>custom_callback_url</code> opcional debe ser una URL HTTPS de acceso público.
El precio se aplica por imagen generada y varía según el tamaño de salida solicitado.
Precios y comportamiento de las tareas de la API de Nano Banana 2
Precios de 0.5K y 1K
0.5K cuesta 3 tokens ($0.060) por imagen. 1K cuesta 3,3 tokens ($0.066) por imagen.
Precios de 2K y 4K
2K cuesta 5 tokens ($0.100) por imagen. 4K cuesta 7,5 tokens ($0.150) por imagen.
Resultado asíncrono
El envío devuelve <code>img_uuid</code>, no la imagen final. Consulta el endpoint de detalle de la tarea o gestiona los eventos de callback para obtener el resultado definitivo.
Integra Nano Banana 2 en tres pasos
1
1. Envía una solicitud de generación
Haz un POST de JSON a
https://api.goenhance.ai/api/v1/images/generations con la autorización, model, prompt y los campos opcionales de relación, tamaño, búsqueda web, razonamiento o callback. 2
2. Guarda el img_uuid
Lee
data.img_uuid en la respuesta correcta y asócialo con la solicitud de tu aplicación. 3
3. Consulta el estado o recibe callbacks
Consulta
GET /api/v1/jobs/detail mediante polling o procesa los eventos de callback. GoEnhance documenta hasta tres reintentos de callback cuando tu endpoint no devuelve HTTP 200, con un tiempo de espera de tres segundos por intento.Crea flujos controlados de generación de imágenes mientras tu aplicación gestiona los prompts, la revisión, el almacenamiento y la entrega.
Casos de uso de la API de Nano Banana 2
Ilustración editorial
Convierte briefings de artículos estructurados en imágenes candidatas para una cola de revisión humana.
Narrativa de producto
Genera conceptos de escena a partir de descripciones de producto para una revisión posterior de marca y cumplimiento.
Variantes de campaña
Crea variantes de prompt y de relación de aspecto mientras haces seguimiento de cada tarea asíncrona por separado.
Flujos de localización
Produce conceptos visuales específicos por región a partir de prompts localizados, sin cambiar tu arquitectura de gestión de tareas.
Desarrollo de conceptos
Explora personajes, atrezo, entornos y direcciones artísticas antes de fijar los recursos de producción.
Pipelines creativos automatizados
Conecta los callbacks con servicios de moderación, aprobación, almacenamiento o procesamiento posterior de recursos.
Respuestas prácticas sobre precios, parámetros, entrega asíncrona y la relación con la API de Google.