n8n

Инструкция по подключению ZvenoAI к n8n. Используйте модели Anthropic, OpenAI, Google и других провайдеров в AI-воркфлоу без VPN с оплатой в рублях.

n8n -- платформа автоматизации с визуальным редактором воркфлоу и AI-узлами. Подключите ZvenoAI как OpenAI-совместимый API и используйте весь каталог моделей в агентах и цепочках n8n без VPN.

Открыть коммерческую инструкцию n8n + ZvenoAI с актуальными моделями и ценами

Что такое 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`	Google	Длинный контекст (1M)
`google/gemini-2.5-flash`	Google	Дёшево для массовых воркфлоу

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

Проверка credential проходит, а запрос падает -- вы используете app-узел OpenAI вместо под-узла OpenAI Chat Model. Замените узел или перейдите на HTTP Request.
Ошибка авторизации (401) -- проверьте, что ключ скопирован целиком и credential выбран в узле.
Модель не найдена -- идентификатор указывается с префиксом вендора: anthropic/claude-sonnet-4.6, а её наличие проверяется в каталоге.
Долгие ответы на длинных промптах -- увеличьте таймаут в настройках узла: большие reasoning-модели могут отвечать десятки секунд.