Інтеграція з n8n

Зображення та відео просто в n8n Згенерувати, дочекатися, завантажити, опублікувати — в одному workflow

Підключіть n8n до BananaBanana одним API-ключем і викликайте Nano Banana, Veo, Gemini Omni, Wan, Grok Imagine, GPT Image, Qwen та Gemini TTS просто зі своїх workflow. Два шляхи: AI Agent із нодою MCP Client Tool або звичайні ноди HTTP Request без мовної моделі.

Створити API-ключЗображення від $0.03, відео від $0.06 — оплата за кожну генерацію
01Що ви отримуєте

Що вміє workflow і скільки це коштує

Кожна генерація оплачується з вашого балансу BananaBanana за тими самими цінами, що й на сайті. Підписки немає, окремої комісії за n8n теж. Дорогі виклики (відео, кілька зображень одразу) спочатку повертають розрахунок вартості й нічого не списують, доки ви його не підтвердите; невдалі та відхилені фільтром генерації повертаються на баланс автоматично.

ВикликЦіна
Зображення (generate_image, edit_image)$0.03–$0.20 за зображення
Відеокліп (generate_video, edit_video)$0.06–$6.00 за кліп
Мовлення (generate_speech)$0.01 за кожні розпочаті 200 символів
Статус, моделі, акаунт (get_result, list_models, get_account)безкоштовно

Точна ціна моделі, роздільної здатності та тривалості наведена в list_models і на сторінці цін.

02Крок 1

Створіть API-ключ

  1. Зареєструйтеся та поповніть баланс.
  2. Відкрийте Профіль → API-ключі і створіть ключ. Він починається з bb_live_ і показується один раз — одразу скопіюйте його в credential n8n.
  3. Задайте для ключа добовий ліміт витрат під ваш workflow, наприклад вартість запусків, яких ви очікуєте за день. Тоді цикл, що пішов не за планом, зупиниться на ліміті, а не спише весь баланс.
  4. В n8n створіть credential Bearer Auth і вставте ключ у поле Bearer Token. Обидва способи нижче використовують цей один credential.
03Спосіб A

AI Agent + MCP Client Tool

Додайте ноду AI Agent, підключіть чат-модель і ноду MCP Client Tool з такими налаштуваннями:

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

Агенту потрібна власна мовна модель (OpenAI, Anthropic, Gemini або будь-яка модель, яку підтримує n8n) зі своїм API-ключем: BananaBanana генерує медіа, а модель вирішує, які інструменти викликати.

Підтвердження ціни

Виклики відео та кількох зображень спочатку відповідають status: confirmation_required із полем quoted_cost_usd і нічого не списують. Гроші списуються лише тоді, коли той самий виклик надходить із confirm_cost, що дорівнює розрахунку. У системному повідомленні скажіть агенту, як діяти: зупинитися й повідомити ціну (як нижче) або підтверджувати самостійно в межах названого вами ліміту.

Системне повідомлення з готового workflow

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.

Генерація асинхронна: generate_image повертає job_id, а get_result чекає до 30 секунд за виклик, доки файл не буде готовий. У відповіді є підписане посилання на файл, яке нода HTTP Request після агента завантажує як файл.

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

Ноди HTTP Request, без мовної моделі

MCP-ендпоінт — це звичайний JSON поверх POST, тож його можна викликати напряму звичайними нодами HTTP Request. Це найдешевший і найпередбачуваніший варіант: без токенів моделі та без агента, що обирає параметри.

  1. Generate image — надішліть POST із tools/call для generate_image. У idempotency_key підставте {{ $execution.id }}: якщо n8n повторить ноду, той самий ключ поверне початкове завдання, а не спише гроші вдруге.
  2. Get result — надішліть POST get_result із job_id та wait_seconds: 30. Нода If спрямовує status: processing у Wait на 5 секунд і назад; completed іде далі.
  3. Download file — GET на files[0].url з Response Format, рівним File. Бінарні дані йдуть далі в Google Drive, S3, WordPress, YouTube, публікацію в соцмережах — у будь-яку ноду, що приймає файл.
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

