Management API
Ключи sk-gw-mgmt-… на /management-keys — provisioning-доступ к аккаунту вместо обычных inference-ключей.
Страница Management API — отдельный тип ключей для автоматизации самого аккаунта: создания и отзыва обычных ключей, чтения баланса, расхода и транзакций. Полная схема эндпоинтов — в справочнике Management API; здесь — что это за ключи и как ими управлять в кабинете.
Чем отличается от обычного ключа
Обычный ключ (sk-gw-…) | Management-ключ (sk-gw-mgmt-…) | |
|---|---|---|
| Вызывает модели | Да | Нет |
| Управляет аккаунтом (ключи, баланс, транзакции) | Нет | Да |
| Можно создать по API | Да | Нет — только в кабинете |
| Лимит расхода / только чтение | Есть | Не применимо — сам ничего не тратит |
Management-ключ существует для одной задачи: чтобы ваш сервис сам выдавал ключи Hubris каждому своему клиенту, ставил им лимиты и отключал неплательщиков — без ручной работы в этом кабинете.
Создание
Единственное поле — название (например, «Бэкенд моего сервиса»). Полное значение ключа показывается один раз сразу после создания — сохраните его немедленно, дальше в базе остаётся только хеш.
Management-ключ управляет всем аккаунтом — храните его как пароль, а не как обычный API-ключ. Передавать его в клиентский код или агентам не стоит: им нужен обычный sk-gw-….
Создать management-ключ может только владелец кабинета — подрядчик с доступом к чужому кабинету (Кабинеты клиентов) этого сделать не может.
Лимиты
Все Management API эндпоинты ограничены 60 запросами в минуту на аккаунт — этого достаточно для обычной автоматизации, но не для вызова моделей в цикле (для этого он и не предназначен).
Список и отзыв
На странице — карточки активных ключей: название, статус по недавней активности, замаскированный префикс, даты создания и последнего запроса, кнопка «Отозвать». Отозванные ключи можно посмотреть в свёрнутом списке ниже, но восстановить нельзя — только создать новый.
Что дальше
- Справочник Management API — эндпоинты, параметры, ответы.
- Ключи и проекты — обычные ключи, которыми вызывают модели.
Обновлено: