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

# Geração de imagens com Gemini 3.1 Flash

Use o modelo Gemini 3.1 Flash Image Preview para gerar imagens a partir de prompts de texto. Compatível com dimensões de imagem, proporção e profundidade de raciocínio configuráveis para obter resultados de geração de maior qualidade.

## 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 (largura\*altura). 0.5K (512px) está disponível apenas para Gemini 3.1 Flash.

  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}>
      Ative 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}>
      Ative a pesquisa de imagens do Google para usar 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 a imagem a ser gerada
</ParamField>

<ParamField body="aspect_ratio" type="string" default="1:1">
  Proporção da imagem gerada.

  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="output_format" type="string" default="image/png">
  Tipo MIME da imagem de saída, com suporte aos formatos PNG e JPEG.

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

## Informações da resposta

<ResponseField name="image_urls" type="string[]" required={true}>
  Lista de URLs das imagens geradas
</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. Habilitar o parâmetro de ferramenta não garante 100% que a chamada da ferramenta será acionada.
</ResponseField>