Інтеграція з 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 без мовної моделі.
Що вміє 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 і на сторінці цін.
Створіть API-ключ
- Зареєструйтеся та поповніть баланс.
- Відкрийте Профіль → API-ключі і створіть ключ. Він починається з
bb_live_і показується один раз — одразу скопіюйте його в credential n8n. - Задайте для ключа добовий ліміт витрат під ваш workflow, наприклад вартість запусків, яких ви очікуєте за день. Тоді цикл, що пішов не за планом, зупиниться на ліміті, а не спише весь баланс.
- В n8n створіть credential
Bearer Authі вставте ключ у поле Bearer Token. Обидва способи нижче використовують цей один credential.
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Ноди HTTP Request, без мовної моделі
MCP-ендпоінт — це звичайний JSON поверх POST, тож його можна викликати напряму звичайними нодами HTTP Request. Це найдешевший і найпередбачуваніший варіант: без токенів моделі та без агента, що обирає параметри.
- Generate image — надішліть POST із
tools/callдляgenerate_image. Уidempotency_keyпідставте{{ $execution.id }}: якщо n8n повторить ноду, той самий ключ поверне початкове завдання, а не спише гроші вдруге. - Get result — надішліть POST
get_resultізjob_idтаwait_seconds: 30. НодаIfспрямовуєstatus: processingуWaitна 5 секунд і назад;completedіде далі. - 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)Імпортуйте 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.jsonHTTP 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 за запуск.
Поширені помилки та що робити
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поверне нові посилання.
Запитання про 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-ключ