Integrazione n8n

Immagini e video dentro n8n Genera, attendi, scarica, pubblica — in un unico workflow

Collega n8n a BananaBanana con una sola chiave API e richiama Nano Banana, Veo, Gemini Omni, Wan, Grok Imagine, GPT Image, Qwen e Gemini TTS dai tuoi workflow. Due strade: un AI Agent con il nodo MCP Client Tool, oppure semplici nodi HTTP Request senza alcun modello linguistico.

Crea una chiave APIImmagini da $0.03, video da $0.06 — paghi a generazione
01Cosa ottieni

Cosa può fare un workflow e quanto costa

Ogni generazione viene pagata dal tuo saldo BananaBanana agli stessi prezzi del sito. Non c'è abbonamento né una tariffa specifica per n8n. Le chiamate costose (video, più immagini insieme) restituiscono prima un preventivo e non addebitano nulla finché non lo confermi; le generazioni fallite e filtrate vengono rimborsate automaticamente.

ChiamataPrezzo
Immagine (generate_image, edit_image)$0.03–$0.20 per immagine
Clip video (generate_video, edit_video)$0.06–$6.00 per clip
Voce (generate_speech)$0.01 ogni 200 caratteri iniziati
Stato, modelli, account (get_result, list_models, get_account)gratis

Il prezzo esatto di un modello, di una risoluzione e di una durata è in list_models e nella pagina dei prezzi.

02Passo 1

Crea una chiave API

  1. Registrati e ricarica il saldo.
  2. Apri Profilo → Chiavi API e crea una chiave. Inizia con bb_live_ e viene mostrata una sola volta: copiala direttamente in una credenziale di n8n.
  3. Imposta sulla chiave un limite di spesa giornaliero adatto al tuo workflow, per esempio il costo delle esecuzioni che prevedi ogni giorno. Un ciclo impazzito si fermerà così al limite invece di svuotare il saldo.
  4. In n8n crea una credenziale Bearer Auth e incolla la chiave come Bearer Token. Entrambi i metodi qui sotto usano questa unica credenziale.
03Metodo A

AI Agent + MCP Client Tool

Aggiungi un nodo AI Agent, collega un modello di chat e collega il nodo MCP Client Tool con queste impostazioni:

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

L'agente ha bisogno di un proprio modello linguistico (OpenAI, Anthropic, Gemini o qualsiasi modello supportato da n8n) con una propria chiave API: BananaBanana genera i contenuti multimediali, il modello decide quali tool chiamare.

Conferma del prezzo

Le chiamate video e multi-immagine rispondono prima con status: confirmation_required e quoted_cost_usd e non addebitano nulla. Il denaro viene prelevato solo quando la stessa chiamata torna con confirm_cost uguale al preventivo. Indica all'agente nel suo messaggio di sistema cosa fare: fermarsi e comunicare il prezzo (come sotto), oppure confermare da solo entro un limite che stabilisci tu.

Messaggio di sistema usato nel 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.

La generazione è asincrona: generate_image restituisce un job_id e get_result attende fino a 30 secondi per chiamata che il file sia pronto. La risposta contiene un link firmato al file, che un nodo HTTP Request dopo l'agente scarica come file.

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

Nodi HTTP Request, senza modello linguistico

L'endpoint MCP è semplice JSON via POST, quindi i normali nodi HTTP Request possono chiamarlo direttamente. È l'opzione più economica e prevedibile: niente token del modello e nessun agente che sceglie i parametri.

  1. Genera immagine — invia in POST un tools/call per generate_image. Usa {{ $execution.id }} in idempotency_key: se n8n riprova il nodo, la stessa chiave restituisce il job originale invece di addebitare due volte.
  2. Ottieni risultato — invia in POST get_result con il job_id e wait_seconds: 30. Un nodo If manda status: processing a un Wait di 5 secondi e di nuovo indietro; completed prosegue.
  3. Scarica file — GET su files[0].url con Response Format impostato su File. Il binario passa a Google Drive, S3, WordPress, YouTube, pubblicazione sui social: qualsiasi nodo che accetti un file.
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

Video: preventivo, verifica, conferma

