Управление ключами

API-ключи создаются и отзываются в консоли разработчика, вкладка API-ключи. Полный ключ и секрет подписи вебхуков показываются один раз при создании — сохраните их сразу. Как передавать ключ в запросах, описано на странице «Аутентификация».

Создание ключаСкопировать ссылку на раздел

Создание и ротация ключа требуют недавнего входа: если сессия старая, консоль попросит подтвердить вход и повторит действие сама. О созданном ключе и о ключе, отозванном в консоли, владелец аккаунта получает письмо — см. «Письма владельцу».

Что получает ключСкопировать ссылку на раздел

На аккаунте может быть до 20 активных ключей; истёкшие и те, что истекут в ближайшие сутки, например заменённые ротацией, не считаются. При превышении создание вернёт 400 с сообщением api_key_limit_reached.

Срок действия и бюджетСкопировать ссылку на раздел

Срок действия задаётся при создании и не продлевается: по истечении запросы с ключом получают 401 invalid_api_key, а в списке ключ помечен как истёк. Чтобы не прерывать интеграцию, ротируйте ключ заранее, не позже чем за сутки до конца срока, — новый получит такой же срок, отсчитанный от момента ротации.

Бюджет — потолок кредитов, которые ключ может потратить: за последние сутки, 7 или 30 суток (окно скользящее) или за всё время жизни ключа. Его задаёт владелец в консоли при создании ключа. Расход считается по журналу списаний и незавершённым работам этого ключа — генерациям, LLM-чату и MCP; возвращённые кредиты в него не входят.

Запуск генерации отклоняется с 402 и кодом insufficient_quota, если с ним расход превысит бюджет; запрос к чату — когда расход уже достиг бюджета. Одновременные запросы могут немного превысить бюджет. Чтение результата, статуса и каталога бюджет не блокирует. Отказ запуска выглядит так:

{
  "error": {
    "type": "billing_error",
    "code": "insufficient_quota",
    "message": "This request does not fit the remaining API key budget for the current period."
  }
}

В чате тот же код приходит в конверте OpenAI с type: insufficient_quota. Траты, вышедшие из окна, бюджет освобождают; бюджет «за всё время» сам не освобождается. Бюджет ограничивает один ключ и не меняет общий баланс аккаунта: он не защищает от трат по другим ключам. У нового ключа после ротации счётчик начинается с нуля.

Ротация ключаСкопировать ссылку на раздел

Нажмите Ротировать у активного ключа. Консоль создаст новый ключ с теми же названием, средой, правами, лимитами и бюджетом и покажет его полный ключ и секрет подписи вебхуков — один раз, как при создании. Старый ключ продолжает работать ещё 24 часа, затем истекает сам — отзывать его не нужно. Ключ, который истекает в ближайшие сутки, в том числе уже ротированный, ротировать нельзя: запрос вернёт 409 с кодом api_key_rotation_unavailable, создайте новый ключ.

Порядок без простоя: ротировать → обновить ключ и секрет в интеграции и обработчике вебхуков → убедиться, что запросы идут с нового ключа. У каждого ключа свой секрет, и вебхуки задач, отправленных старым ключом, подписаны старым. Держите в обработчике оба секрета, пока такие доставки не закончатся: повторы идут примерно 24 часа после завершения задачи.

Письма владельцуСкопировать ссылку на раздел

На email аккаунта приходят сервисные письма о событиях доступа: создан API-ключ (с названием и последними четырьмя символами; при ротации — какой ключ заменён), ключ отозван (при сбросе пароля отдельного письма об отзыве нет) и подключено приложение (новое OAuth-подключение, например Claude или ChatGPT). Секреты в письма не попадают. Если событие не ваше — отзовите ключ или отключите приложение в консоли и смените пароль.

Отзыв ключаСкопировать ссылку на раздел

Нажмите Отозвать у ключа в списке. Отзыв действует сразу, в худшем случае в течение минуты. После этого запросы с ключом получают 401 invalid_api_key.

Использование ключаСкопировать ссылку на раздел

Вкладка Логи консоли показывает запросы по ключам; для отказа в журнале хранится код ошибки (invalid_request, not_found), а не её текст. Сводку за 30 дней по текущему ключу возвращает GET /v1/account, а для LLM-клиентов — GET /v1/key.