Skip to main content
POST
Aviso de compatibilidade de nome de modelo: esta interface também é compatível com o alias nano-banana-ext, que é equivalente a gemini-2.5-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-2.5-flash-image-preview"
obrigatório
Nome do modelo de geração de imagensModelos suportados:
  • gemini-2.5-flash-image-preview - Versão padrão (alias compatível nano-banana-ext)
  • gemini-2.5-flash-image-preview-official - Versão oficial (alias compatível nano-banana)
Exemplo: "gemini-2.5-flash-image-preview" ou "gemini-2.5-flash-image-preview-official"
Para compatibilidade com chamadas de versões anteriores, os aliases nano-banana-ext (correspondente a gemini-2.5-flash-image-preview), nano-banana (correspondente a gemini-2.5-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 imagemMáximo de 1000 caracteres
string
Tamanho da imagem geradaFormatos suportados:
  • Proporção: auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
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:
  • 1K - Resolução 1K (padrão)
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-2.5-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 imagem ou edição de imagem💡 Preenchimento rápido (área “Try it”):
  1. Clique em ”+ Add an item” para adicionar uma URL de imagem
  2. Insira o endereço de URL completo da imagem ou os dados em base64
Limite: Máximo de 14 imagens

Response

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