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

Source: https://provod.ai/ru/docs/management-keys

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

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

1. Откройте [управляющие ключи](https://app.provod.ai/management-keys) в кабинете.
2. Выберите личное рабочее пространство или организацию.
3. Создайте ключ с понятным названием.
4. Сохраните секрет ключа в хранилище секретов сервера. Он показывается один раз.

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

## Методы API


| Метод                      | Назначение                                                     |
| -------------------------- | -------------------------------------------------------------- |
| `GET /v1/key`              | [Текущий ключ](/ru/docs/key-current)                           |
| `GET /v1/keys`             | [Список API-ключей](/ru/docs/keys-list)                        |
| `POST /v1/keys`            | [Создать API-ключ](/ru/docs/keys-create)                       |
| `GET /v1/keys/{hash}`      | [Получить API-ключ](/ru/docs/keys-get)                         |
| `PATCH /v1/keys/{hash}`    | [Изменить API-ключ](/ru/docs/keys-update)                      |
| `DELETE /v1/keys/{hash}`   | [Удалить API-ключ](/ru/docs/keys-delete)                       |
| `GET /v1/credits`          | [Пополнения и расходы](/ru/docs/credits)                       |
| `GET /v1/analytics/meta`   | [Параметры аналитики](/ru/docs/analytics-meta)                 |
| `POST /v1/analytics/query` | [Запрос аналитики](/ru/docs/analytics-query)                   |
| `GET /v1/activity`         | [Активность по дням](/ru/docs/activity)                        |
| `GET /v1/generation`       | [Метаданные и стоимость запроса](/ru/docs/generation-metadata) |


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


| Задача                                                       | Ключ                                |
| ------------------------------------------------------------ | ----------------------------------- |
| `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](/ru/docs/api-key-usage), с учётом резервов.
* **Остаток лимита ключа:** `limit_remaining` и точные суммы `spend_limits` в [GET /v1/key](/ru/docs/key-current). Это ограничение ключа, а не баланс пространства.
* **Пополнения и расходы за всё время:** [GET /v1/credits](/ru/docs/credits).
* **Стоимость отдельного запроса:** `usage.cost` и `provod.billing.total_charge`. [Формат JSON, SSE и восстановление после разрыва](/ru/docs/generation-metadata).

## Права и отзыв

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