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.
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.
| Chiamata | Prezzo |
|---|---|
| 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.
Crea una chiave API
- Registrati e ricarica il saldo.
- 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. - 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.
- In n8n crea una credenziale
Bearer Authe incolla la chiave come Bearer Token. Entrambi i metodi qui sotto usano questa unica credenziale.
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_resultL'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: FileNodi 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.
- Genera immagine — invia in POST un
tools/callpergenerate_image. Usa{{ $execution.id }}inidempotency_key: se n8n riprova il nodo, la stessa chiave restituisce il job originale invece di addebitare due volte. - Ottieni risultato — invia in POST
get_resultcon iljob_idewait_seconds: 30. Un nodoIfmandastatus: processinga unWaitdi 5 secondi e di nuovo indietro;completedprosegue. - Scarica file — GET su
files[0].urlcon 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: FileVideo: 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)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.jsonHTTP 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.
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 richiedeconfirm_cost(vedi il Metodo A e la ricetta video).RATE_LIMITED— più di 20 chiamate ai tool al minuto con una sola chiave. Aggiungi unWaito 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_resultrestituisce link nuovi.
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