Skill: Nano Banana — Gerador de Imagens

Gera imagens a partir de prompts de texto usando o Nano Banana (Gemini API). Zero dependencias — usa curl + python3 (pre-instalados no macOS).

Setup (primeira vez)

Antes de gerar qualquer imagem, verificar se o arquivo .env existe em ~/.claude/skills/nanobanana-ratos/.env.

Se o .env NAO existe:

Perguntar pro usuario:

Tu ja tem uma chave da API do Google Gemini?

Se sim, cola ela aqui que eu configuro tudo pra ti.

Se nao, e so criar gratis em https://aistudio.google.com/apikey — leva 30 segundos. Nao precisa de cartao de credito.

Quando o usuario fornecer a chave:

1. Criar o arquivo ~/.claude/skills/nanobanana-ratos/.env com:

GEMINI_API_KEY=chave-que-o-usuario-passou

2. Confirmar:

Pronto! Chave salva em ~/.claude/skills/nanobanana-ratos/.env. Vamos testar?

Se o .env JA existe:

Carregar a chave com:

bash
1source ~/.claude/skills/nanobanana-ratos/.env

Seguir direto pra geracao.

Como gerar uma imagem

1. Carregar a chave

bash
1source ~/.claude/skills/nanobanana-ratos/.env

2. Montar o prompt

Escrever um prompt descritivo em ingles. Ser especifico sobre:

• Estilo (realistic photo, flat illustration, 3D render, watercolor, etc)
• Composicao (close-up, wide shot, centered, top-down, etc)
• Cores e iluminacao (warm tones, soft lighting, high contrast, etc)
• Contexto e elementos visuais

3. Chamar a API e salvar a imagem

bash
1curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-image:generateContent?key=$GEMINI_API_KEY" \
2  -H "Content-Type: application/json" \
3  -d '{
4    "contents": [{"parts": [{"text": "PROMPT_AQUI"}]}],
5    "generationConfig": {
6      "responseModalities": ["TEXT", "IMAGE"]
7    }
8  }' | python3 -c "
9import sys, json, base64
10r = json.load(sys.stdin)
11parts = r.get('candidates', [{}])[0].get('content', {}).get('parts', [])
12for part in parts:
13    if 'inlineData' in part:
14        with open('ARQUIVO_SAIDA', 'wb') as f:
15            f.write(base64.b64decode(part['inlineData']['data']))
16        print('Imagem salva: ARQUIVO_SAIDA')
17        break
18else:
19    print('Erro: nenhuma imagem na resposta')
20    print(json.dumps(r, indent=2)[:500])
21"

Substituir:

• PROMPT_AQUI — prompt descritivo em ingles
• ARQUIVO_SAIDA — caminho do arquivo (ex: ./minha-imagem.png)

4. Mostrar pro usuario

Depois de salvar, usar o Read pra mostrar a imagem gerada pro usuario.

Fallback: Pollinations (sem API key)

Se o usuario nao tiver API key e quiser gerar algo rapido, usar Pollinations (gratis, sem cadastro):

bash
1curl -L "https://image.pollinations.ai/prompt/PROMPT_URL_ENCODED?width=1024&height=1024&nologo=true" -o ARQUIVO_SAIDA

Qualidade inferior ao Gemini, mas funciona sem nada configurar.

Opcoes avancadas

Aspect ratio

Adicionar dentro de generationConfig:

json
1"imageConfig": {"aspectRatio": "16:9"}

Opcoes: 1:1 (padrao), 16:9, 9:16, 4:3, 3:4

Modelos

O padrao e o gemini-2.5-flash-image porque funciona no free tier sem cartao de credito. Se o usuario tiver billing configurado no Google Cloud, trocar pra gemini-3.1-flash-image-preview (melhor qualidade).

Loop de melhoria (agentico)

Se o usuario nao gostar do resultado, o Claude pode:

1. Analisar a imagem gerada (usar Read pra ver)
2. Identificar o que melhorar
3. Refinar o prompt
4. Gerar de novo

Basta pedir: "melhora essa imagem" ou "tenta de novo com mais detalhe".

Regras

1. SEMPRE rodar source ~/.claude/skills/nanobanana-ratos/.env antes de qualquer chamada
2. Prompt SEMPRE em ingles (resultados muito melhores)
3. Salvar no diretorio atual ou onde o usuario pedir
4. Mostrar o caminho do arquivo salvo e usar Read pra exibir a imagem
5. Se a API retornar erro, mostrar a mensagem completa
6. Se o usuario pedir multiplas imagens, rodar em paralelo
7. NUNCA expor a chave da API em output pro usuario — so referenciar o .env
8. Se der erro de quota (429), sugerir esperar 1 minuto ou usar Pollinations como alternativa