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.

Crear una clave APIImágenes desde $0.03, video desde $0.06 — pago por generación
01Qué obtienes

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.

LlamadaPrecio
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.

02Paso 1

Crear una clave API

  1. Regístrate y recarga tu saldo.
  2. 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.
  3. 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.
  4. En n8n crea una credencial Bearer Auth y pega la clave como Bearer Token. Los dos métodos siguientes usan esta misma credencial.
03Método A

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_result

El 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: File
04Método B

Nodos 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.

  1. Generar imagen — envía por POST un tools/call para generate_image. Usa {{ $execution.id }} en idempotency_key: si n8n reintenta el nodo, la misma clave devuelve el trabajo original en lugar de cobrar dos veces.
  2. Obtener resultado — envía por POST get_result con el job_id y wait_seconds: 30. Un nodo If envía status: processing a un Wait de 5 segundos y de vuelta; completed continúa.
  3. Descargar archivo — GET a files[0].url con 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: File

Video: 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)
05Flujos listos

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.json
  • HTTP 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.

06Solución de problemas

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 necesita confirm_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 un Wait o 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_result devuelve enlaces nuevos.
07FAQ

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