Generacion de imagenes Nanobanana 2 Lite
- El modelo Nano Banana 2 Lite (gemini-3.1-flash-lite-image) soporta modos de generacion de texto a imagen, imagen a imagen, edicion de imagen y otros
- Modo de procesamiento asincrono, usa el ID de tarea devuelto para consultar
- Los enlaces de imagenes generadas son validos por 24 horas, guardalos oportunamente
Autorizaciones
##Todas las APIs requieren autenticacion Bearer Token##
Obtener API Key:
Visita la Pagina de gestion de API Key para obtener tu API Key
Agregar al encabezado de la solicitud:
Cuerpo
Nombre del modelo de generacion de imagenes, canal oficial, mejor estabilidad y controlabilidad, adecuado para escenarios comerciales
gemini-3.1-flash-lite-image "gemini-3.1-flash-lite-image"
Prompt que describe la imagen a generar, o que describe como editar la imagen de entrada, limitado a 2000 tokens
2000"A cat playing in the grass"
Relacion de aspecto de la imagen generada, por defecto es auto
auto, 1:1, 1:4, 4:1, 1:8, 8:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 Calidad de la imagen generada, por defecto 1K
1K Lista de URLs de imagen de referencia para funciones de imagen a imagen y edicion de imagen
Nota:
- Una solicitud admite cantidad de imagenes de entrada:
14imagenes - Tamano de imagen: no mas de
20MB - Formatos de archivo admitidos:
.jpeg,.jpg,.png,.webp - Las URLs de imagen deben ser directamente visibles por el servidor, o la URL de imagen debe activar la descarga directa al acceder (generalmente estas URLs terminan con extensiones de archivo de imagen, como
.png,.jpg)
Parametros de extension del modelo
Direccion de callback HTTPS despues de completar la tarea
Momento del callback:
- Se activa cuando la tarea se completa, falla o se cancela
- Se envia despues de completar la confirmacion de facturacion
Restricciones de seguridad:
- Solo se admite el protocolo HTTPS
- El callback a direcciones IP internas esta prohibido (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- La longitud de la URL no debe exceder
2048caracteres
Mecanismo de callback:
- Tiempo de espera:
10segundos - Maximo
3reintentos en caso de fallo (reintentos despues de1segundo/2segundos/4segundos) - El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas
- La direccion de callback que devuelve un codigo de estado 2xx se considera exitosa, otros codigos de estado activaran reintentos
"https://your-domain.com/webhooks/image-task-completed"
Respuesta
Tarea de generacion de imagen creada exitosamente
Marca de tiempo de creacion de la tarea
1757165031
ID de tarea
"task-unified-1757165031-uyujaw3d"
Nombre del modelo real utilizado
"gemini-3.1-flash-lite-image"
Tipo de tarea especifico
image.generation.task Porcentaje de progreso de la tarea (0-100)
0 <= x <= 1000
Estado de la tarea
pending, processing, completed, failed "pending"
Informacion de tarea asincrona
Tipo de salida de la tarea
text, image, audio, video "image"
Informacion de uso y facturacion