provod.ai / docs
API

Управляющие ключи

Ключи, лимиты и отчёты рабочего пространства через API.

Обновлено

Управляющий ключ позволяет серверу управлять обычными API-ключами и читать расходы рабочего пространства. Для запросов к моделям нужен обычный API-ключ.

Создать управляющий ключ

  1. Откройте управляющие ключи в кабинете.
  2. Выберите личное рабочее пространство или организацию.
  3. Создайте ключ с понятным названием.
  4. Сохраните секрет ключа в хранилище секретов сервера. Он показывается один раз.

Ключ привязан к одному рабочему пространству. Для другого пространства создайте отдельный ключ. Не передавайте scope или X-Org-Id для переключения. Не храните секрет в браузере или репозитории.

Методы API

Какой ключ использовать

ЗадачаКлюч
POST /v1/chat/completions, /v1/responses, /v1/messagesОбычный API-ключ
GET /v1/balance, GET /v1/usageОбычный API-ключ
Управление ключами и отчёты рабочего пространстваУправляющий ключ
GET /v1/key, GET /v1/generationОба типа, в пределах своего доступа

Остаток и расходы

Права и отзыв

Создание и отзыв управляющих ключей выполняются в кабинете с веб-сессией. Права организации: managementKeys.read, managementKeys.create, managementKeys.revoke. Они не передаются в Bearer-запросах. Публичные методы проверяют действующие права владельца ключа. Отозванный ключ восстановить нельзя.

На этой странице