Ключи доступа
Ключ — это то, чем ваш код представляется нашему API. Ключей может быть сколько угодно: разумно заводить по одному на сервис или на команду, чтобы в детализации было видно, кто именно расходует.
Выпуск
Кабинет → Компания → AI API → «Создать ключ».
При выпуске задаются три вещи, и все три необязательны, кроме имени:
| Поле | Что делает |
|---|---|
| Название | видно только вам и в детализации расхода |
| Потолок расхода | ключ перестаёт работать, когда потратит эту сумму; пусто — ограничением остаётся остаток компании |
| Доступные модели | ключ сможет вызывать только отмеченные; ничего не отмечено — доступны все |
Значение ключа показывается один раз. У нас оно не хранится — второй раз показать его неоткуда.
Ограничение по моделям
Самый частый сценарий — отдать подрядчику доступ к недорогой модели, не открывая дорогую. Ключ с ограничением на чужую модель отвечает отказом:
Список разрешённых моделей виден в кабинете рядом с ключом.
Отключение и удаление
Отключить — обратимое действие: ключ мгновенно перестаёт работать, запросы получают 401, но ключ остаётся в списке и включается той же кнопкой. Так удобно приостановить интеграцию на время разбирательства.
Удалить — необратимо. Ключ исчезает, и восстановить его нечем: доступ заводится новым ключом. Расход, который ключ успел сделать, остаётся в детализации — он уже случился.
Где посмотреть расход
Там же, в кабинете: сводка за период, разрез по ключам и по моделям, последние запросы и выгрузка построчно в CSV.
Расход появляется в кабинете не мгновенно: строка журнала создаётся в момент завершения запроса, а мы забираем журнал раз в несколько минут. Для потокового ответа это значит, что он попадёт в отчёт после того, как поток закончится.