API
Управляющие ключи
Ключи, лимиты и отчёты рабочего пространства через API.
Обновлено
Управляющий ключ позволяет серверу управлять обычными API-ключами и читать расходы рабочего пространства. Для запросов к моделям нужен обычный API-ключ.
Создать управляющий ключ
- Откройте управляющие ключи в кабинете.
- Выберите личное рабочее пространство или организацию.
- Создайте ключ с понятным названием.
- Сохраните секрет ключа в хранилище секретов сервера. Он показывается один раз.
Ключ привязан к одному рабочему пространству. Для другого пространства создайте отдельный ключ. Не передавайте scope или X-Org-Id для переключения. Не храните секрет в браузере или репозитории.
Методы API
| Метод | Назначение |
|---|---|
GET /v1/key | Текущий ключ |
GET /v1/keys | Список API-ключей |
POST /v1/keys | Создать API-ключ |
GET /v1/keys/{hash} | Получить API-ключ |
PATCH /v1/keys/{hash} | Изменить API-ключ |
DELETE /v1/keys/{hash} | Удалить API-ключ |
GET /v1/credits | Пополнения и расходы |
GET /v1/analytics/meta | Параметры аналитики |
POST /v1/analytics/query | Запрос аналитики |
GET /v1/activity | Активность по дням |
GET /v1/generation | Метаданные и стоимость запроса |
Какой ключ использовать
| Задача | Ключ |
|---|---|
POST /v1/chat/completions, /v1/responses, /v1/messages | Обычный API-ключ |
GET /v1/balance, GET /v1/usage | Обычный API-ключ |
| Управление ключами и отчёты рабочего пространства | Управляющий ключ |
GET /v1/key, GET /v1/generation | Оба типа, в пределах своего доступа |
Остаток и расходы
- Доступный баланс:
availableBalanceв GET /v1/balance, с учётом резервов. - Остаток лимита ключа:
limit_remainingи точные суммыspend_limitsв GET /v1/key. Это ограничение ключа, а не баланс пространства. - Пополнения и расходы за всё время: GET /v1/credits.
- Стоимость отдельного запроса:
usage.costиprovod.billing.total_charge. Формат JSON, SSE и восстановление после разрыва.
Права и отзыв
Создание и отзыв управляющих ключей выполняются в кабинете с веб-сессией. Права организации: managementKeys.read, managementKeys.create, managementKeys.revoke. Они не передаются в Bearer-запросах. Публичные методы проверяют действующие права владельца ключа. Отозванный ключ восстановить нельзя.