Per generate_video invia la chiamata due volte: la prima risposta contiene quoted_cost_usd; un nodo If lo confronta con il tuo limite e solo allora la seconda chiamata lo restituisce come confirm_cost. I video richiedono da uno a dieci minuti, quindi mantieni il ciclo 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)
05Workflow pronti

Importa un workflow in un minuto

Entrambi i workflow non contengono chiavi né credenziali. In n8n scegli Workflows → Import from File (oppure incolla il JSON nell'editor), poi seleziona le tue credenziali nei nodi segnalati da un avviso.

  • AI Agent + MCP Client Tool: Manual Trigger → AI Agent (OpenAI Chat Model, BananaBanana MCP) → Scarica file. Seleziona la tua credenziale OpenAI e la credenziale Bearer Auth.

    Scarica il JSON · bananabanana-n8n-agent.json
  • HTTP Request: Manual Trigger → impostazioni della richiesta → Genera immagine → Ottieni risultato (con ciclo di attesa) → Scarica file, più arresti chiari in caso di errore. Seleziona la credenziale Bearer Auth nei tre nodi di richiesta.

    Scarica il JSON · bananabanana-n8n-http.json

Entrambi i workflow sono stati importati ed eseguiti da cima a fondo su n8n 2.48.7 self-hosted; l'immagine predefinita costa $0.03 a esecuzione.

06Risoluzione dei problemi

Errori comuni e cosa fare

  • 401 — la chiave manca, è digitata male o è stata revocata. La credenziale deve contenere la chiave stessa; n8n aggiunge la parola Bearer.
  • INSUFFICIENT_BALANCE — il saldo non copre la chiamata. La risposta include un link di ricarica; non è stato addebitato nulla.
  • confirmation_required — non è un errore: la chiamata richiede confirm_cost (vedi il Metodo A e la ricetta video).
  • RATE_LIMITED — più di 20 chiamate ai tool al minuto con una sola chiave. Aggiungi un Wait o attiva Retry On Fail con una pausa.
  • DAILY_CAP_EXCEEDED — la chiave ha raggiunto il limite giornaliero che hai impostato. Aumentalo nel profilo oppure attendi il giorno UTC successivo.
  • SAFETY_FILTERED — il filtro dei contenuti del modello ha rifiutato il prompt o il risultato; l'addebito viene rimborsato. Riformula il prompt.
  • I link ai file scadono dopo 24 ore. Scarica il file nella stessa esecuzione; entro 30 giorni get_result restituisce link nuovi.
07FAQ

Domande su n8n e BananaBanana

Esiste un nodo BananaBanana in n8n?

Non ancora nell'elenco dei nodi. I nodi MCP Client Tool e HTTP Request inclusi in n8n raggiungono già tutti i tool di BananaBanana, e i workflow pronti qui sopra li configurano per te.

Mi serve una chiave OpenAI o di un altro modello?

Solo per il Metodo A, in cui un AI Agent decide quale tool chiamare. Il Metodo B con i nodi HTTP Request non richiede altro che la chiave BananaBanana.

Quanto costa una singola esecuzione del workflow?

Esattamente il prezzo di ciò che genera: da $0.03 per un'immagine, da $0.06 per una clip video, $0.01 ogni 200 caratteri di voce iniziati. Le verifiche di stato e i download sono gratuiti, e le generazioni fallite vengono rimborsate.

Un nuovo tentativo o un ciclo può addebitarmi due volte?

Non quando la chiamata contiene un idempotency_key: una chiamata ripetuta con la stessa chiave restituisce il job originale senza un nuovo addebito. Un limite giornaliero sulla chiave contiene i danni di un ciclo fuori controllo.

Quali modelli può usare un workflow?

Tutti i modelli della piattaforma: Nano Banana 2, 2.1, Lite e Pro, GPT Image e Qwen per le immagini; Veo 3.1, Gemini Omni, Wan 3.0 e Grok Imagine per i video; Gemini TTS per la voce. list_models restituisce l'elenco aggiornato con i prezzi.

Integra la generazione nel tuo prossimo workflow

Una chiave, paghi a generazione, preventivo prima di ogni chiamata costosa.

Crea una chiave API