> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> Как подключить нейросеть в n8n: модели RuAPI в рабочих процессах через OpenAI-узел и свой Base URL

[n8n](https://n8n.io) — платформа автоматизации с визуальным редактором и блоками для ИИ (AI Agent, OpenAI, цепочки). RuAPI подключается через **учётные данные OpenAI** с изменённым Base URL — после этого все AI-узлы ходят к нам.

## Предварительные требования

<Steps>
  <Step title="Аккаунт RuAPI и API-ключ">
    Консоль → **Токены** → создайте ключ `sk-...`. Баланс пополняется в USDT — см. [Пополнение](/ru/topup).
  </Step>
</Steps>

## Создание учётных данных

<Steps>
  <Step title="Добавьте OpenAI credential">
    В n8n: **Credentials → New → OpenAI**.
  </Step>

  <Step title="Заполните поля">
    | Поле         | Значение                                 |
    | ------------ | ---------------------------------------- |
    | **API Key**  | `sk-ваш-ключ`                            |
    | **Base URL** | `https://www.ruapi.ai/v1`  — **с** `/v1` |

    <Note>
      Поле **Base URL** может быть скрыто под «Дополнительно» (gear / Optional fields) в форме учётных данных OpenAI. Сохраните учётные данные.
    </Note>
  </Step>
</Steps>

## Использование в узле

<Steps>
  <Step title="Добавьте AI-узел">
    Перетащите узел **OpenAI** или **AI Agent** (с моделью OpenAI Chat Model) на холст.
  </Step>

  <Step title="Выберите учётные данные RuAPI">
    В узле в поле Credentials укажите созданные учётные данные.
  </Step>

  <Step title="Укажите модель">
    Впишите точный ID модели со [страницы цен](https://www.ruapi.ai/pricing). Если в выпадающем списке нужной модели нет — задайте ID вручную (режим «By ID» или выражение).
  </Step>
</Steps>

## Проверка

Запустите узел с простым запросом («Привет, ответь одним словом»). Успешный ответ + запись в Консоли RuAPI → **Логи** означают, что связка работает.

## Решение проблем

<AccordionGroup>
  <Accordion title="401 / Unauthorized">
    * API Key должен быть токеном RuAPI (`sk-...`).
    * Проверьте, что в учётных данных задан Base URL `https://www.ruapi.ai/v1` с `/v1`.
  </Accordion>

  <Accordion title="Не вижу поле Base URL">
    В форме OpenAI-учётных данных раскройте дополнительные/опциональные поля. В self-hosted и облачном n8n поле доступно в актуальных версиях.
  </Accordion>

  <Accordion title="Модель не подставляется из списка">
    Список в узле показывает модели OpenAI. Введите ID нужной модели вручную — он должен совпадать с RuAPI дословно.
  </Accordion>
</AccordionGroup>