Nanobanana 2 Lite - Geração de Imagens
O Nanobanana 2 Lite para Geração de Imagens é exposto aqui como um endpoint da API EvoLink com uma skill de agente instalável correspondente.
Quando Ativar Esta Skill
Ative esta skill quando o usuário pedir para:
- Usar o Nanobanana 2 Lite para Geração de Imagens
- Executar o Nanobanana 2 Lite para Geração de Imagens via EvoLink
- Gerar uma saída do modelo
- Testar o fluxo da API
Palavras-chave: nanobanana-2-lite-image-generation, evolink, api, agent, skill
Localização do Script
IMPORTANTE: Todos os caminhos de script neste arquivo são relativos ao diretório que contém este arquivo SKILL.md. Antes de executar qualquer script, resolva o caminho absoluto:
SKILL_DIR = diretório que contém este arquivo SKILL.md
Script = {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh
Por exemplo, se este SKILL.md estiver em ~/.claude/skills/nanobanana-2-lite-image/SKILL.md, então o script estará em ~/.claude/skills/nanobanana-2-lite-image/scripts/nanobanana-2-lite-image.sh.
Após a Instalação
Quando esta skill for carregada pela primeira vez, cumprimente o usuário proativamente e inicie a configuração:
-
Verifique se
EVOLINK_API_KEYestá definida (execute:echo $EVOLINK_API_KEY)- Se não estiver definida: "Para executar o modelo, você precisará de uma chave de API EvoLink. Acesse https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image, crie uma chave e cole-a aqui. Eu a definirei para esta sessão."
- Se já estiver definida: "Tudo pronto! O que você gostaria de fazer com o Nanobanana 2 Lite para Geração de Imagens?"
-
Só isso. Uma pergunta. O usuário agora está no fluxo.
NÃO liste recursos, mostre um menu ou despeje instruções. Apenas faça uma pergunta para avançar.
Princípios Fundamentais
- Guie, não decida — Apresente opções e deixe o usuário decidir. Não faça suposições sobre suas preferências.
- Deixe o usuário conduzir — Se ele tiver uma ideia, use as palavras dele. Se precisar de inspiração, ofereça sugestões e deixe-o escolher ou refinar.
- Consciência de contexto inteligente — Reconheça o que o usuário já forneceu e pergunte apenas sobre o que está faltando.
- Intenção primeiro — Se a intenção do usuário não estiver clara, confirme o que ele deseja antes de prosseguir.
Fluxo
Passo 1: Verificar Chave de API
Se o usuário não forneceu uma chave de API ou não definiu EVOLINK_API_KEY:
- Diga a ele que precisa de uma chave de API EvoLink
- Oriente-o a acessar https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image e obter uma chave no painel
- Assim que ele fornecer uma chave, prossiga para o Passo 2
Se a chave já estiver definida ou fornecida, pule diretamente para o Passo 2.
Passo 2: Entender a Intenção
Avalie o que o usuário deseja com base na mensagem dele:
- Intenção clara (ex.: "Execute o Nanobanana 2 Lite para Geração de Imagens com um prompt curto") -> Vá para o Passo 3
- Intenção ambígua (ex.: "Quero testar") -> Pergunte o que ele gostaria de fazer.
Passo 3: Coletar Informações Faltantes
Verifique o que o usuário já forneceu e pergunte apenas sobre o que está faltando:
| Parâmetro | O que dizer ao usuário | Obrigatório? |
|---|---|---|
| TBD | TBD | Sim |
| TBD | TBD | Sim |
| TBD | TBD | Opcional |
| TBD | TBD | Opcional |
Regras rígidas de coleta inteligente:
- Pergunte TODOS os parâmetros faltantes em UMA ÚNICA mensagem. Nunca divida em várias rodadas de perguntas.
- Nunca pergunte a mesma coisa duas vezes. Se o usuário já respondeu um parâmetro, ele é definitivo — não pergunte novamente.
- Ofereça valores padrão antecipadamente para que o usuário possa dizer "o padrão está bom":
model=gemini-3.1-flash-lite-image, prompt='Crie uma demonstração curta'. Se o usuário disser "padrão" ou "pode ir", use esses valores imediatamente. - Usuário fornece tudo de uma vez -> Confirme e execute o modelo imediatamente, sem mais perguntas.
- Usuário fornece informações parciais -> Pergunte apenas os campos obrigatórios restantes, tudo em uma mensagem.
- Parâmetros opcionais têm valores padrão sensatos — se o usuário os pular, use os padrões e prossiga.
Passo 4: Executar
Assim que todas as informações necessárias forem confirmadas:
- Antes de executar o script, avise imediatamente o usuário: "Entendido! Executarei o Nanobanana 2 Lite para Geração de Imagens através do EvoLink."
- Execute o script uma vez. NUNCA execute uma segunda vez a menos que o usuário peça explicitamente para tentar novamente.
- Quando terminar, compartilhe o resultado e o tempo decorrido.
Padrão de Execução por Agente
Claude Code — use a ferramenta Bash com run_in_background: true, depois leia o arquivo de saída para verificar o progresso:
# Passo 1: Executar em background (primeiro resolve SKILL_DIR)
Bash(command: "{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh \"input\" --dry-run true", run_in_background: true, timeout: 300000)
# Passo 2: Aguardar ~30 segundos, depois ler o arquivo de saída da tarefa em background para verificar linhas RESULT_URL= ou STATUS_UPDATE
# Passo 3: Quando vir RESULT_URL=<valor>, repasse ao usuário
OpenClaw / OpenCode / Cursor — execute o script como um comando shell bloqueante (o script lida com sua própria espera interna, normalmente conclui em 2-10 minutos):
EVOLINK_API_KEY=$EVOLINK_API_KEY {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "input" --dry-run true
Todos os agentes — regras críticas:
- Assim que você vir
TASK_SUBMITTED:na saída, a tarefa já está na fila do servidor. NÃO execute o script novamente — repetir gasta créditos de API do usuário. - O script bloqueia até a tarefa ficar pronta (até 5 minutos). NÃO o mate prematuramente.
- Se o script exceder o tempo limite com
POLL_TIMEOUT, a tarefa ainda pode estar sendo processada — diga ao usuário para verificar em https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image.
Uso do Script
Lembre-se: Substitua {SKILL_DIR} pelo diretório real que contém este arquivo SKILL.md.
# Definir chave de API
export EVOLINK_API_KEY=sua_chave_aqui
# Básico
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Crie uma demonstração curta do Nanobanana 2 Lite para Geração de Imagens"
# Com opções
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Prompt de teste" --dry-run true --timeout TBD
# Avançado
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Execução de teste" --help TBD
# Execução de teste (visualizar payload sem chamar a API)
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Teste" --dry-run
Protocolo de Saída do Script
O script escreve linhas estruturadas na saída padrão que você deve analisar e processar:
| Formato da linha | Quando | Sua ação |
|---|---|---|
TASK_SUBMITTED: task_id=<id> estimated=<Ns> | Imediatamente após a submissão | Confirme ao usuário que a tarefa foi iniciada. Isso significa que a chamada à API foi bem-sucedida — NÃO tente novamente. |
STATUS_UPDATE: <mensagem> | A cada ~15s durante a execução | Repasse ao usuário — ex.: "Ainda processando, cerca de 30 segundos restantes..." |
RESULT_URL=<valor> | Em caso de sucesso | Extraia e apresente ao usuário |
ELAPSED=<Ns> | Em caso de sucesso | Opcionalmente, mencione quanto tempo levou |
POLL_TIMEOUT: task_id=<id> dashboard=<url> | Espera excedeu 5 min | Diga ao usuário: "Sua tarefa pode já estar concluída — verifique em <dashboard_url> (tarefa: <id>)" |
ERROR: ... (stderr) | Em caso de falha | Exiba a mensagem de erro ao usuário |
Crítico: Assim que você vir TASK_SUBMITTED:, a tarefa está na fila do servidor. NÃO execute o script novamente. Repetir gasta créditos de API do usuário. Se o script exceder o tempo limite localmente, a tarefa ainda pode ser concluída — diga ao usuário para verificar o painel em https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image.
Tratamento de Erros
Forneça mensagens amigáveis e acionáveis:
| Erro | O que dizer ao usuário |
|---|---|
| Chave inválida/ausente (401) | "Sua chave de API parece não funcionar. Você pode verificá-la em https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image" |
| Saldo insuficiente (402) | "Seu saldo está baixo. Você pode adicionar créditos em https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image" |
| Limite de taxa excedido (429) | "Muitas requisições — vamos aguardar um momento e tentar novamente" |
| Conteúdo bloqueado (400) | "Esta entrada foi sinalizada pela moderação de conteúdo. Tente ajustá-la" |
| Serviço indisponível (503) | "O serviço está temporariamente ocupado. Vamos tentar novamente em um minuto" |
Resumo das Capacidades do Modelo
Use isto quando o usuário perguntar o que o modelo pode fazer:
- Início rápido da API: Crie uma tarefa, aguarde a conclusão e inspecione a resposta final.
- Skill de Agente: Use SKILL.md mais scripts para orientar a execução do agente.
- Solução de Problemas: Use docs/errors.md e exemplos completos para depurar falhas comuns.
- Preparação para Lançamento: Mantenha os metadados do pacote consistentes antes do lançamento público.
Referências
references/api-params.md: Referência completa dos parâmetros da APIscripts/nanobanana-2-lite-image.sh: Execute uma tarefa de Geração de Imagens Nanobanana 2 Lite através do EvoLink.