Создайте и защитите API-ключ

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

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

Создание и сохранение

Нажмите «Создать», укажите понятное имя нагрузки, выберите срок действия и проверьте показанные права по умолчанию. Сейчас экран предлагает 30, 60 или 90 дней и показывает models:read и inference:write; редактора произвольных прав в нём нет. После создания один раз скопируйте полное значение в менеджер паролей или системное хранилище. Подтвердите, что значение сохранилось в месте назначения, прежде чем закрыть одноразовое окно. Позже список не покажет полный секрет. Не помещайте его в репозиторий, URL, скриншот, историю команд или сообщение поддержке. Для клиентов под управлением CLI управление ключами CLI сохраняет ключ через системное хранилище.

Установите лимиты ключа

Откройте у ключа Лимиты ключа, чтобы сузить его доступ, не меняя организацию. Оставьте настройку унаследованной, чтобы она следовала изменениям организации и тарифа, или выключите наследование и выберите разрешённые модели и возможности. Пустой выбор запрещает соответствующую категорию. Ограничения одновременных запросов и частоты — положительные целые числа; PostgreSQL проверяет их атомарно для общей бюджетной lineage ключа, включая повторы и ротацию. Модели берутся из живого Graphile-каталога. Эти настройки не расширяют доступ организации или тарифа.

Измените права

В списке ключей откройте «Права ключа» у нужной строки. Владелец или администратор организации может включить или выключить чтение каталога models:read и генерацию inference:write. Сохраните изменения; при ошибке выбор остаётся в открытом окне. Отключённые права перестают действовать со следующего API-запроса. Изменение прав сохраняет секрет, срок действия и бюджет ключа; оно не расширяет доступ организации или тарифа.

Проверьте до платного вызова

Вызовите с новым ключом бесплатный GET /v1/models по инструкции первого API-запроса. Ожидаются HTTP 200 и массив data с каноническими ID моделей, видимых ключу. Отображаемое имя нельзя подставлять вместо ID. При 401 проверьте Bearer-заголовок, состояние и срок ключа. При 403 или неожиданно пустом каталоге проверьте организацию и права до генерации.

Только после этой бесплатной проверки отправляйте первый ограниченный Responses-запрос. Он может списать кредиты. Сохраните публичный ID запроса и проверьте исход в активности API. Бесплатная проверка каталога не является оплачиваемой генерацией и не должна выглядеть как строка активности.

Замените или отзовите

Список показывает имя, маску-префикс, состояние, права, дату создания, последнее использование при наличии и срок действия. При потере полного значения создайте новый ключ: старое нельзя восстановить из метаданных. Проверьте замену бесплатным каталогом моделей, обновите каждый клиент старого ключа и затем отзовите его. Текущий экран не ротирует ключ одним действием: создание замены и отзыв требуют отдельных подтверждений. При подозрении на раскрытие быстро отзовите затронутый ключ и выпустите новый; безопасность аккаунта подскажет, какие ещё сессии и доступы проверить.

Отзыв останавливает выбранный API-ключ. Он не завершает сессию браузера и не отзывает OAuth-авторизацию CLI. Проверьте в списке, что старый ключ неактивен, а нужный клиент работает с заменой. При ошибке используйте авторизацию и ошибки и лимиты; поддержке передавайте только публичный ID запроса и безопасный код.