Nano Banana 2 – Geração e Edição de Imagens
Gere novas imagens ou edite imagens existentes usando a API Nano Banana 2 do Google (Gemini 3.1 Flash Image).
Uso
Execute o script usando o caminho absoluto (NÃO entre no diretório da skill antes):
Gerar nova imagem:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "sua descrição da imagem" --filename "nome-da-saida.png" [--resolution 512|1K|2K|4K] [--api-key KEY]
Editar imagem existente:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "instruções de edição" --filename "nome-da-saida.png" --input-image "caminho/para/imagem.png" [--resolution 512|1K|2K|4K] [--api-key KEY]
Importante: Sempre execute a partir do diretório de trabalho atual do usuário para que as imagens sejam salvas onde o usuário está trabalhando, e não no diretório da skill.
Fluxo de Trabalho Padrão (rascunho → iterar → final)
Objetivo: iteração rápida sem gastar tempo em 4K até que o prompt esteja correto.
- Rascunho (1K): ciclo de feedback rápido
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<prompt do rascunho>" --filename "aaaa-mm-dd-hh-mm-ss-rascunho.png" --resolution 1K
- Iterar: ajuste o prompt com pequenas diferenças; mantenha um novo nome de arquivo a cada execução
- Se for edição: mantenha o mesmo
--input-imagea cada iteração até ficar satisfeito.
- Se for edição: mantenha o mesmo
- Final (4K): somente quando o prompt estiver pronto
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<prompt final>" --filename "aaaa-mm-dd-hh-mm-ss-final.png" --resolution 4K
Opções de Resolução
A API Gemini 3.1 Flash Image suporta estes valores de tamanho de saída:
- 512 – compacto, resolução ~512px
- 1K (padrão) – resolução ~1024px
- 2K – resolução ~2048px
- 4K – resolução ~4096px
Mapeie as solicitações do usuário para os parâmetros da API:
- "512", "512px", "0.5K", "miniatura", "pequeno" →
512 - Sem menção de resolução →
1K - "baixa resolução", "1080", "1080p", "1K" →
1K - "2K", "2048", "normal", "resolução média" →
2K - "alta resolução", "alta-res", "hi-res", "4K", "ultra" →
4K
Chave da API
O script verifica a chave da API nesta ordem:
- Argumento
--api-key(use se o usuário forneceu a chave no chat) - Variável de ambiente
GEMINI_API_KEY
Se nenhuma estiver disponível, o script sai com uma mensagem de erro.
Verificação Prévia + Falhas Comuns (correções rápidas)
-
Verificação prévia:
command -v uv(deve existir)test -n "$GEMINI_API_KEY"(ou passe--api-key)- Se edição:
test -f "caminho/para/imagem.png"
-
Falhas comuns:
Error: No API key provided.→ definaGEMINI_API_KEYou passe--api-keyError loading input image:→ caminho errado / arquivo ilegível; verifique se--input-imageaponta para uma imagem real- Erros de API do tipo "quota/permission/403" → chave errada, sem acesso ou cota excedida; tente outra chave/conta
Geração de Nomes de Arquivo
Gere nomes de arquivo com o padrão: aaaa-mm-dd-hh-mm-ss-nome.png
Formato: {timestamp}-{nome-descritivo}.png
- Timestamp: Data/hora atual no formato
aaaa-mm-dd-hh-mm-ss(formato 24h) - Nome: Texto descritivo em minúsculas com hífens
- Mantenha a parte descritiva concisa (normalmente 1 a 5 palavras)
- Use o contexto do prompt ou da conversa do usuário
- Se não estiver claro, use um identificador aleatório (ex.:
x9k2,a7b3)
Exemplos:
- Prompt "Um jardim japonês sereno" →
2025-11-23-14-23-05-jardim-japones.png - Prompt "pôr do sol sobre montanhas" →
2025-11-23-15-30-12-por-sol-montanhas.png - Prompt "crie uma imagem de um robô" →
2025-11-23-16-45-33-robo.png - Contexto não claro →
2025-11-23-17-12-48-x9k2.png
Edição de Imagens
Quando o usuário deseja modificar uma imagem existente:
- Verifique se ele forneceu um caminho de imagem ou fez referência a uma imagem no diretório atual
- Use o parâmetro
--input-imagecom o caminho para a imagem - O prompt deve conter instruções de edição (ex.: "deixe o céu mais dramático", "remova a pessoa", "mude para estilo cartoon")
- Tarefas comuns de edição: adicionar/remover elementos, mudar estilo, ajustar cores, desfocar fundo, etc.
Tratamento de Prompts
Para geração: Passe a descrição da imagem do usuário diretamente em --prompt. Só reformule se estiver claramente insuficiente.
Para edição: Passe as instruções de edição em --prompt (ex.: "adicione um arco-íris no céu", "faça parecer uma pintura em aquarela")
Preserve a intenção criativa do usuário em ambos os casos.
Modelos de Prompt (alta taxa de acerto)
Use modelos quando o usuário for vago ou quando as edições precisarem ser precisas.
-
Modelo de geração:
- "Crie uma imagem de: . Estilo: . Composição: <câmera/enquadramento>. Iluminação: <iluminação>. Fundo: . Paleta de cores: . Evite: ."
-
Modelo de edição (preserve todo o resto):
- "Altere APENAS: <única alteração>. Mantenha idênticos: assunto, composição/corte, pose, iluminação, paleta de cores, fundo, texto e estilo geral. Não adicione novos objetos. Se houver texto, mantenha-o inalterado."
Saída
- Salva PNG no diretório atual (ou no caminho especificado se o nome do arquivo incluir diretório)
- O script exibe o caminho completo da imagem gerada
- Não leia a imagem de volta – apenas informe ao usuário o caminho salvo
Exemplos
Gerar nova imagem:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "Um jardim japonês sereno com cerejeiras" --filename "2025-11-23-14-23-05-jardim-japones.png" --resolution 4K
Editar imagem existente:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "deixe o céu mais dramático com nuvens de tempestade" --filename "2025-11-23-14-25-30-ceu-dramatico.png" --input-image "foto-original.jpg" --resolution 2K