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-ключом
- Создайте ключ для одного сценария
В кабинете создайте отдельный ключ, например для терминала или одной IDE.
- Выберите подходящий клиент
Откройте каталог моделей, затем инструкцию нужного клиента в разделе интеграций.
- Передайте ключ без репозитория
Используйте переменную окружения, системное хранилище секретов или защищённую настройку клиента. Не добавляйте ключ в исходный код и не отправляйте его в скриншотах.
- Проверьте один запрос
Сделайте короткий запрос и откройте журнал. Так проще увидеть, что адрес и модель указаны правильно.
Что стоят подписки и что в них входит
Цены и лимиты подписок меняются отдельно от Relay, поэтому ниже данные со страниц вендоров на 14 октября 2026 (ссылки в конце статьи). Перед решением откройте их заново.
| Тариф | Цена | Что входит | Для кого |
|---|---|---|---|
| Claude Pro | 20 долларов в месяц, 17 при оплате за год (200 сразу) | лимиты обновляются в скользящем пятичасовом окне, плюс недельные лимиты | повседневная работа в чате |
| Claude Max | от 100 долларов в месяц | в 5 или 20 раз больше использования, чем в Pro | тяжёлая ежедневная работа |
| Claude Team | место Standard 25 долларов в месяц (20 при годовой оплате), Premium 125 (100) | места для команды от 2 до 150 человек | командная работа |
| ChatGPT Plus | 20 долларов в месяц | 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, деньги не спишутся. Пополнение баланса лимит не восстанавливает: его поднимают в настройках или ждут нового месяца.
Источники
Тарифы Claude, claude.com/pricing, проверено 14 октября 2026.
Цены Codex в планах ChatGPT, developers.openai.com, проверено 14 октября 2026.