API-ключи
Каждый запрос к API подписывается ключом. Ключи создаются в личном кабинете.
Как передать ключ
Ключ передаётся в заголовке Authorization со схемой Bearer. Других способов нет: запрос без такого заголовка получает 401.
Authorization: Bearer sk-...Создание ключа
Ключи создаются в разделе «Ключи» личного кабинета, до 50 на аккаунт. Ключ показывается один раз, при создании, — сразу сохраните его. Ключу можно дать название и лимит расхода.
Заводите отдельный ключ на каждое приложение, сервис или агента: так видно, кто сколько тратит, и любой ключ можно отключить, не трогая остальные.
Отключение, удаление и замена
Ключ можно временно отключить и снова включить. Удалённый ключ перестаёт работать сразу, а история его запросов остаётся в статистике. Запросы с отключённым или удалённым ключом получают 401.
Чтобы заменить ключ, например если он мог утечь, создайте новый, переключите на него приложение и удалите старый.
Обезличивание
При создании ключа можно включить обезличивание: тогда персональные данные из запросов не попадут к модели. Как это работает и какие запросы принимает такой ключ — на странице «Обезличивание данных».