Skip to main content
POST
Aviso de compatibilidad de nombres de modelo: gemini-3.1-flash-lite-image admite el alias nano-banana-2-lite, y gemini-3.1-flash-lite-image-ext admite el alias nano-banana-2-lite-ext; cada nombre y su alias son equivalentes e intercambiables.

Autorizaciones

string
requerido
Todos los endpoints de la API requieren autenticación con Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala al encabezado de la solicitud:

Body

string
predeterminado:"gemini-3.1-flash-lite-image"
requerido
Nombre del modelo de generación de imágenesSe admiten los siguientes nombres de modelo:
  • gemini-3.1-flash-lite-image (Nano Banana Lite, alias compatible nano-banana-2-lite)
  • gemini-3.1-flash-lite-image-ext (alias compatible nano-banana-2-lite-ext)
Ambos tienen los mismos parámetros y restricciones (solo 1K, no admiten google_search / official_fallback, hasta 14 imágenes de referencia). Ninguno tiene variante -official ni admite el parámetro de respaldo official_fallback. La facturación depende de la configuración del backend de cada canal.Los alias nano-banana-2-lite (correspondiente a gemini-3.1-flash-lite-image) y nano-banana-2-lite-ext (correspondiente a gemini-3.1-flash-lite-image-ext) son equivalentes a sus nombres originales respectivos y pueden usarse de forma intercambiable.
string
requerido
Descripción textual para la generación de la imagen
string
Proporción de la imagenProporciones compatibles:
  • auto - Elige automáticamente la proporción
  • 1:1 - Cuadrada, avatares, redes sociales
  • 3:2 / 2:3 - Fotografías estándar
  • 4:3 / 3:4 - Proporción de pantalla tradicional
  • 16:9 / 9:16 - Pantalla panorámica / portadas de video vertical
  • 5:4 / 4:5 - Imágenes de Instagram
  • 21:9 - Banner ultra panorámico
En texto a imagen, cuando size es auto, el valor predeterminado es 1:1 o 16:9; en imagen a imagen, la proporción sigue la respuesta del upstream. Se recomienda especificar una proporción.
string
predeterminado:"1K"
Resolución de la imagen de salidaValores compatibles:
  • 1K - ~1024px, resolución estándar (Lite solo admite esta opción)
Lite solo admite 1K. Enviar 2K / 4K / 0.5K se degrada silenciosamente a 1K, sin generar error ni producir realmente una resolución más alta. La interfaz de usuario no necesita exponer la opción de resolución.
integer
predeterminado:"1"
Número de imágenes a generarRango: 1 ~ 4, predeterminado 1Cuando n>1, el backend realiza varias solicitudes concurrentes al upstream y factura según el número de imágenes realmente generadas con éxito. Se recomienda enviar siempre 1 desde el frontend (muestra el progreso imagen por imagen y una facturación más clara).⚠️ Nota: Debe introducirse como número puro (p. ej., 1), no use comillas o se producirá un error
array
Lista de URLs de imágenes de referencia para generación de imagen a imagenSe admiten dos formatos:1. URL completa de la imagen
  • URL de imagen accesible públicamente (http:// o https://)
  • Ejemplo: https://example.com/image.jpg
2. Formato codificado en Base64
  • Debe usar el formato completo Data URI
  • Formato: data:image/{格式};base64,{base64数据}
  • Formatos de imagen compatibles: jpeg, png, webp
  • Ejemplo: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Nota: Debe incluir el prefijo data:image/jpeg;base64,
Limitaciones:
  • Máximo 14 imágenes de referencia (recomendado: hasta 10 referencias de objeto + 4 de personaje)
  • Tamaño por imagen: no debe superar 10MB
  • Formatos compatibles: jpeg, png, webp
string
Dirección de callback de la tarea (base)Cuando la tarea tiene éxito o falla, la plataforma llama a webhook + /callback (no reenvía al upstream). Enviar este parámetro reduce significativamente el sondeo; aun así se recomienda mantener el sondeo como respaldo.
Puntos clave de uso de Lite
  • No admite google_search / google_image_search: Lite usa el endpoint interactions de la Developer API, y el upstream no habilita la herramienta Search (devuelve “Search as tool is not enabled for this model”); el adaptador de la plataforma tampoco envía ese parámetro. Enviarlo no genera error y la imagen se genera con normalidad, pero sin ningún efecto de mejora por búsqueda. Si necesita mejora por búsqueda, use gemini-3.1-flash-image-preview.
  • No admite el repintado parcial con mask_url (la serie Gemini usa aspect ratio + imágenes de referencia, no máscaras).
  • Facturación por token (a diferencia del precio fijo por imagen de flash/pro): entrada ~0.25pormilloˊndetokens,salidadeimagen 0.25 por millón de tokens, salida de imagen ~30 por millón de tokens; una imagen 1K ≈ 1120 tokens de salida ≈ $0.0336 por imagen. El precio real depende de la configuración de multiplicador del backend.
  • Todas las imágenes generadas incluyen la marca de agua invisible SynthID de Google (comportamiento del upstream, no se puede desactivar).

Response

integer
Código de estado de la respuesta
array
Array de datos de la respuesta