Integração com n8n

Imagens e vídeo dentro do n8n Gere, aguarde, baixe, publique — em um único workflow

Conecte o n8n ao BananaBanana com uma única chave de API e chame Nano Banana, Veo, Gemini Omni, Wan, Grok Imagine, GPT Image, Qwen e Gemini TTS nos seus workflows. Dois caminhos: um AI Agent com o nó MCP Client Tool, ou nós HTTP Request simples, sem nenhum modelo de linguagem.

Criar chave de APIImagens a partir de $0.03, vídeo a partir de $0.06 — pague por geração
01O que você recebe

O que um workflow faz e quanto custa

Cada geração é paga com o seu saldo do BananaBanana, pelos mesmos preços do site. Não há assinatura nem taxa específica do n8n. Chamadas caras (vídeo, várias imagens de uma vez) retornam primeiro uma cotação e não cobram nada até você confirmar; gerações com falha ou barradas pelo filtro são reembolsadas automaticamente.

ChamadaPreço
Imagem (generate_image, edit_image)$0.03–$0.20 por imagem
Clipe de vídeo (generate_video, edit_video)$0.06–$6.00 por clipe
Voz (generate_speech)$0.01 a cada 200 caracteres iniciados
Status, modelos, conta (get_result, list_models, get_account)grátis

O preço exato de cada modelo, resolução e duração está em list_models e na página de preços.

02Passo 1

Crie uma chave de API

  1. Cadastre-se e recarregue o saldo.
  2. Abra Perfil → Chaves de API e crie uma chave. Ela começa com bb_live_ e é exibida uma única vez — copie-a direto para uma credencial do n8n.
  3. Defina na chave um limite diário de gastos que combine com o seu workflow, por exemplo o custo das execuções esperadas por dia. Assim, um loop que saiu do controle para no limite em vez de esvaziar o saldo.
  4. No n8n, crie uma credencial Bearer Auth e cole a chave como Bearer Token. Os dois métodos abaixo usam essa mesma credencial.
03Método A

AI Agent + MCP Client Tool

Adicione um nó AI Agent, conecte um modelo de chat e o nó MCP Client Tool com estas configurações:

Node: MCP Client Tool  (connect it to the AI Agent "Tool" input)
Endpoint URL:      https://bananabanana.pro/api/mcp
Server Transport:  HTTP Streamable
Authentication:    Bearer Auth → your BananaBanana credential
Tools to Include:  Selected → list_models, get_account, generate_image, get_result

O agente precisa do próprio modelo de linguagem (OpenAI, Anthropic, Gemini ou qualquer modelo compatível com o n8n) com a própria chave de API: o BananaBanana gera a mídia, e o modelo decide quais ferramentas chamar.

Confirmação de preço

Chamadas de vídeo e de várias imagens respondem primeiro com status: confirmation_required e quoted_cost_usd, sem cobrar nada. O valor só é debitado quando a mesma chamada volta com confirm_cost igual à cotação. Diga ao agente na mensagem de sistema o que fazer: parar e informar o preço (como abaixo) ou confirmar por conta própria até um limite que você definir.

Mensagem de sistema usada no workflow pronto

You create images with the BananaBanana tools. Call generate_image with the user's
request (model nano-banana-2-lite unless the user names another model; list_models
shows models and prices). generate_image returns a job_id: call get_result with that
job_id and wait_seconds 30 until status is completed. If a tool answers status
confirmation_required, tell the user the quoted price and stop: never pass
confirm_cost on your own. Finish with the first file URL from get_result on its own line.

A geração é assíncrona: generate_image retorna um job_id, e get_result espera até 30 segundos por chamada até o arquivo ficar pronto. A resposta traz um link assinado do arquivo, que um nó HTTP Request após o agente baixa como arquivo.

Node: HTTP Request  (after the AI Agent)
Method:  GET
URL:     {{ $json.output.match(/https?:\/\/\S+?\/api\/files\/[^\s)"'\]]+/)[0] }}
Options → Response → Response Format: File
04Método B

Nós HTTP Request, sem modelo de linguagem

O endpoint MCP é JSON simples via POST, então nós HTTP Request comuns podem chamá-lo diretamente. É a opção mais barata e previsível: sem tokens de modelo e sem agente escolhendo parâmetros.

  1. Gerar imagem — faça um POST de tools/call para generate_image. Use {{ $execution.id }} em idempotency_key: se o n8n repetir o nó, a mesma chave devolve o job original em vez de cobrar duas vezes.
  2. Obter resultado — faça POST de get_result com o job_id e wait_seconds: 30. Um nó If envia status: processing para um Wait de 5 segundos e volta; completed segue adiante.
  3. Baixar arquivo — faça GET em files[0].url com Response Format definido como File. O binário segue para Google Drive, S3, WordPress, YouTube, publicação em redes sociais — qualquer nó que aceite um arquivo.
Node: HTTP Request "Generate image"
Method:          POST
URL:             https://bananabanana.pro/api/mcp
Authentication:  Generic Credential Type → Bearer Auth
Send Headers:    Accept = application/json, text/event-stream
Send Body:       JSON →
{{ JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: {
     name: "generate_image",
     arguments: { prompt: $json.prompt, model: "nano-banana-2-lite",
                  aspect_ratio: "1:1", idempotency_key: "n8n-" + $execution.id } } }) }}

→ {{ $json.result.structuredContent.job_id }}   (status: "processing")
Node: HTTP Request "Get result"   (same URL, credential and headers)
{{ JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: {
     name: "get_result",
     arguments: { job_id: $('Generate image').item.json.result.structuredContent.job_id,
                  wait_seconds: 30 } } }) }}

If  {{ $json.result.structuredContent.status }} is "processing"  → Wait 5 s → Get result
If  … is "completed"  → HTTP Request GET {{ $json.result.structuredContent.files[0].url }}
                        Options → Response → Response Format: File

Vídeo: cotar, verificar, confirmar

Para generate_video, envie a chamada duas vezes: a primeira resposta traz quoted_cost_usd; um nó If compara com o seu limite e só então a segunda chamada o devolve como confirm_cost. Vídeos levam de um a dez minutos, então mantenha o loop de get_result.

1. generate_video  { prompt, model: "veo-3.1-fast", duration: 8, resolution: "720p" }
   ← { status: "confirmation_required", quoted_cost_usd: 0.70 }      nothing charged
2. If  {{ $json.result.structuredContent.quoted_cost_usd }}  ≤  your limit
3. generate_video  { …same arguments…, confirm_cost: {{ $json.result.structuredContent.quoted_cost_usd }},
                     idempotency_key: "n8n-" + $execution.id }
   ← { job_id, status: "processing", cost_charged_usd: 0.70 }
4. get_result loop as above (videos take 1–10 minutes)
05Workflows prontos

Importe um workflow em um minuto

Nenhum dos dois workflows contém chaves ou credenciais. No n8n, escolha Workflows → Import from File (ou cole o JSON no editor) e depois selecione suas credenciais nos nós marcados com um aviso.

  • AI Agent + MCP Client Tool: Manual Trigger → AI Agent (OpenAI Chat Model, BananaBanana MCP) → Download file. Selecione sua credencial da OpenAI e a credencial Bearer Auth.

    Baixar JSON · bananabanana-n8n-agent.json
  • HTTP Request: Manual Trigger → configurações da requisição → Generate image → Get result (com loop de espera) → Download file, além de paradas claras em caso de erro. Selecione a credencial Bearer Auth nos três nós de requisição.

    Baixar JSON · bananabanana-n8n-http.json

Os dois workflows foram importados e executados de ponta a ponta no n8n 2.48.7 auto-hospedado; a imagem padrão custa $0.03 por execução.

06Solução de problemas

Erros comuns e o que fazer

  • 401 — a chave está ausente, digitada errado ou revogada. A credencial deve conter apenas a chave; o n8n adiciona a palavra Bearer.
  • INSUFFICIENT_BALANCE — o saldo não cobre a chamada. A resposta inclui um link de recarga; nada foi cobrado.
  • confirmation_required — não é um erro: a chamada precisa de confirm_cost (veja o Método A e a receita de vídeo).
  • RATE_LIMITED — mais de 20 chamadas de ferramenta por minuto em uma única chave. Adicione um Wait ou ative Retry On Fail com uma pausa.
  • DAILY_CAP_EXCEEDED — a chave atingiu o limite diário que você definiu. Aumente-o no perfil ou espere o próximo dia UTC.
  • SAFETY_FILTERED — o filtro de conteúdo do modelo recusou o prompt ou o resultado; o valor é reembolsado. Reescreva o prompt.
  • Os links de arquivo expiram após 24 horas. Baixe o arquivo na mesma execução; em até 30 dias, get_result retorna links novos.
07FAQ

Perguntas sobre n8n e BananaBanana

Existe um nó do BananaBanana no n8n?

Ainda não na lista de nós. Os nós MCP Client Tool e HTTP Request que já vêm com o n8n alcançam todas as ferramentas do BananaBanana, e os workflows prontos acima já os configuram para você.

Preciso de uma chave da OpenAI ou de outro modelo?

Apenas no Método A, em que um AI Agent decide qual ferramenta chamar. O Método B, com nós HTTP Request, não precisa de nada além da chave do BananaBanana.

Quanto custa uma execução de workflow?

Exatamente o preço do que ela gera: a partir de $0.03 por imagem, a partir de $0.06 por clipe de vídeo, $0.01 a cada 200 caracteres iniciados de voz. Consultas de status e downloads são grátis, e gerações com falha são reembolsadas.

Uma nova tentativa ou um loop pode me cobrar duas vezes?

Não quando a chamada leva um idempotency_key: uma chamada repetida com a mesma chave devolve o job original sem nova cobrança. Um limite diário na chave contém o prejuízo de um loop descontrolado.

Quais modelos um workflow pode usar?

Todos os modelos da plataforma: Nano Banana 2, 2.1, Lite e Pro, GPT Image e Qwen para imagens; Veo 3.1, Gemini Omni, Wan 3.0 e Grok Imagine para vídeo; Gemini TTS para voz. list_models retorna a lista atual com os preços.

Conecte a geração ao seu próximo workflow

Uma chave, pague por geração, cotação antes de cada chamada cara.

Criar chave de API