Skip to main content
POST
Aviso de compatibilidad de nombres de modelo: Esta interfaz también admite el alias nano-banana-pro-ext, equivalente a gemini-3-pro-image-preview; ambos son intercambiables y producen los mismos resultados.

Autorizaciones

string
requerido
Todas las API requieren autenticación con Bearer TokenObtener API Key:Visite la página de gestión de API Keys para obtener su API KeyAñadir al encabezado de la solicitud:

Body

string
predeterminado:"gemini-3-pro-image-preview"
requerido
Nombre del modelo de generación de imágenesModelos compatibles:
  • gemini-3-pro-image-preview - Versión estándar (alias compatible nano-banana-pro-ext)
  • gemini-3-pro-image-preview-official - Versión oficial (alias compatible nano-banana-pro)
Ejemplo: "gemini-3-pro-image-preview" o "gemini-3-pro-image-preview-official"
Para mantener la compatibilidad con llamadas anteriores, los alias nano-banana-pro-ext (corresponde a gemini-3-pro-image-preview) y nano-banana-pro (corresponde a gemini-3-pro-image-preview-official) siguen estando disponibles.
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de imagen.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
requerido
Descripción textual para la generación de la imagen
string
Tamaño de generación de la imagenFormatos compatibles:
  • Proporciones: auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
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.
integer
Número de imágenes a generarRango: 1Predeterminado: 1⚠️ Nota: Debe ser un número puro (p. ej. 1), no añada comillas o se producirá un error
string
Resolución de la imagen de salidaValores compatibles:
  • 1K - Resolución 1K (predeterminado)
  • 2K - Resolución 2K
  • 4K - Resolución 4K
⚠️ Nota: Generar imágenes 4K en formato base64 toma más tiempo de procesamiento
boolean
predeterminado:"false"
Si se debe usar el canal oficial como fallback
  • false: No usar (predeterminado)
  • true: Usar el canal oficial
Cuando se usa el canal oficial (gemini-3-pro-image-preview-official), este parámetro no puede usarse.
array
Lista de URLs de imágenes de referencia para imagen a imagen o edición de imagen💡 Relleno rápido (área Try it):
  1. Haga clic en ”+ Add an item” para añadir una URL de imagen
  2. Introduzca la URL completa de la imagen o los datos base64
Límite: Máximo 14 imágenes

Response

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