К содержимому
Блог

API-ключ или подписка: что выбрать разработчику

API-ключ или подписка: что выбрать разработчику

Подписка обычно открывает функции внутри одного приложения. API-ключ даёт приложению или инструменту право обращаться к API по сети. Если вы хотите подключить IDE, CLI, свой сервис или локальный чат-интерфейс к Relay, нужен API-ключ.

Коротко

  • Подписка и API-ключ решают разные задачи.

  • Для Claude Code, Cursor, Codex CLI и Open WebUI используйте API-ключ Relay.

  • Отдельный ключ на клиент упрощает отзыв доступа и разбор ошибок.

Чем отличается API-ключ

Ключ передаётся в заголовке запроса или в настройке клиента. Он подтверждает, что вызов разрешён. Подписка в стороннем приложении сама по себе не создаёт ключ Relay и не настраивает адрес API.

В Relay ключ создаётся в разделе «Ключи». Там же удобно разделить доступ: отдельный ключ для Cursor, отдельный для Claude Code и ещё один для серверного приложения. При ошибке или смене устройства вы сможете отозвать только нужный ключ, не останавливая остальные интеграции.

Когда нужен API-ключ

API-ключ выбирают, если запросы идут из кода, терминала или стороннего клиента. Для Claude Code ключ передают через ANTHROPIC_AUTH_TOKEN. Для Cursor, Codex CLI и Open WebUI используют настройки OpenAI-совместимого подключения и адрес https://relay-llm.ru/v1.

Подписка на чат-приложение может быть удобна для работы в его интерфейсе, но не заменяет конфигурацию стороннего API. Клиенту всё равно требуются базовый адрес, протокол и идентификатор модели.

Безопасный старт с API-ключом

  1. Создайте ключ для одного сценария

    В кабинете создайте отдельный ключ, например для терминала или одной IDE.

  2. Выберите подходящий клиент

    Откройте каталог моделей, затем инструкцию нужного клиента в разделе интеграций.

  3. Передайте ключ без репозитория

    Используйте переменную окружения, системное хранилище секретов или защищённую настройку клиента. Не добавляйте ключ в исходный код и не отправляйте его в скриншотах.

  4. Проверьте один запрос

    Сделайте короткий запрос и откройте журнал. Так проще увидеть, что адрес и модель указаны правильно.

Что стоят подписки и что в них входит

Цены и лимиты подписок меняются отдельно от Relay, поэтому ниже данные со страниц вендоров на 14 октября 2026 (ссылки в конце статьи). Перед решением откройте их заново.

ТарифЦенаЧто входитДля кого
Claude Pro20 долларов в месяц, 17 при оплате за год (200 сразу)лимиты обновляются в скользящем пятичасовом окне, плюс недельные лимитыповседневная работа в чате
Claude Maxот 100 долларов в месяцв 5 или 20 раз больше использования, чем в Proтяжёлая ежедневная работа
Claude Teamместо Standard 25 долларов в месяц (20 при годовой оплате), Premium 125 (100)места для команды от 2 до 150 человеккомандная работа
ChatGPT Plus20 долларов в месяцCodex в составе, объём рассчитан на несколько сфокусированных сессий в неделюэпизодическая помощь с кодом
ChatGPT Proот 100 долларов в месяц (планы за 100, 200 или 500)Codex в составе, план выбирается по объёму использованиядлинные ежедневные сессии

Это цены за место или аккаунт в приложении вендора. Ключ Relay оплачивается иначе: токены списываются с баланса по ставкам модели, а месячный потолок вы задаёте сами, лимитом на ключе.

Подписка или токены: как посчитать для себя

Сравнивать нужно не «дорого или дёшево» вообще, а свой месяц с фиксированной суммой подписки. Откройте журнал запросов, выгрузите расход за типичную неделю и умножьте на 4,3: получится оценка месяца по токенам. Формулу цены вызова и список полей usage описывает статья о стоимости запросов.

Пример на условных числах. Журнал показал 3 доллара за неделю: за месяц выйдет около 13 долларов, и токены дешевле подписки за 20. Если неделя обходится в 6 долларов, месяц выходит около 26, и подписка выгоднее. Четыре типовых профиля выглядят так:

  • Редкий чат, несколько обращений в неделю. Токенов уходит мало, и оплата по ним дешевле почти при любой модели. Подписка оправдана, если нужны её собственные функции: веб-чат, проекты, файлы.

  • Ровная ежедневная работа человека в IDE или терминале. Расход предсказуем, поэтому сравнивайте оценку месяца с ценой тарифа. Предсказуемость можно получить и на токенах: поставьте на ключ месячный лимит, и худший месяц ограничен суммой, которую вы выбрали.

  • Рваная нагрузка: две недели интенсивной работы, затем пауза. Подписку платят целиком, даже если работа стояла неделю, а токены оплачиваются только по факту.

  • Автоматизация: CI, ночные прогоны, агенты, которые вызывают Relay напрямую. Подписка вендора ключ Relay не создаёт, а прямым вызовам нужен именно он, поэтому выбор здесь внутри токенов: какая модель и какой лимит. Вендорские CLI умеют входить и по аккаунту подписки, но это отдельный расчёт по правилам вендора.

Мы бы для разработки через IDE, CLI и свой код брали ключ с месячным лимитом, а подписку оставляли отдельной покупкой, если нужен чат вендора как таковой. Фиксированный счёт, который продаёт подписка, лимит ключа даёт так же, только с суммой, выбранной вами.

Как не потерять ключ

Не храните ключ в .env, если этот файл может попасть в git, и не вставляйте его в клиентский JavaScript. Секрет в браузере могут увидеть пользователи сайта, расширения и средства отладки. Серверное приложение должно брать ключ только из своего защищённого окружения.

Если ключ оказался в коммите, отзовите его сразу, создайте новый и перепишите историю публикации, если она доступна. Простое удаление строки в следующем коммите не делает старый секрет безопасным.

Для проблем с 401 сначала проверьте, что ключ не отозван, а клиент использует именно Relay URL. Полный формат ошибок описан в документации.

Нужна ли подписка, чтобы создать API-ключ Relay?

Нет. Ключ выпускается в кабинете Relay после подтверждения почты, подписка вендора для этого не нужна. Настройка клиента начинается с ключа Relay и адреса API: условия сторонних приложений относятся к их собственному интерфейсу и не подменяют ключ.

Можно ли дать один ключ всей команде?

Лучше не делать так. Отдельные ключи для людей и окружений позволяют отозвать доступ точечно и быстрее найти источник ошибки. У каждого ключа свой лимит расхода и своя история запросов, поэтому по одному ключу видно, кто и сколько потратил. Аккаунт принимает до 50 ключей.

Где посмотреть, использовался ли ключ?

После вызова проверьте журнал запросов. На странице ключа видны время последнего запроса, израсходованная сумма, остаток лимита и число запросов за 30 дней. Для смены или отзыва ключа вернитесь в раздел ключей.

Как ограничить месячный расход ключа?

В настройках ключа задайте лимит на месяц, на день или на всё время в долларах. Запрос сверх лимита получит ошибку key_limit_exceeded, деньги не спишутся. Пополнение баланса лимит не восстанавливает: его поднимают в настройках или ждут нового месяца.

Источники

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.