Что вам нужно перед началом
Экземпляр 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. Заполните его следующим образом:
- Вставьте свой ключ в поле API Key.
- Оставьте поле Organization ID пустым.
- Замените значение по умолчанию Базовый URL на
https://api.onekeyllmapi.com/v1. Оставьте/v1в конце и не добавляйте/chat/completions. - Сохраните. n8n выполняет небольшой тестовый вызов при сохранении; если он не удался, перейдите к разделу устранения неполадок ниже.
Храните по одному набору учетных данных для каждой среды. Если вы запускаете n8n в среде разработки и в продакшене, назначьте каждому свой ключ, чтобы можно было видеть расходы отдельно и отозвать один ключ, не затрагивая другой.
Шаг 2: Создание простого чат-рабочего процесса
Начните с самого простого, что доказывает подключение: ручной триггер и один вызов модели.
- Добавьте узел Ручной триггер.
- Добавьте узел OpenAI (или под-узел OpenAI Chat Model внутри Basic LLM Chain, в зависимости от версии n8n) и выберите учетные данные из шага 1.
- Для модели найдите способ ввести идентификатор вручную. В последних версиях n8n есть режим По ID рядом со списком. Введите туда
uncensored. Список может быть пустым или показывать только имена OpenAI, так как n8n фильтрует его на своей стороне. - Добавьте промпт, например Кратко опишите эту заявку в поддержку в двух предложениях, и запустите узел.
Если ваша версия 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, которая использует те же настройки клиента.
