Подключение ИИ: подписка или API-токены
Раздел: Документация Neiron. Обновлено: 01.10.2026, версия 3. Адрес для людей: https://neiron.org/docs/podklyuchenie-ii/
Зачем это нужно
Агенты Neiron думают с помощью языковой модели (LLM): Claude от Anthropic, GPT от OpenAI, DeepSeek или любая из 400+ моделей через OpenRouter. Пока модель не подключена, агенты не работают. Поэтому это первый шаг после входа в админ-панель.
Модель вы оплачиваете провайдеру сами, напрямую. Деньги за ИИ через Neiron не проходят.
Подписка или API-токены
| Подписка | API-токены | |
|---|---|---|
| Что это | Тариф Claude или ChatGPT — тот же, что для обычного чата | Ключ API провайдера: Claude, ChatGPT, DeepSeek или OpenRouter. Оплата за каждый запрос |
| Как платите | Фиксированная сумма раз в месяц | Пополняете баланс у провайдера, расход списывается по факту |
| Ограничения | Лимиты на сессию (несколько часов) и на неделю | Только баланс и лимит, который вы сами поставили на ключ |
| Когда выбирать | Основной вариант для агентов: расходы предсказуемы | Нужны модели, которых нет в подписке; недорогая модель для простых задач; расшифровка голосовых |
С чего начать: подписка Claude Max 20x ($200 в месяц). Если агентов мало и задачи простые, хватит Max 5x ($100). ChatGPT хорошо работает с картинками и презентациями, и его проще оплатить, если с Claude не получилось.
Совет. Если вы сами активно пользуетесь Claude или ChatGPT, заведите для агентов отдельную подписку. Иначе вы с агентами делите одни лимиты, и в самый нужный момент их не хватит.
Какие модели можно подключить по API-токенам
По API-ключу модель подключается двумя способами: напрямую у разработчика модели или через OpenRouter, где по одному ключу доступны сразу сотни моделей.
| Провайдер | Что даёт | Где взять ключ |
|---|---|---|
| Claude (Anthropic) | Модели Claude напрямую | Claude Console → Settings → API keys. Ключ начинается с sk-ant- |
| ChatGPT (OpenAI) | Модели GPT напрямую и расшифровка голосовых | platform.openai.com/api-keys. Ключ начинается с sk- |
| DeepSeek | Модели DeepSeek напрямую, обычно дешевле Claude и GPT | platform.deepseek.com → API keys. Ключ начинается с sk- |
| OpenRouter | 400+ моделей по одному ключу и с одного баланса: Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, Llama и другие | openrouter.ai/settings/keys. Ключ начинается с sk-or-v1- |
Пошагово для OpenRouter — на странице Как подключить OpenRouter.
Что важно знать про API-ключи:
- Ключ и подписка — разные вещи. Подписка Claude Max или ChatGPT не даёт API-ключа, а API оплачивается отдельно, с баланса у провайдера.
- Ключ показывается один раз. Сразу скопируйте его и вставьте в админ-панель. Не присылайте ключ агенту в чат: модель видит всё, что написано в переписке. Подробнее — в главе Безопасность.
- Начинайте с небольшой суммы. Пополните баланс на $10–20 и не включайте автопополнение, пока не поймёте, сколько тратят агенты. У OpenRouter на каждый ключ можно поставить свой лимит расхода.
Важно. Anthropic и OpenAI не работают с Россией: Россия не входит в список стран, где доступен их API, а российские карты они не принимают. OpenRouter принимает зарубежные карты, AliPay и криптовалюту USDC. Российские карты, как правило, не проходят и там.
Где подключается
Всё подключается в админ-панели:
- Нажмите на шестерёнку в правом верхнем углу — откроется окно настроек.
- Первая вкладка — подписки. Кнопки «Авторизоваться через Claude» и «Авторизоваться через ChatGPT».
- Вторая вкладка — API-ключи. Сюда вставляется ключ Claude, OpenAI, DeepSeek или OpenRouter.
При первом входе в админ-панель кнопка подключения подписки есть и в центре экрана.
Пошагово, с регистрацией и оплатой, — на страницах Как подключить подписку Claude, Как подключить подписку ChatGPT и Как подключить OpenRouter.
Несколько подписок
- Можно подключить несколько подписок, в том числе Claude и ChatGPT одновременно.
- Если подключено две и больше подписок Claude, система сама распределяет запросы и выбирает менее загруженную.
- Подписку можно закрепить за отделом или группой агентов. Например, отдельная подписка только для отдела продаж.
- Задать долю расхода на отдел, сотрудника или агента нельзя: провайдер показывает только общий остаток лимита.
Какую модель использует агент
Модель выбирается для каждого агента отдельно: админ-панель → агент в списке слева → раздел «Модель и размышление».
- Выберите провайдера: Claude, OpenAI, DeepSeek или OpenRouter.
- В поле «LLM модель» выберите модель из подсказки. Для OpenRouter впишите ID модели целиком, вместе с названием компании, например
moonshotai/kimi-k3. - Нажмите «Сохранить настройки».
Диалог при смене модели не теряется.
Как выбирать:
- сложный анализ, стратегия, разработка навыков и страниц → самая сильная модель;
- регулярные отчёты, форматирование, типовые ответы → более экономичная;
- картинки, графика, презентации → GPT;
- много простых однотипных задач → недорогая модель: DeepSeek или модель через OpenRouter.
Примечание. Не каждая модель справится с работой агента. Агент не просто пишет текст: он читает файлы, запускает навыки, работает с таблицами и сервисами. Для этого модель должна уметь вызывать инструменты (tools). Лучше всего это получается у Claude и GPT, их мы и рекомендуем как основные. Другую модель сначала проверьте на одном второстепенном агенте и только потом переводите на неё важную работу.
Как следить за расходом
- В админ-панели: «Дашборд» → «Операционный дашборд» → блок «Расход токенов по агентам». Период выбирается сверху. Для подписки там показано, сколько стоили бы запросы по ценам API. Так видно, какой агент тратит больше всех.
- Остаток лимитов подписки — «Дашборд» → «Лимиты подписок». У каждой подписки отображается свой доступный лимит на текущую сессию, недельный лимит и опционально лимит на конкретные модели.
- Расход по API-ключу — в личном кабинете провайдера. У OpenRouter это openrouter.ai/activity: расход по дням, моделям и ключам.
Больше всего лимитов съедают задачи по расписанию, которые часто запускают модель. Задача раз в 2 минуты, которой нужна модель, выберет лимит быстрее всех. Такие задачи делайте скриптами без ИИ или запускайте реже — см. Задачи по расписанию.
В Дашборде в блоке Расход токенов по агентам можно отслеживать сколько токенов расходует каждый агент за выбранный интервал времени. Поле стоимость показывает сколько стоят израсходованные токены. Но если вы работаете на подписке, то вы за них не платите, это справочная информация сколько вы заплатили бы, если бы работали через API токены.
Голосовые сообщения: нужен ключ OpenAI API
Голосовые расшифровывает модель OpenAI по API. Подписка ChatGPT для этого не подходит — это разные вещи. Без ключа агент попросит написать текстом.
Коротко: карта и баланс на platform.openai.com (от $5, хватает примерно на 14 часов записи) → Settings → API keys → Create new secret key → ключ в админ-панель: шестерёнка → вкладка «API-ключи». Пошагово, с картой, VPN, лимитом расхода и проверкой — на странице Распознавание голосовых сообщений.
Если агенты перестали отвечать
| Что видите | Что делать |
|---|---|
| Агент пишет про лимиты или не отвечает до конца дня | Кончился лимит сессии или недели. Подождите сброса, подключите ещё одну подписку или переключите агента на другую модель |
| Ошибка авторизации, просьба переподключить подписку | Шестерёнка → «Удалить» рядом с подпиской → «Авторизоваться» заново |
| Подписка ChatGPT регулярно слетает | Этим же аккаунтом входят где-то ещё, например в Codex или другой программе, и вход в Neiron сбрасывается. Заведите для Neiron отдельный аккаунт и переподключите подписку |
| Ошибка про оплату или баланс, например 402 Payment Required | На API-ключе кончились деньги или сработал лимит ключа. Пополните баланс у провайдера или поднимите лимит |
| Ошибка ключа, например 401 или Invalid API key | Ключ удалён, перевыпущен или скопирован не полностью. Создайте новый и вставьте его в админ-панель заново |
| Голосовые не расшифровываются | Нет ключа OpenAI API или на нём кончился баланс — см. Распознавание голосовых сообщений |
Полный список ошибок с их текстами и способами исправления — на странице Ошибки и как их исправить.