> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Generación de imágenes con Gemini 3.1 Flash

Genera imágenes a partir de prompts de texto usando el modelo Gemini 3.1 Flash Image Preview. Admite tamaños de imagen, relaciones de aspecto y profundidad de razonamiento configurables para obtener resultados de generación de mayor calidad.

## Encabezados de solicitud

<ParamField header="Content-Type" type="string" required={true}>
  Valores de enumeración: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticación Bearer: Bearer \{\{Clave de API}}.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="size" type="string" default="1K">
  Dimensiones en píxeles de la imagen de salida (ancho\*alto). 0.5K (512px) solo está disponible para Gemini 3.1 Flash.

  Valores opcionales: `0.5K`, `1K`, `2K`, `4K`
</ParamField>

<ParamField body="google" type="object">
  Opciones de búsqueda de Google

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="web_search" type="boolean" default={false}>
      Habilita la búsqueda web de Google para generar imágenes más precisas basadas en información del mundo real.
    </ParamField>

    <ParamField body="image_search" type="boolean" default={false}>
      Habilita la búsqueda de imágenes de Google para usar imágenes reales como referencia visual para la generación.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Prompt de texto que describe la imagen que se desea generar
</ParamField>

<ParamField body="aspect_ratio" type="string" default="1:1">
  Relación de aspecto de la imagen generada.

  Valores opcionales: `1:1`, `1:4`, `1:8`, `2:3`, `3:2`, `3:4`, `4:1`, `4:3`, `4:5`, `5:4`, `8:1`, `9:16`, `16:9`, `21:9`
</ParamField>

<ParamField body="output_format" type="string" default="image/png">
  Tipo MIME de la imagen de salida; admite los formatos PNG y JPEG.

  Valores opcionales: `image/png`, `image/jpeg`
</ParamField>

## Información de respuesta

<ResponseField name="image_urls" type="string[]" required={true}>
  Lista de URL de las imágenes generadas
</ResponseField>

<ResponseField name="grounding_metadata" type="object" required={false}>
  Metadatos de grounding del modelo. Se devuelven cuando se invocan herramientas del servidor de Google (por ejemplo, búsqueda). Nota: la invocación de herramientas depende de Google. Habilitar herramientas mediante parámetros no garantiza al 100 % que se active una llamada a herramientas.
</ResponseField>