Gerar Nanobanana

Visão Geral

generate-nanobanana chama os modelos de mídia Gemini do Google diretamente através da API Gemini — sem camada de roteamento de terceiros — para gerar e editar imagens e vídeos. Ele roteia cada solicitação para o nível de modelo correto (rascunho, padrão, qualidade ou vídeo), carrega imagens de referência reais em vez de depender de descrições de texto, bloqueia cada chamada paga atrás de aprovação explícita do usuário e grava um arquivo lateral JSON ao lado de cada saída registrando o prompt exato, o modelo e o custo. Ele registra um único comando /generate.

Esta habilidade adapta o fluxo de trabalho (roteamento de modelo, tratamento de imagem de referência, registro de arquivo lateral) de AntonioCardenas/generate-nanobanana. As formas de solicitação reais em references/ foram verificadas independentemente contra a documentação da API Gemini ativa em vez de serem copiadas desse repositório upstream, cujos exemplos precedem a migração do Google para a API de Interações e usam métodos de solicitação desatualizados e não funcionais. IDs de modelo, contratos de solicitação e preços mudam de acordo com a programação do próprio Google — verifique novamente contra a documentação vinculada de cada arquivo de referência antes de confiar nesta habilidade em uma nova sessão.

Quando Usar Esta Habilidade

• Use quando o usuário pedir para gerar, criar ou fazer uma imagem ou vídeo, ou quiser uma miniatura.
• Use quando o usuário quiser animar uma imagem estática, ou disser "gerar com a marca" ou "gerar a partir de referência".
• Use quando o usuário quiser vincular ou importar uma pasta de imagens de referência (logotipos, rostos, fotos de produtos) para reutilização em gerações.
• Use quando o usuário invocar /generate ou /generate frf <set>, mesmo sem nomear um modelo específico.

Como Funciona

Etapa 1: Roteamento para um modelo

Escolha o modelo para o trabalho e leia seu arquivo de referência em references/ antes de chamar qualquer coisa — cada arquivo contém a forma de solicitação atual e verificada para esse modelo.

Todos os quatro modelos são chamados através da API de Interações (client.interactions.create(...), REST POST /v1beta/interactions) — veja cada arquivo de referência para a forma exata, incluindo entrada de imagem de referência e, para vídeo, recuperação de saída grande. Cada chamada é faturável; veja a Etapa 3.

Comece com o rascunho no Nano Banana 2 Lite e execute o favorito escolhido no Nano Banana 2 ou Pro; reserve o Pro para fusão pesada multi-imagem, séries consistentes de personagens ou texto denso na imagem.

Etapa 2: Carregar referências

Puxe imagens de referência reais de generations/refs/, ou de um conjunto de referência nomeado quando a solicitação disser "com a marca" ou invocar /generate frf <set>. Nunca substitua uma descrição de texto por uma imagem de referência (logotipo, rosto, marca) que já existe — pare e pergunte se uma referência nomeada está faltando em vez de aproximá-la.

Conjuntos de referência são registrados importando (copiando arquivos para generations/refs/<set>/, um snapshot) ou vinculando (registrando o caminho de origem em generations/refs/sets.json, lido em tempo real na geração). Um conjunto pode carregar um style.md cujos conteúdos são prefixados textualmente a cada prompt gerado a partir desse conjunto.

Etapa 3: Gerar

Chame a API Gemini de acordo com o arquivo de referência do modelo. Cada geração — imagem ou vídeo — é faturável e requer um portão de aprovação explícito: cite o preço atual por unidade da página de preços ativa para o modelo selecionado e obtenha a aprovação explícita do usuário antes dessa chamada específica. Uma aprovação cobre exatamente uma chamada; uma nova execução requer a sua própria. Execute as gerações uma de cada vez, nunca em paralelo, para que o rastreamento de aprovação e custo permaneça preciso.

…