> ## 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.

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

Edita imágenes mediante indicaciones en lenguaje natural con el modelo Gemini 3.1 Flash. Admite imágenes codificadas como URL y Base64 como entrada, y permite enviar hasta 14 imágenes de referencia.

## Encabezados de la solicitud

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

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

## Cuerpo de la solicitud

<ParamField body="size" type="string" default="1K">
  Dimensiones en píxeles de la imagen de salida. 0.5K (aprox. 512px), 1K (aprox. 1024px), 2K (aprox. 2048px), 4K (aprox. 4096px). El valor predeterminado es 1K

  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}>
  Indicación de texto que describe el efecto de edición de imagen deseado
</ParamField>

<ParamField body="image_urls" type="string[]">
  Lista de URL de imágenes de entrada utilizadas para la edición. Admite hasta 14 imágenes de referencia

  Longitud del array: 0 - 14
</ParamField>

<ParamField body="aspect_ratio" type="string">
  Relación de aspecto de la imagen de salida. Admite proporciones estándar y nuevas proporciones ultraanchas/ultralargas (1:4, 4:1, 1:8, 8:1)

  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="image_base64s" type="string[]">
  Lista de imágenes codificadas en Base64 utilizadas para la edición. La cantidad total de image\_urls e image\_base64s no debe superar 14

  Longitud del array: 0 - 14
</ParamField>

<ParamField body="output_format" type="string" default="image/png">
  Tipo MIME de la imagen de salida. Formatos admitidos: image/png, image/jpeg. El valor predeterminado es image/png

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

## Información de la respuesta

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

<ResponseField name="grounding_metadata" type="object" required={false}>
  Metadatos de grounding del modelo. Se devuelven cuando se invocan herramientas del lado 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 invocación de herramientas.
</ResponseField>
