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

# Edição de imagens com Gemini 3.1 Flash

Edite imagens usando o modelo Gemini 3.1 Flash com prompts em linguagem natural. Compatível com imagens em URL e codificadas em Base64 como entrada, com suporte para até 14 imagens de referência.

## Cabeçalhos da requisição

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

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticação Bearer: Bearer \{\{API Key}}.
</ParamField>

## Corpo da requisição

<ParamField body="size" type="string" default="1K">
  Dimensão em pixels da imagem de saída. 0.5K (aprox. 512px), 1K (aprox. 1024px), 2K (aprox. 2048px), 4K (aprox. 4096px). O padrão é 1K

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

<ParamField body="google" type="object">
  Opções de pesquisa do Google

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="web_search" type="boolean" default={false}>
      Ativa a pesquisa na Web do Google para gerar imagens mais precisas com base em informações do mundo real.
    </ParamField>

    <ParamField body="image_search" type="boolean" default={false}>
      Ativa a pesquisa de imagens do Google, usando imagens reais como referência visual para a geração.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Prompt de texto que descreve o efeito desejado de edição da imagem
</ParamField>

<ParamField body="image_urls" type="string[]">
  Lista de URLs das imagens de entrada a serem editadas, com suporte para até 14 imagens de referência

  Comprimento do array: 0 - 14
</ParamField>

<ParamField body="aspect_ratio" type="string">
  Proporção da imagem de saída. Compatível com proporções padrão e novas proporções ultra-largas/ultra-altas (1:4, 4:1, 1:8, 8:1)

  Valores opcionais: `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 imagens codificadas em Base64 a serem editadas. A soma de image\_urls e image\_base64s não deve exceder 14 imagens

  Comprimento do array: 0 - 14
</ParamField>

<ParamField body="output_format" type="string" default="image/png">
  Tipo MIME da imagem de saída. Formatos compatíveis: image/png, image/jpeg. O padrão é image/png

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

## Informações de resposta

<ResponseField name="image_urls" type="string[]" required={true}>
  Lista de URLs das imagens editadas
</ResponseField>

<ResponseField name="grounding_metadata" type="object" required={false}>
  Metadados de grounding do modelo. Retornados quando ferramentas do lado do servidor do Google (por exemplo, pesquisa) são chamadas. Observação: a chamada de ferramentas depende do Google. Ativar ferramentas por parâmetro não garante 100% que a chamada de ferramenta será acionada.
</ResponseField>