Відео: розрахунок, перевірка, підтвердження

Для generate_video надсилайте виклик двічі: перша відповідь містить quoted_cost_usd; нода If порівнює його з вашим лімітом, і лише потім другий виклик передає його назад як confirm_cost. Відео створюється від однієї до десяти хвилин, тому залиште цикл 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)
05Готові workflow

Імпортуйте workflow за хвилину

В обох workflow немає ключів і credentials. В n8n виберіть Workflows → Import from File (або вставте JSON у редактор), а потім виберіть свої credentials у нодах, позначених попередженням.

  • AI Agent + MCP Client Tool: Manual Trigger → AI Agent (OpenAI Chat Model, BananaBanana MCP) → Download file. Виберіть свій credential OpenAI та credential Bearer Auth.

    Завантажити JSON · bananabanana-n8n-agent.json
  • HTTP Request: Manual Trigger → налаштування запиту → Generate image → Get result (із циклом очікування) → Download file, а також зрозумілі зупинки під час помилок. Виберіть credential Bearer Auth у трьох нодах запитів.

    Завантажити JSON · bananabanana-n8n-http.json

Обидва workflow імпортовано та виконано від початку до кінця на self-hosted n8n 2.48.7; зображення за замовчуванням коштує $0.03 за запуск.

06Усунення неполадок

Поширені помилки та що робити

  • 401 — ключ відсутній, введений з помилкою або відкликаний. У credential має бути сам ключ; слово Bearer n8n додасть сам.
  • INSUFFICIENT_BALANCE — балансу не вистачає на виклик. У відповіді є посилання для поповнення; нічого не списано.
  • confirmation_required — це не помилка: виклику потрібен confirm_cost (див. спосіб A і рецепт для відео).
  • RATE_LIMITED — понад 20 викликів інструментів за хвилину на один ключ. Додайте Wait або ввімкніть Retry On Fail із паузою.
  • DAILY_CAP_EXCEEDED — ключ досяг заданого вами добового ліміту. Збільшіть його в профілі або дочекайтеся наступної доби за UTC.
  • SAFETY_FILTERED — фільтр контенту моделі відхилив промпт або результат; списана сума повертається. Переформулюйте промпт.
  • Посилання на файли діють 24 години. Завантажуйте файл у тому самому запуску; протягом 30 днів get_result поверне нові посилання.
07FAQ

Запитання про n8n і BananaBanana

Чи є нода BananaBanana в n8n?

У списку нод поки немає. Але вбудовані в n8n ноди MCP Client Tool і HTTP Request уже дають доступ до всіх інструментів BananaBanana, а готові workflow вище налаштовують їх за вас.

Чи потрібен ключ OpenAI або іншої моделі?

Лише для способу A, де AI Agent сам вирішує, який інструмент викликати. Способу B з нодами HTTP Request потрібен тільки ключ BananaBanana.

Скільки коштує один запуск workflow?

Рівно стільки, скільки коштує те, що він генерує: від $0.03 за зображення, від $0.06 за відеокліп, $0.01 за кожні розпочаті 200 символів мовлення. Перевірка статусу та завантаження безкоштовні, а невдалі генерації повертаються на баланс.

Чи можуть повтор або цикл списати гроші двічі?

Ні, якщо виклик має idempotency_key: повторний виклик із тим самим ключем повертає початкове завдання без нового списання. А добовий ліміт на ключі обмежує збитки від зациклення.

Які моделі може використовувати workflow?

Усі моделі платформи: Nano Banana 2, 2.1, Lite і Pro, GPT Image та Qwen для зображень; Veo 3.1, Gemini Omni, Wan 3.0 і Grok Imagine для відео; Gemini TTS для мовлення. list_models повертає актуальний список із цінами.

Підключіть генерацію до свого наступного workflow

Один ключ, оплата за кожну генерацію, розрахунок вартості перед кожним дорогим викликом.

Створити API-ключ