К содержимому

n8n API: подключение и настройка моделей

В n8n шлюз подключается через учётные данные узлов OpenAI или Anthropic: в обоих есть поле Base URL. У OpenAI адрес с /v1, у Anthropic без него.

  • Тип: No-code платформа
  • Протокол: OpenAI Chat Completions, Anthropic Messages
  • Статус: Работает
Настройки сверены с официальной документацией клиента, 2026-10-02. Не проверено вручную: запуск клиента против шлюза не выполнялся.

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Вызов инструментовЧастичноНужна модель с поддержкой инструментов.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

  1. Создайте учётные данные OpenAI: введите ключ и Base URL https://relay-llm.ru/v1.
  2. Для моделей Claude создайте учётные данные Anthropic: ключ и Base URL https://relay-llm.ru без /v1.
  3. В узле Chat Model выберите созданные учётные данные и укажите идентификатор модели, например gpt-5.6-luna.

Учётные данные OpenAI

text
API Key: YOUR_API_KEY
Base URL: https://relay-llm.ru/v1
Model: gpt-5.6-luna

Учётные данные Anthropic

text
API Key: YOUR_API_KEY
Base URL: https://relay-llm.ru
Model: claude-haiku-5-5

Проверка

Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.

macOS и Linux

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Нажмите Test в учётных данных, затем запустите простой процесс с узлом Chat Model. Запись появится в журнале запросов кабинета.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

Anthropic Messages

Работают модели, которые принимают этот протокол. Модели GPT по пути /v1/messages недоступны: шлюз не переводит протоколы друг в друга. Адрес для клиентов Anthropic указывается без /v1.

Ловушки

  • Проверку учётных данных Anthropic n8n делает запросом GET /v1/models по адресу из поля Base URL. Шлюз его поддерживает, но запрос выполняется с вашим ключом: ключ без доступа даст ошибку теста.
  • Облачный n8n ходит к шлюзу со своих адресов, а не с вашего компьютера: проверяйте подключение из самого n8n.
  • Для узлов с инструментами нужна модель с их поддержкой. Узлы эмбеддингов не заработают: у шлюза нет /v1/embeddings.

Официальная документация: n8n API: подключение и настройка моделей

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key