Интеграции
ИНТЕГРАЦИИ

n8n

Подключение Hubris к n8n — низкокодовая платформа автоматизации, в которой можно собирать workflow с участием LLM.

n8n — низкокодовая платформа автоматизации с тысячью готовых интеграций и поддержкой собственных нод. В workflow можно дёргать LLM — обрабатывать письма, классифицировать обращения, переводить, суммаризировать. Hubris подключается как обычный OpenAI-совместимый провайдер.

Требования

  • n8n self-hosted или n8n Cloud
  • Аккаунт на hubris.pw и API-ключ

Создание Credentials

В n8n настройка апстрима живёт не в самой ноде, а в общих Credentials — один раз создал, потом используешь во всех нодах.

  1. Откройте раздел Credentials (боковое меню слева).
  2. Нажмите Add Credential → найдите OpenAI API.
  3. Заполните поля:
ПолеЗначение
API Keyваш ключ Hubris (формат sk-gw-...) — взять в личном кабинете
Base URLhttps://api.hubris.pw/v1
Organization IDоставьте пустым
  1. Дайте credential осмысленное имя, например Hubris. Сохраните.

Использование в workflow

Дальше credential Hubris доступен во всех нодах, которые умеют работать с OpenAI-совместимым API.

OpenAI Chat Model (для AI Agent / Chains)

В AI-нодах (LangChain-агенты, цепочки):

  1. Добавьте ноду OpenAI Chat Model.
  2. В поле Credential to connect with выберите свой Hubris.
  3. В поле Model введите идентификатор модели из нашего каталога — например anthropic/claude-haiku-4.5.

Эта нода соединяется с другими AI-нодами (Tool, Memory, Output Parser) — n8n собирает агент из ваших шагов.

OpenAI (Message a model)

Если нужен простой запрос без агентной обвязки:

  1. Добавьте ноду OpenAI → действие Message a model.
  2. CredentialHubris.
  3. Model — введите ID вручную (n8n обычно подгружает список из апстрима; у нас это работает, но проверьте, что нода показывает наши модели).
  4. Соберите промпт: можно через Messages (multi-turn) или Simple (один user-prompt).

HTTP Request (на всякий случай)

Если хочется полного контроля над запросом или прокинуть кастомный параметр:

Method: POST
URL: https://api.hubris.pw/v1/chat/completions
Authentication: Generic Credential Type → Header Auth
  Name:  Authorization
  Value: Bearer sk-gw-...
Body (JSON):
{
  "model": "anthropic/claude-haiku-4.5",
  "messages": [
    {"role": "user", "content": "{{ $json.prompt }}"}
  ]
}

Удобно когда нужен response_format: { type: "json_schema" } или другие параметры, которых нет в UI ноды OpenAI.

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

n8n-workflow обычно — серия однотипных запросов: классифицировать, перевести, суммаризировать. Здесь главное — цена и скорость, не максимальное качество reasoning.

МодельКогда уместна
anthropic/claude-haiku-4.5быстрая классификация, простое извлечение данных
openai/gpt-4o-miniуниверсальный недорогой выбор, поддержка structured output
google/gemini-2.0-flashмультимодальные сценарии (картинки + текст)

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

Тяжёлые / агентные сценарии

Если workflow строит долгого AI-агента с многошаговыми инструментами — типа «найди в письме компанию → сходи в CRM → собери ответ» — модели с поддержкой tool calling показывают себя гораздо лучше. Возьмите Claude Sonnet/Opus или GPT-4o из каталога, и не забудьте включить tool calling в настройках ноды.

См. также наш гид по вызову инструментов — там разобран жизненный цикл tool-сессии.

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

Список моделей в OpenAI-ноде пустой

  • Это значит, нода не смогла дёрнуть GET /v1/models с вашим credential. Проверьте Base URL (https://api.hubris.pw/v1, обязательно с /v1 в конце) и валидность ключа.
  • Можно временно ввести Model ID вручную в режиме Manual — работает даже без подгрузки списка.

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

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

402 / insufficient_balance

429 / daily_limit_exceeded

  • Сработал суточный лимит ключа. Можно увеличить в настройках ключа или дождаться сброса (24 часа от первого запроса дня).

Workflow «зависает» на AI-ноде

  • LLM-запросы могут идти до нескольких минут (длинный контекст, reasoning-модели). В настройках ноды поднимите Timeout (по умолчанию 5 минут).

Что дальше

Обновлено:

n8n · Hubris