Communitygithub.com

Nanobanana 2 Lite - Geração de Imagens via EvoLink

Exemplos de uso da API de geração de imagens Nanobanana 2 Lite e skill instalável para agentes EvoLink.

O que é Nanobanana 2 Lite - Geração de Imagens via EvoLink?

Esta skill permite que agentes de IA, como Claude Code ou Cursor, utilizem o modelo Nanobanana 2 Lite para gerar imagens através da plataforma EvoLink. Ela fornece um fluxo completo: verificação de chave de API, coleta inteligente de parâmetros e execução do script de geração. O processo é otimizado para evitar perguntas repetitivas e desperdício de créditos, garantindo que o agente pergunte apenas o necessário em uma única mensagem. A skill suporta execução em background para agentes como Claude Code (com polling do arquivo de saída) ou execução síncrona para Cursor/OpenClaw. Ela trata erros comuns como chave inválida, saldo insuficiente ou limite de taxa, fornecendo mensagens amigáveis ao usuário. O script de geração segue um protocolo de saída estruturado, facilitando o monitoramento do progresso da tarefa.

Funciona com✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add Evolink-AI/nanobanana-2-lite-image-generate-api-skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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:

  1. Verifique se EVOLINK_API_KEY está definida (execute: echo $EVOLINK_API_KEY)

  2. 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

  1. Guie, não decida — Apresente opções e deixe o usuário decidir. Não faça suposições sobre suas preferências.
  2. 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.
  3. Consciência de contexto inteligente — Reconheça o que o usuário já forneceu e pergunte apenas sobre o que está faltando.
  4. 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:

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âmetroO que dizer ao usuárioObrigatório?
TBDTBDSim
TBDTBDSim
TBDTBDOpcional
TBDTBDOpcional

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:

  1. 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."
  2. Execute o script uma vez. NUNCA execute uma segunda vez a menos que o usuário peça explicitamente para tentar novamente.
  3. 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:

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 linhaQuandoSua ação
TASK_SUBMITTED: task_id=<id> estimated=<Ns>Imediatamente após a submissãoConfirme 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çãoRepasse ao usuário — ex.: "Ainda processando, cerca de 30 segundos restantes..."
RESULT_URL=<valor>Em caso de sucessoExtraia e apresente ao usuário
ELAPSED=<Ns>Em caso de sucessoOpcionalmente, mencione quanto tempo levou
POLL_TIMEOUT: task_id=<id> dashboard=<url>Espera excedeu 5 minDiga ao usuário: "Sua tarefa pode já estar concluída — verifique em <dashboard_url> (tarefa: <id>)"
ERROR: ... (stderr)Em caso de falhaExiba 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:

ErroO 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 API
  • scripts/nanobanana-2-lite-image.sh: Execute uma tarefa de Geração de Imagens Nanobanana 2 Lite através do EvoLink.

Habilidades Relacionadas