Nano Banana Pro OpenRouter

Visão Geral

Gere ou edite imagens com OpenRouter usando o modelo google/gemini-3-pro-image-preview. Suporta geração apenas com prompt, edições de imagem única e composição de múltiplas imagens.

Geração apenas com prompt

uv run {baseDir}/scripts/generate_image.py \
  --prompt "A cinematic sunset over snow-capped mountains" \
  --filename sunset.png

Editar uma imagem única

uv run {baseDir}/scripts/generate_image.py \
  --prompt "Replace the sky with a dramatic aurora" \
  --input-image input.jpg \
  --filename aurora.png

Compor múltiplas imagens

uv run {baseDir}/scripts/generate_image.py \
  --prompt "Combine the subjects into a single studio portrait" \
  --input-image face1.jpg \
  --input-image face2.jpg \
  --filename composite.png

Resolução

• Use --resolution com 1K, 2K ou 4K.
• O padrão é 1K se não especificado.

Personalização do prompt do sistema

A habilidade lê um prompt de sistema opcional de assets/SYSTEM_TEMPLATE. Isso permite que você personalize o comportamento de geração de imagem sem modificar o código.

Comportamento e restrições

• Aceita até 3 imagens de entrada através de --input-image repetido.
• --filename aceita caminhos relativos (salva no diretório atual) ou caminhos absolutos.
• Se várias imagens forem retornadas, anexe -1, -2, etc. ao nome do arquivo.
• Imprima MEDIA: <path> para cada imagem salva. Não leia imagens de volta na resposta.

Solução de problemas

Se o script sair com um código diferente de zero, verifique o stderr em relação aos bloqueadores comuns:

Para erros transitórios (HTTP 429, timeouts de rede), tente novamente uma vez após 30 segundos. Não tente o mesmo erro mais de duas vezes — apresente o problema ao usuário em vez disso.