n8n
Подключение Hubris к n8n — низкокодовая платформа автоматизации, в которой можно собирать workflow с участием LLM.
n8n — низкокодовая платформа автоматизации с тысячью готовых интеграций и поддержкой собственных нод. В workflow можно дёргать LLM — обрабатывать письма, классифицировать обращения, переводить, суммаризировать. Hubris подключается как обычный OpenAI-совместимый провайдер.
Требования
- n8n self-hosted или n8n Cloud
- Аккаунт на hubris.pw и API-ключ
Создание Credentials
В n8n настройка апстрима живёт не в самой ноде, а в общих Credentials — один раз создал, потом используешь во всех нодах.
- Откройте раздел Credentials (боковое меню слева).
- Нажмите Add Credential → найдите OpenAI API.
- Заполните поля:
| Поле | Значение |
|---|---|
| API Key | ваш ключ Hubris (формат sk-gw-...) — взять в личном кабинете |
| Base URL | https://api.hubris.pw/v1 |
| Organization ID | оставьте пустым |
- Дайте credential осмысленное имя, например
Hubris. Сохраните.
Использование в workflow
Дальше credential Hubris доступен во всех нодах, которые умеют работать с OpenAI-совместимым API.
OpenAI Chat Model (для AI Agent / Chains)
В AI-нодах (LangChain-агенты, цепочки):
- Добавьте ноду OpenAI Chat Model.
- В поле Credential to connect with выберите свой
Hubris. - В поле Model введите идентификатор модели из нашего каталога — например
anthropic/claude-haiku-4.5.
Эта нода соединяется с другими AI-нодами (Tool, Memory, Output Parser) — n8n собирает агент из ваших шагов.
OpenAI (Message a model)
Если нужен простой запрос без агентной обвязки:
- Добавьте ноду OpenAI → действие Message a model.
- Credential →
Hubris. - Model — введите ID вручную (n8n обычно подгружает список из апстрима; у нас это работает, но проверьте, что нода показывает наши модели).
- Соберите промпт: можно через 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 минут).
Что дальше
- Каталог моделей — какие именно ID использовать в нодах.
- Управление API-ключами — отдельный ключ под n8n с лимитом.
- Расходы — посмотреть, во сколько обошёлся прогон workflow.
- Структурированный вывод — стабильные JSON-ответы для дальнейших шагов workflow.
Обновлено: