RU ▾
Получить API-ключ

Совместимый с OpenAI API в n8n: руководство по настройке

Если вы искали «openai compatible api n8n», короткий ответ таков: вам нужно изменить только два значения в учётных данных OpenAI — Base URL и API-ключ. Остальная часть рабочего процесса остаётся такой же, как и для любого узла OpenAI.

Обновлено

Изометрический автоматизированный рабочий процесс с подключенными блоками, отправляющими данные в терминал API

Ключевые моменты

Что вам нужно перед началом

Экземпляр n8n (облачный или размещённый самостоятельно) и API-ключ от этого сервиса. Если у вас ещё нет ключа, на странице API-ключ вы пройдёте регистрацию через Google или по электронной почте и паролю. Новые пользователи могут активировать $0,50 пробного баланса одним нажатием на этой странице; он действителен в течение 7 дней и без привязки карты.

В n8n нужно ввести три значения:

  • Базовый URL: https://api.onekeyllmapi.com/v1
  • API-ключ: отправляется как Authorization: Bearer <key>, что n8n делает за вас
  • Идентификатор модели: uncensored

Сервис представляет собой размещённый текстовый LLM API, который следует формату запросов OpenAI для /v1/chat/completions, /v1/responses и /v1/models. Это не официальный API какого-либо вендора моделей, поэтому любой запрос, который n8n отправляет в чат-эндпоинт OpenAI, работает здесь, если это текстовый запрос.

Шаг 1: Создание учетных данных

В n8n откройте Credentials, выберите Create credential и найдите OpenAI API. Заполните его следующим образом:

  1. Вставьте свой ключ в поле API Key.
  2. Оставьте поле Organization ID пустым.
  3. Замените значение по умолчанию Базовый URL на https://api.onekeyllmapi.com/v1. Оставьте /v1 в конце и не добавляйте /chat/completions.
  4. Сохраните. n8n выполняет небольшой тестовый вызов при сохранении; если он не удался, перейдите к разделу устранения неполадок ниже.

Храните по одному набору учетных данных для каждой среды. Если вы запускаете n8n в среде разработки и в продакшене, назначьте каждому свой ключ, чтобы можно было видеть расходы отдельно и отозвать один ключ, не затрагивая другой.

Шаг 2: Создание простого чат-рабочего процесса

Начните с самого простого, что доказывает подключение: ручной триггер и один вызов модели.

  1. Добавьте узел Ручной триггер.
  2. Добавьте узел OpenAI (или под-узел OpenAI Chat Model внутри Basic LLM Chain, в зависимости от версии n8n) и выберите учетные данные из шага 1.
  3. Для модели найдите способ ввести идентификатор вручную. В последних версиях n8n есть режим По ID рядом со списком. Введите туда uncensored. Список может быть пустым или показывать только имена OpenAI, так как n8n фильтрует его на своей стороне.
  4. Добавьте промпт, например Кратко опишите эту заявку в поддержку в двух предложениях, и запустите узел.

Если ваша версия n8n настаивает на выборе из списка, используйте подход с HTTP-запросом в следующем разделе. Он всегда работает, так как вы контролируете весь запрос.

Вызов API с помощью узла HTTP-запрос

Узел HTTP-запрос — самый предсказуемый способ вызова этого API из n8n, и он предоставляет все параметры, которые принимает API, включая seed, stop, top_p и tools. Настройте его следующим образом:

  • Метод: POST
  • URL: https://api.onekeyllmapi.com/v1/chat/completions
  • Аутентификация: Generic Credential Type с Header Auth, имя Authorization, значение Bearer YOUR_KEY
  • Отправить тело: да, тип контента JSON

Body (переключите поле на Expression, если хотите вставить данные из предыдущих узлов):

{
  "model": "uncensored",
  "messages": [
    {"role": "system", "content": "You are a concise assistant."},
    {"role": "user", "content": "Summarize this support ticket in two sentences."}
  ],
  "temperature": 0.4
}

Текст ответа находится по адресу choices[0].message.content. В следующем узле вы можете сослаться на него с помощью {{ $json.choices[0].message.content }}.

Чтобы протестировать тот же запрос вне n8n, выполните это в терминале:

curl https://api.onekeyllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

Если curl работает, а n8n нет, проблема в настройках узла, а не в вашем ключе или балансе.

JSON-режим для рабочих процессов, анализирующих вывод

Рабочие процессы ломаются, когда модель оборачивает данные в связный текст. JSON-режим просит API вернуть валидный объект JSON, который можно сразу передать в узел Set или IF. Добавьте response_format в тело запроса:

{
  "model": "uncensored",
  "response_format": {"type": "json_object"},
  "messages": [
    {"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
    {"role": "user", "content": "The delivery was late but support fixed it fast."}
  ]
}

Две привычки делают это надежным. Во-первых, укажите слово JSON и назовите ключи в промпте, так как JSON-режим гарантирует синтаксис, а не вашу схему. Во-вторых, ответ все еще приходит как строка в message.content, поэтому добавьте узел Code или выражение с JSON.parse() перед чтением полей. В узле OpenAI тот же переключатель появляется как опция Формат ответа в настройках узла.

Обработка ошибок 429 и других ошибок

n8n обрабатывает элементы параллельно, поэтому пакет из 50 строк может быстро достичь лимитов. Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту; пробный ключ — 2 и 60 соответственно. При превышении лимитов API возвращает HTTP 429 с кодом rate_limited (слишком много запросов в минуту) или concurrency (слишком много параллельных запросов). При временной перегрузке вы получите 429 с заголовком Retry-After: 5.

Практические настройки в n8n:

  • Откройте узел, перейдите в Settings, включите Retry On Fail, установите Max Tries на 3 или 4, а Wait Between Tries на 5000 мс.
  • Поместите узел Loop Over Items (размер пакета от 4 до 6) перед вызовом модели, чтобы оставаться ниже 8 параллельных запросов.
  • В настройках узла Settings, On Error можно установить как продолжение с выводом ошибки, чтобы одна плохая строка не останавливала запуск.

Для более глубокого изучения двух видов лимитов прочтите документацию API. Другие ошибки просты: 401 означает, что ключ неверен или в заголовке отсутствует слово Bearer, а 404 обычно означает опечатку в базовом URL или лишний сегмент пути.

Чек-лист устранения неполадок

Большинство сбоев происходит по короткому списку причин. Пройдите по нему сверху вниз, прежде чем подозревать сервис.

СимптомВероятная причинаИсправление
401 при сохранении или запускеНеверный ключ или отсутствие Bearer в заголовкеВставьте ключ снова; в Header Auth значение должно начинаться с Bearer
404В базовом URL есть опечатка или лишний путьИспользуйте ровно https://api.onekeyllmapi.com/v1 в учетных данных
Модель не найденаИдентификатор модели введён не как uncensoredПереключитесь на режим «По ID» или используйте узел «HTTP Request»
429 с ограничением параллельных запросовБолее 8 параллельных запусков (2 для ключа пробного периода)Пакетная обработка с циклом и добавлением повторных попыток
Ошибка парсинга JSON на следующем этапеОтвет — строка, либо в промпте не указаны имена ключейПарсите с помощью JSON.parse() и опишите ключи в системном промпте

При обращении в службу поддержки включите заголовок ответа X-Request-Id из неудачного вызова. В n8n заголовки можно увидеть, включив опцию Include Response Headers and Status в настройках узла «HTTP-запрос».

Тестирование без больших затрат

Используйте пробный баланс, пока вы разрабатываете. При 2 параллельных запросах и 60 запросах в минуту пробный ключ медленный для пакетов, но вполне достаточен для проверки учетных данных, промпта и логики парсинга. Переключитесь на полный ключ, когда переведёте рабочий процесс в расписание.

Стоимость и продуманный дизайн рабочего процесса

Оплата по факту использования: $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов, списываемые с предоплаченного баланса. Рабочий процесс, классифицирующий 1 000 писем в день с 600 входными и 100 выходными токенами на каждое, использует 0,6M входных токенов ($0,09) и 0,1M выходных токенов ($0,05), что составляет около $0,14 в день. Неудачные или отклонённые запросы не оплачиваются, поэтому повторные попытки при ошибках не удваивают счёт. Подробности на странице цен.

Держите промпты короткими, отправляйте только поля, необходимые модели, и устанавливайте max_tokens, если вы знаете, что ответ будет кратким. Если вы также запускаете модели на своём компьютере, ознакомьтесь со статьёй о использовании локальной LLM через API в стиле OpenAI, которая использует те же настройки клиента.

Вопросы и ответы

Какие узлы n8n работают с пользовательским базовым URL?

Любой узел, использующий учётные данные OpenAI, может использовать их, так как поле Base URL принадлежит учётным данным. Если узел не предоставляет нужный вам параметр, используйте узел HTTP Request.

Почему список моделей пустой или неверный в n8n?

n8n загружает и фильтрует список на своей стороне. Введите ID модели uncensored вручную или используйте узел HTTP Request, где модель — это просто поле в теле запроса.

Можно ли использовать потоковую передачу в n8n?

API поддерживает потоковую передачу через SSE, но большинство узлов n8n ждут полный ответ, прежде чем передать данные. Для рабочих процессов обычный непотоковый вызов проще.

Как проверить баланс из рабочего процесса?

Вызовите GET /v1/balance или прочитайте заголовок X-Balance-USD в любом ответе и добавьте узел IF, который оповестит вас, когда баланс опустится ниже порога.

Ваш ключ — всего в одном шаге

Создайте аккаунт, скопируйте ключ, измените базовый URL. Вот и вся настройка.