n8n API: подключение и настройка моделей
В n8n шлюз подключается через учётные данные узлов OpenAI или Anthropic: в обоих есть поле Base URL. У OpenAI адрес с /, у Anthropic без него.
- Тип: No-code платформа
- Протокол: OpenAI Chat Completions, Anthropic Messages
- Статус: Работает
Что заработает
| Возможность | Отметка | Примечание |
|---|---|---|
| Чат | Да | |
| Вызов инструментов | Частично | Нужна модель с поддержкой инструментов. |
Настройка
Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.
- Создайте учётные данные OpenAI: введите ключ и Base URL
https://.relay-llm.ru/ v1 - Для моделей Claude создайте учётные данные Anthropic: ключ и Base URL
https://безrelay-llm.ru /.v1 - В узле Chat Model выберите созданные учётные данные и укажите идентификатор модели, например
gpt-5.6-luna.
Учётные данные OpenAI
API Key: YOUR_API_KEY
Base URL: https://relay-llm.ru/v1
Model: gpt-5.6-lunaУчётные данные Anthropic
API Key: YOUR_API_KEY
Base URL: https://relay-llm.ru
Model: claude-haiku-5-5Проверка
Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.
macOS и Linux
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Windows PowerShell
curl.exe https://relay-llm.ru/v1/key `
-H "Authorization: Bearer $env:RELAY_API_KEY"Windows cmd
curl https://relay-llm.ru/v1/key ^
-H "Authorization: Bearer %RELAY_API_KEY%"Затем проверьте сам клиент.
Нажмите Test в учётных данных, затем запустите простой процесс с узлом Chat Model. Запись появится в журнале запросов кабинета.
Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.
Ограничения протоколов
OpenAI Chat Completions
Работают чат-модели каталога по пути /. Не поддерживаются /, /, /, /, Assistants и Realtime: функции клиента, которым они нужны, не заработают.
Anthropic Messages
Работают модели, которые принимают этот протокол. Модели GPT по пути / недоступны: шлюз не переводит протоколы друг в друга. Адрес для клиентов Anthropic указывается без /.
Ловушки
- Проверку учётных данных Anthropic n8n делает запросом
GET /по адресу из поля Base URL. Шлюз его поддерживает, но запрос выполняется с вашим ключом: ключ без доступа даст ошибку теста.v1/ models - Облачный n8n ходит к шлюзу со своих адресов, а не с вашего компьютера: проверяйте подключение из самого n8n.
- Для узлов с инструментами нужна модель с их поддержкой. Узлы эмбеддингов не заработают: у шлюза нет
/.v1/ embeddings
Ссылки
Официальная документация: n8n API: подключение и настройка моделей
Подключение клиентов: общие сведения и все клиенты