Integración con n8n
Imágenes y video dentro de n8n Genera, espera, descarga, publica — en un solo flujo
Conecta n8n con BananaBanana con una sola clave API y llama a Nano Banana, Veo, Gemini Omni, Wan, Grok Imagine, GPT Image, Qwen y Gemini TTS desde tus flujos. Dos vías: un AI Agent con el nodo MCP Client Tool, o simples nodos HTTP Request sin ningún modelo de lenguaje.
Qué puede hacer un flujo y cuánto cuesta
Cada generación se paga de tu saldo de BananaBanana a los mismos precios que en el sitio web. No hay suscripción ni tarifa específica de n8n. Las llamadas caras (video, varias imágenes a la vez) devuelven primero una cotización y no cobran nada hasta que la confirmes; las generaciones fallidas o filtradas se reembolsan automáticamente.
| Llamada | Precio |
|---|---|
| Imagen (generate_image, edit_image) | $0.03–$0.20 por imagen |
| Clip de video (generate_video, edit_video) | $0.06–$6.00 por clip |
| Voz (generate_speech) | $0.01 por cada 200 caracteres iniciados |
| Estado, modelos, cuenta (get_result, list_models, get_account) | gratis |
El precio exacto de un modelo, una resolución y una duración está en list_models y en la página de precios.
Crear una clave API
- Regístrate y recarga tu saldo.
- Abre Perfil → API Keys y crea una clave. Empieza por
bb_live_y se muestra una sola vez: cópiala directamente en una credencial de n8n. - Establece en la clave un límite de gasto diario acorde con tu flujo, por ejemplo el costo de las ejecuciones que esperas por día. Así, un bucle descontrolado se detiene en el límite en lugar de vaciar el saldo.
- En n8n crea una credencial
Bearer Authy pega la clave como Bearer Token. Los dos métodos siguientes usan esta misma credencial.
AI Agent + MCP Client Tool
Añade un nodo AI Agent, conecta un modelo de chat y conecta el nodo MCP Client Tool con estos ajustes:
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_resultEl agente necesita su propio modelo de lenguaje (OpenAI, Anthropic, Gemini o cualquier modelo compatible con n8n) con su propia clave API: BananaBanana genera el contenido multimedia y el modelo decide qué herramientas llamar.
Confirmación de precio
Las llamadas de video y de varias imágenes responden primero con status: confirmation_required y quoted_cost_usd, y no cobran nada. El dinero se cobra solo cuando la misma llamada vuelve con confirm_cost igual a la cotización. Indícale al agente en su mensaje de sistema qué hacer: detenerse e informar del precio (como abajo), o confirmar por su cuenta hasta un límite que tú fijes.
Mensaje de sistema que usamos en el flujo listo
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 generación es asíncrona: generate_image devuelve un job_id y get_result espera hasta 30 segundos por llamada hasta que el archivo esté listo. La respuesta contiene un enlace firmado al archivo, que un nodo HTTP Request situado después del agente descarga como archivo.
Node: HTTP Request (after the AI Agent)
Method: GET
URL: {{ $json.output.match(/https?:\/\/\S+?\/api\/files\/[^\s)"'\]]+/)[0] }}
Options → Response → Response Format: FileNodos HTTP Request, sin modelo de lenguaje
El endpoint MCP es JSON simple por POST, así que los nodos HTTP Request habituales pueden llamarlo directamente. Es la opción más económica y predecible: sin tokens de modelo y sin un agente que elija parámetros.
- Generar imagen — envía por POST un
tools/callparagenerate_image. Usa{{ $execution.id }}enidempotency_key: si n8n reintenta el nodo, la misma clave devuelve el trabajo original en lugar de cobrar dos veces. - Obtener resultado — envía por POST
get_resultcon eljob_idywait_seconds: 30. Un nodoIfenvíastatus: processinga unWaitde 5 segundos y de vuelta;completedcontinúa. - Descargar archivo — GET a
files[0].urlcon Response Format en File. El binario pasa a Google Drive, S3, WordPress, YouTube, publicación en redes sociales: cualquier nodo que acepte un archivo.
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: cotizar, comprobar, confirmar
Para generate_video envía la llamada dos veces: la primera respuesta incluye quoted_cost_usd; un nodo If lo compara con tu límite y solo entonces la segunda llamada lo devuelve como confirm_cost. Los videos tardan de uno a diez minutos, así que mantén el bucle 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)Importa un flujo en un minuto
Ninguno de los dos flujos contiene claves ni credenciales. En n8n elige Workflows → Import from File (o pega el JSON en el editor) y luego selecciona tus credenciales en los nodos marcados con una advertencia.
AI Agent + MCP Client Tool: Manual Trigger → AI Agent (OpenAI Chat Model, BananaBanana MCP) → Descargar archivo. Selecciona tu credencial de OpenAI y la credencial Bearer Auth.
Descargar JSON · bananabanana-n8n-agent.jsonHTTP Request: Manual Trigger → ajustes de la solicitud → Generar imagen → Obtener resultado (con bucle de espera) → Descargar archivo, además de paradas claras por error. Selecciona la credencial Bearer Auth en los tres nodos de solicitud.
Descargar JSON · bananabanana-n8n-http.json
Ambos flujos se importaron y ejecutaron de principio a fin en n8n 2.48.7 autoalojado; la imagen predeterminada cuesta $0.03 por ejecución.
Errores frecuentes y qué hacer
401— la clave falta, está mal escrita o fue revocada. La credencial debe contener la clave en sí; n8n añade la palabra Bearer.INSUFFICIENT_BALANCE— el saldo no cubre la llamada. La respuesta incluye un enlace de recarga; no se cobró nada.confirmation_required— no es un error: la llamada necesitaconfirm_cost(consulta el Método A y la receta de video).RATE_LIMITED— más de 20 llamadas a herramientas por minuto con una misma clave. Añade unWaito activa Retry On Fail con una pausa.DAILY_CAP_EXCEEDED— la clave alcanzó el límite diario que estableciste. Auméntalo en el perfil o espera al siguiente día UTC.SAFETY_FILTERED— el filtro de contenido del modelo rechazó el prompt o el resultado; el cobro se reembolsa. Reformula el prompt.- Los enlaces a archivos caducan a las 24 horas. Descarga el archivo en la misma ejecución; durante 30 días
get_resultdevuelve enlaces nuevos.
Preguntas sobre n8n y BananaBanana
¿Hay un nodo de BananaBanana en n8n?
Todavía no aparece en la lista de nodos. Los nodos MCP Client Tool y HTTP Request que incluye n8n ya llegan a todas las herramientas de BananaBanana, y los flujos listos de arriba los configuran por ti.
¿Necesito una clave de OpenAI u otro modelo?
Solo para el Método A, donde un AI Agent decide qué herramienta llamar. El Método B con nodos HTTP Request no necesita nada más que la clave de BananaBanana.
¿Cuánto cuesta una ejecución de un flujo?
Exactamente el precio de lo que genera: desde $0.03 por una imagen, desde $0.06 por un clip de video, $0.01 por cada 200 caracteres iniciados de voz. Las consultas de estado y las descargas son gratis, y las generaciones fallidas se reembolsan.
¿Puede un reintento o un bucle cobrarme dos veces?
No cuando la llamada lleva un idempotency_key: una llamada repetida con la misma clave devuelve el trabajo original sin un nuevo cobro. Un límite diario en la clave reduce el daño de un bucle descontrolado.
¿Qué modelos puede usar un flujo?
Todos los modelos de la plataforma: Nano Banana 2, 2.1, Lite y Pro, GPT Image y Qwen para imágenes; Veo 3.1, Gemini Omni, Wan 3.0 y Grok Imagine para video; Gemini TTS para voz. list_models devuelve la lista actual con precios.
Integra la generación en tu próximo flujo
Una clave, pago por generación, cotización antes de cada llamada cara.
Crear una clave API