Интеграция с 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.
Какие модели может использовать 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-ключ