n8n
Инструкция по подключению ZvenoAI к n8n. Используйте модели Anthropic, OpenAI, Google и других провайдеров в AI-воркфлоу без VPN с оплатой в рублях.
n8n -- платформа автоматизации с визуальным редактором воркфлоу и AI-узлами. Подключите ZvenoAI как OpenAI-совместимый API и используйте весь каталог моделей в агентах и цепочках n8n без VPN.
Что такое n8n
n8n -- конструктор автоматизаций: воркфлоу собирается из узлов на холсте, запускается по расписанию, вебхуку или событию. AI-узлы (AI Agent, Basic LLM Chain, Information Extractor) подключаются к языковым моделям через под-узлы чат-моделей.
- Self-hosted или облако -- n8n можно развернуть на своём сервере, данные не покидают контур.
- AI Agent -- агент с инструментами: HTTP-запросы, базы данных, почта, свои функции.
- ZvenoAI вместо OpenAI -- штатный узел OpenAI Chat Model работает с ZvenoAI через замену Base URL.
Быстрый старт
Настройка занимает 3 минуты.
1. Получите API ключ
Зарегистрируйтесь на zveno.ai и создайте API ключ в личном кабинете.
2. Создайте credential OpenAI с адресом ZvenoAI
В n8n откройте Credentials → Create Credential → OpenAI и заполните поля:
- API Key -- ваш API ключ ZvenoAI;
- Organization ID -- оставьте пустым;
- Base URL -- замените стандартный адрес на:
https://api.zveno.ai/v1Сохраните credential. Проверка соединения выполнит запрос к /v1/models каталога ZvenoAI.
3. Добавьте узел OpenAI Chat Model
Соберите воркфлоу с узлом AI Agent или Basic LLM Chain. В качестве языковой модели добавьте под-узел OpenAI Chat Model и выберите в нём созданный credential.
4. Выберите модель
Поле Model подтянет список моделей из каталога ZvenoAI автоматически. Идентификаторы указываются в формате vendor/model-name, например anthropic/claude-sonnet-4.6 или openai/gpt-5.2-codex.
5. Запустите воркфлоу
Выполните тестовый запуск. Запрос уйдёт на api.zveno.ai/v1/chat/completions, использование спишется с рублёвого баланса, расход будет виден в дашборде.
Подключайте ZvenoAI через под-узел OpenAI Chat Model, как описано выше. У app-узла OpenAI (операции Message a Model и другие) в n8n известна проблема с кастомным Base URL: проверка credential проходит, а сам запрос падает. Если нужен именно одиночный вызов вне AI-цепочки, используйте узел HTTP Request из раздела ниже.
Альтернатива: узел HTTP Request
Для одиночных вызовов без AI Agent подойдёт обычный HTTP Request:
- Method --
POST - URL --
https://api.zveno.ai/v1/chat/completions - Authentication -- Generic Credential Type → Header Auth: имя
Authorization, значениеBearer <ваш-api-ключ-zvenoai> - Body -- JSON:
{
"model": "anthropic/claude-sonnet-4.6",
"messages": [{ "role": "user", "content": "Суммаризируй текст: {{ $json.text }}" }]
}Ответ придёт в формате OpenAI Chat Completions -- текст лежит в choices[0].message.content.
Embeddings
Узел Embeddings OpenAI (для Vector Store и RAG-цепочек) работает с тем же credential: ZvenoAI поддерживает эндпоинт /v1/embeddings. Список embedding-моделей: Каталог моделей.
Рекомендуемые модели
| Model ID | Вендор | Примечание |
|---|---|---|
anthropic/claude-sonnet-4.6 | Anthropic | Баланс цены и качества для агентов |
openai/gpt-5.2 | OpenAI | Универсальная |
google/gemini-3.1-pro-preview | Длинный контекст (1M) | |
google/gemini-2.5-flash | Дёшево для массовых воркфлоу |
Полный список моделей: Каталог моделей
Решение проблем
- Проверка credential проходит, а запрос падает -- вы используете app-узел OpenAI вместо под-узла OpenAI Chat Model. Замените узел или перейдите на HTTP Request.
- Ошибка авторизации (401) -- проверьте, что ключ скопирован целиком и credential выбран в узле.
- Модель не найдена -- идентификатор указывается с префиксом вендора:
anthropic/claude-sonnet-4.6, а её наличие проверяется в каталоге. - Долгие ответы на длинных промптах -- увеличьте таймаут в настройках узла: большие reasoning-модели могут отвечать десятки секунд.