n8n

n8n — платформа автоматизации с сотнями готовых интеграций, в которой сценарии собираются из узлов. У Hubris есть официальная нода, проверенная командой n8n — пакет n8n-nodes-hubris: узел «Hubris» со всеми модальностями и узел «Hubris Chat Model» для агентов. Узлы находятся прямо из панели узлов n8n: наберите в поиске hubris и нажмите Install — пакет проверен n8n, поэтому ставится в один клик.

Требования

• n8n Cloud или свой n8n 2.x (проверено на 2.38.1) с правами владельца или администратора инстанса — установка узлов из панели доступна только им
• Аккаунт на hubris.pw и API-ключ из раздела Ключи

Как добавить узел

Нода проверена командой n8n, поэтому её не нужно искать в npm: откройте панель узлов, наберите в поиске hubris — узлы появятся в разделе More from the community со значком Verified. Выберите любой из них и нажмите Install: n8n сам поставит пакет n8n-nodes-hubris, после чего все три узла доступны как штатные. Установка — одна на инстанс, делает её владелец или администратор.

В поиске находятся три узла: Hubris — все операции с моделями, Hubris Chat Model — модель для AI Agent и цепочек, Hubris Tool — тот же узел «Hubris» в роли инструмента агента.

Узлы есть в публичном каталоге интеграций n8n: Hubris и Hubris Chat Model. Пакет в npm: n8n-nodes-hubris, исходный код открыт: github.com/Aimagine-life/n8n-nodes-hubris.

Credential «Hubris API»

Создаётся один раз и используется во всех узлах пакета.

1. Раздел Credentials → Add Credential → найдите Hubris API.
2. Заполните поля:

3. Нажмите Save — n8n сразу проверит ключ запросом к GET /v1/key и покажет «Connection successful!».

Узел «Hubris»

Один узел, внутри — ресурс и операция. Модель в каждой операции выбирается из живого каталога Hubris, отфильтрованного под задачу (для озвучки — только модели озвучки, для видео — только видеомодели), либо задаётся идентификатором через выражение.

В каждом ответе, где API отдаёт стоимость (usage.cost в копейках), узел добавляет поле cost_rub — та же сумма в рублях. У генерации картинок и озвучки стоимости в ответе нет, её видно в журнале.

Ошибки API приходят с кодом и текстом Hubris — 402 Insufficient balance, 429 daily_limit_exceeded, 401 invalid_api_key — и обрабатываются штатной настройкой узла «Continue On Fail».

Пример: статья и обложка

1. Hubris → Text → Chat, модель anthropic/claude-sonnet-5, промпт Напиши статью на 300 слов о {{ $json.topic }}.
2. Hubris → Text → Chat, модель openai/gpt-4o-mini, Response Format — JSON Schema со схемой { "type": "object", "properties": { "prompt": { "type": "string" } }, "required": ["prompt"] }, промпт Опиши обложку для этой статьи: {{ $json.text }}.
3. Hubris → Image → Generate, модель black-forest-labs/flux.2-klein-4b, промпт {{ $json.json.prompt }}.
4. Узел вашей CMS: текст из шага 1, картинка из бинарного поля data шага 3.

Узел «Hubris Chat Model» для AI Agent

Подключается к AI Agent, Basic LLM Chain и любому узлу со входом «Model»:

1. Добавьте Hubris Chat Model, выберите credential «Hubris API».
2. Выберите модель из каталога — например anthropic/claude-sonnet-5 или openai/gpt-4o-mini.
3. В Options при необходимости задайте максимум токенов, уровень размышления, таймаут и число повторов. Temperature и Top P отправляются только если их задать явно: модели Claude 5 отвергают эти параметры.

Для векторных хранилищ используйте штатный узел Embeddings OpenAI с credential «OpenAI API», в котором Base URL — https://api.hubris.pw/v1, а ключ — ваш ключ Hubris. Если запрос собирается штатным узлом HTTP Request, добавьте в него заголовок X-Title со значением n8n — иначе в логах такой запрос подпишется именем HTTP-клиента n8n (axios), одинаковым для всех сценариев. Узлы Hubris подписываются сами. Тот же credential подходит и штатному узлу OpenAI Chat Model, если нашу ноду поставить нельзя: модель в нём задаётся идентификатором из каталога через выражение (список в выпадающем меню n8n строит по своим правилам).

Рекомендуемые модели

Сценарии n8n обычно однотипные и массовые: классифицировать, перевести, извлечь поля. Здесь важнее цена и скорость, чем предельное качество.

Полный список с фильтрами по цене и возможностям — в каталоге.

Решение проблем

Узел «Hubris» не появляется в панели

• Панель показывает проверенные узлы только при включённых пакетах сообщества: на своём сервере — N8N_COMMUNITY_PACKAGES_ENABLED=true и N8N_VERIFIED_PACKAGES_ENABLED=true, в n8n Cloud — переключатель в панели администратора. Кнопка Install видна только владельцу и администраторам. Не помогло — поставьте пакет через Settings → Community Nodes и перезапустите n8n.

AI Agent не видит узел «Hubris» среди инструментов

• На своём сервере задайте переменную N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true и перезапустите n8n. Узел «Hubris Chat Model» подключается к агенту как модель и в этой переменной не нуждается.

401 при первом запросе

• Ключ не прошёл. Проверьте, что он начинается с sk-gw- и не содержит пробелов. Тест credential покажет причину сразу при сохранении.

402 / insufficient_balance

• Закончился баланс. Пополните в личном кабинете.

429 / daily_limit_exceeded

• Сработал лимит ключа. Поднимите его в настройках ключа или дождитесь сброса.

Как дождаться готового видео

Генерация идёт на стороне провайдера и занимает минуты, поэтому узел не ждёт и не блокирует сценарий. Ожидание собирается из штатных узлов n8n:

1. Hubris → Video → Generate — вернёт { id, status: "pending" }.
2. Wait — например 30 секунд.
3. Hubris → Video → Get — Video ID: {{ $('Hubris').item.json.id }}.
4. If — {{ $json.status }} равен completed? Да — ролик лежит в бинарном поле data, идём дальше. Нет — обратно на узел Wait.

Идентификатор задачи работает и из другого сценария или более позднего запуска, если забрать ролик в течение 72 часов.

Проверено на n8n 2.38.1 и n8n-nodes-hubris 0.1.6, 9 сентября 2026.

Что дальше

• Каталог моделей — какие идентификаторы использовать.
• Управление API-ключами — отдельный ключ под n8n с лимитом.
• Расходы — во сколько обошёлся прогон сценария.
• Структурированный вывод — стабильный JSON для следующих шагов сценария.

Обновлено: 27 сентября 2026 г.