Как подключить YandexGPT к n8n

YandexGPT подключается к n8n обычным HTTP-запросом. Отдельный модуль не нужен. Ниже пример для сценария ответов на отзывы, но схема подходит для любой задачи с текстом.

Шаг 1. Подготовить Yandex Cloud

1. В консоли Yandex Cloud создайте каталог для сценариев или используйте существующий. Скопируйте его идентификатор, он понадобится в запросе.
2. Создайте сервисный аккаунт и выдайте ему роль ai.languageModels.user в этом каталоге.
3. Создайте для сервисного аккаунта API-ключ и сохраните его. Ключ показывается один раз.

Шаг 2. Создать доступ в n8n

В n8n откройте Credentials и создайте доступ типа Header Auth:

• Name: Authorization
• Value: Api-Key ВАШ_КЛЮЧ

Так ключ не хранится в открытом виде внутри сценария.

Шаг 3. Настроить запрос

Добавьте узел HTTP Request:

• Method: POST
• URL: https://llm.api.cloud.yandex.net/foundationModels/v1/completion
• Authentication: Generic Credential Type → Header Auth → созданный доступ
• Send Body: JSON

Тело запроса:

{
  "modelUri": "gpt://ИДЕНТИФИКАТОР_КАТАЛОГА/yandexgpt-5-lite",
  "completionOptions": {
    "stream": false,
    "temperature": 0.3,
    "maxTokens": "500"
  },
  "messages": [
    {
      "role": "system",
      "text": "Ты отвечаешь на отзывы покупателей магазина одежды. Пиши дружелюбно, на «вы», до 400 символов. Не обещай компенсаций."
    },
    {
      "role": "user",
      "text": {{ JSON.stringify($json.text) }}
    }
  ]
}

Текст отзыва подставляется через JSON.stringify. Так кавычки и переносы строк внутри отзыва не ломают JSON.

В modelUri указывается конкретная модель. Для YandexGPT Lite 5 это yandexgpt-5-lite, для YandexGPT Pro 5.1 yandexgpt-5.1, для Alice AI LLM aliceai-llm. Старые адреса вида yandexgpt/latest работают только до окончания поддержки модели, после этого запросы вернут ошибку 400. Актуальный список моделей есть в документации Yandex AI Studio.

Шаг 4. Забрать ответ

Ответ модели лежит в поле:

{{ $json.result.alternatives[0].message.text }}

Передайте его дальше: в публикацию ответа или в Telegram на согласование.

Шаг 5. Отключить сохранение запросов

По умолчанию Яндекс может сохранять запросы для улучшения моделей. Чтобы этого не происходило, добавьте в узел заголовок x-data-logging-enabled со значением false.

Сколько это стоит

Оплата идёт за токены: входящий текст плюс ответ. Lite-модель заметно дешевле старшей. Чтобы оценить расходы, прогоните через сценарий 50–100 настоящих отзывов и посмотрите расход в разделе биллинга Yandex Cloud. Умножьте на ваш месячный объём.

Частые ошибки

• 401 или 403. Неверный ключ, у сервисного аккаунта нет роли ai.languageModels.user или в modelUri указан чужой каталог.
• 400. Сломанный JSON. Чаще всего из-за подстановки текста без JSON.stringify.
• 429. Слишком много запросов. Включите повтор с паузой.