Skip to main content
POST
Aviso de compatibilidade de nome de modelo: esta interface também é compatível com o alias nano-banana-2-ext, que é equivalente a gemini-3.1-flash-image-preview; ambos podem ser usados de forma intercambiável e produzem o mesmo resultado.

Autorizações

string
obrigatório
Todos os endpoints da API requerem autenticação por Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:

Body

string
padrão:"gemini-3.1-flash-image-preview"
obrigatório
Nome do modelo de geração de imagensModelos suportados:
  • gemini-3.1-flash-image-preview - Versão padrão (alias compatível nano-banana-2-ext)
  • gemini-3.1-flash-image-preview-official - Versão oficial (alias compatível nano-banana-2)
Exemplo: "gemini-3.1-flash-image-preview" ou "gemini-3.1-flash-image-preview-official"
Para compatibilidade com chamadas de versões anteriores, os aliases nano-banana-2-ext (correspondente a gemini-3.1-flash-image-preview), nano-banana-2 (correspondente a gemini-3.1-flash-image-preview-official) continuam podendo ser usados normalmente.
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de imagem.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição textual para a geração da imagem
string
Proporção da imagemProporções suportadas:
  • auto - Escolhe automaticamente a proporção
  • 1:1 - Quadrado, avatares, redes sociais
  • 3:2 / 2:3 - Fotos padrão
  • 4:3 / 3:4 - Proporção tradicional de telas
  • 16:9 / 9:16 - Widescreen / capas de vídeos verticais
  • 5:4 / 4:5 - Imagens para Instagram
  • 21:9 - Banner ultrawide
  • 1:4 / 4:1 - Pôsteres longos / banners
  • 1:8 / 8:1 - Imagens extremamente alongadas / anúncios em banner
Para geração a partir de texto, quando size é auto, o padrão é 1:1 ou 16:9; para geração a partir de imagem, a proporção segue a resposta do upstream. Recomendamos especificar uma proporção explicitamente.
string
padrão:"1K"
Resolução da imagem de saídaValores suportados:
  • 0.5K - ~512px, prévia em baixa resolução
  • 1K - ~1024px, resolução padrão (padrão)
  • 2K - ~2048px, alta resolução
  • 4K - ~4096px, resolução ultra alta
Observação: Resoluções diferentes têm preços diferentes. 4K custa mais do que 1K.
integer
Número de imagens a serem geradasIntervalo: 1Padrão: 1⚠️ Observação: Deve ser um número puro (ex.: 1), não use aspas, caso contrário ocorrerá um erro
boolean
padrão:"false"
Se deve usar o fallback do canal oficial
  • false: Não usar (padrão)
  • true: Usar o canal oficial
Ao usar o canal oficial (gemini-3.1-flash-image-preview-official), este parâmetro não pode ser utilizado.
array
Lista de URLs de imagens de referência para geração a partir de imagemDois formatos são suportados:1. URL completo da imagem
  • URL de imagem publicamente acessível (http:// ou https://)
  • Exemplo: https://example.com/image.jpg
2. Formato Base64
  • Deve usar o formato Data URI completo
  • Formato: data:image/{format};base64,{base64data}
  • Formatos de imagem suportados: jpeg, png, webp
  • Exemplo: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Observação: É necessário incluir o prefixo data:image/jpeg;base64,
Limitações:
  • Máximo de 14 imagens de referência (recomendado: até 10 referências de objetos + 4 referências de personagens)
  • Tamanho de uma única imagem: não exceder 10 MB
  • Formatos suportados: jpeg, png, webp
Ativar aprimoramento por busca textual no Google
  • true: O modelo buscará informações textuais na web para auxiliar a geração da imagem, adequado para cenários que exigem informações do mundo real
  • false: Desativado (padrão)
Ativar aprimoramento por busca de imagens no Google
  • true: Além da busca textual, também buscará imagens de referência para auxiliar a geração, adequado para cenários que exigem referências visuais
  • false: Desativado (padrão)
Observação: Deve ser usado em conjunto com google_search: true

Response

integer
Código de status da resposta
array
Array de dados da resposta