Интеграция с 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.

Какие модели может использовать 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-ключ