Оглавление документации · Вся документация одним файлом

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

Раздел: Подключение ИИ: подписка или API-токены. Обновлено: 28.09.2026, версия 1. Адрес для людей: https://neiron.org/docs/openrouter/

OpenRouter — сервис-посредник между вами и разработчиками моделей. Один аккаунт, один баланс и один API-ключ дают доступ к 400+ моделям разных компаний: Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, Llama и другим. Модель у агента меняется одной строкой в настройках, без новых регистраций и оплат.

Когда подходит:

Понадобится: почта, способ оплаты (зарубежная карта, AliPay или криптовалюта USDC) и 15 минут.

Шаг 1. Зарегистрируйтесь

  1. Откройте openrouter.ai.
  2. Нажмите «Sign in» в правом верхнем углу и создайте аккаунт.

Шаг 2. Пополните баланс

  1. Откройте openrouter.ai/settings/credits.
  2. Нажмите кнопку пополнения («Add Credits») и введите сумму. Одно пополнение — от $5. Для начала хватит $10–20.
  3. Выберите способ оплаты:
    • банковская карта или AliPay — комиссия 5,5 %, минимум $0,80;
    • криптовалюта USDC — комиссия 5 %.

Карты российских банков, как правило, не проходят.

Что важно знать про оплату:

Совет. Если за всё время вы пополнили баланс на $10 и больше, у бесплатных моделей вырастет лимит: 1000 запросов в день вместо 50.

Шаг 3. Создайте API-ключ

  1. Откройте openrouter.ai/settings/keys.
  2. Нажмите «Create Key».
  3. Введите понятное название, например neiron.
  4. Поставьте лимит расхода на ключ, например $20. Лимит бывает разовым или обновляется раз в день, неделю или месяц. Если агент зациклится или ключ утечёт, больше лимита с ним не потратят.
  5. Скопируйте ключ — строку вида sk-or-v1-…. Целиком он показывается только один раз. Не успели скопировать — удалите ключ и создайте новый.

Важно. Не отправляйте ключ агенту в чат, в Telegram или по почте. Он вставляется только в админ-панель. Если ключ мог утечь, удалите его на openrouter.ai/settings/keys и создайте новый.

Шаг 4. Добавьте ключ в Neiron

  1. Откройте админ-панель и нажмите на шестерёнку в правом верхнем углу.
  2. Перейдите на вторую вкладку — API-ключи.
  3. Выберите OpenRouter, вставьте ключ и сохраните.

Шаг 5. Выберите модель

  1. Откройте каталог моделей: openrouter.ai/models.
  2. Оставьте только модели, которые умеют работать с инструментами. Эта ссылка сразу включает нужный фильтр: модели с поддержкой tools. Модель без инструментов может переписываться, но не сможет читать файлы, запускать навыки и работать с сервисами. Для агента она бесполезна.
  3. Откройте страницу модели. Там указаны:
    • ID модели вида компания/модель, например moonshotai/kimi-k3. Его нужно скопировать;
    • цена за 1 млн токенов — отдельно за вход (что модель читает) и за выход (что пишет);
    • контекст — сколько текста модель удерживает за один раз.

Модели с пометкой :free бесплатные, но с лимитом: 20 запросов в минуту и 50 в день, после пополнения на $10 — 1000 в день. На одну задачу агент делает несколько запросов, поэтому бесплатных моделей хватит только на то, чтобы попробовать.

Шаг 6. Переключите агента на модель

  1. Админ-панель → агент в списке слева → раздел «Модель и размышление».
  2. Провайдер — OpenRouter.
  3. В поле «LLM модель» вставьте ID модели целиком, вместе с названием компании: moonshotai/kimi-k3, а не kimi-k3.
  4. Нажмите «Сохранить настройки». Диалог с агентом при этом не теряется.
  5. Проверьте работу: дайте агенту задачу с действием, например «прочитай свою память и перескажи её в трёх пунктах». Если агент справился, через пару минут запрос появится на странице openrouter.ai/activity.

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

Совет. Начните с одного второстепенного агента и лимита $10–20 на ключе. Через пару дней посмотрите расход в Activity и решите, переводить ли на эту модель других агентов.

Какую модель выбрать

Если не работает

Что видитеЧто делать
Ошибка 402 Payment Required или про балансБаланс ушёл в ноль или в минус, либо ключ упёрся в свой лимит. Пополните баланс или поднимите лимит ключа на openrouter.ai/settings/keys
Ошибка 401 или «неверный ключ»Ключ удалён или скопирован не полностью. Создайте новый и вставьте его в админ-панель заново
Модель не найденаВ ID опечатка или нет названия компании. Скопируйте ID со страницы модели целиком
Агент отвечает, но ничего не делает: не читает файлы, не запускает навыкиМодель не поддерживает инструменты. Выберите модель по фильтру tools (шаг 5)
Бесплатная модель перестала отвечать к середине дняКончился дневной лимит бесплатных запросов. Подождите до завтра или переключите агента на платную модель
Модель недоступна в вашем регионеНекоторые разработчики закрывают свои модели для отдельных стран. Выберите другую модель