Управление доступами

Что такое Access Management

Access Management — это программный доступ к управлению доступами сотрудников бизнес-организации через API. Раздел позволяет управлять состоянием аккаунтов сотрудников:

• отключать и включать аккаунты сотрудников по списку логинов;
• менять роль сотрудников (owner / admin / member);
• задавать настройки доступа сотрудника (веб-поиск, генерация изображений, режим размышления, показ и списание баланса);
• задавать те же настройки для команды (по teamId);
• запрещать и разрешать конкретные модели сотрудникам и командам;
• задавать дневные и месячные лимиты по моделям для сотрудников и команд;
• задавать общий (сквозной) лимит по моделям для сотрудника и команды.

Авторизация

Все запросы выполняются по API-ключу организации (заголовок Authorization). Организация определяется по ключу — управлять можно только сотрудниками организации, которой принадлежит ключ. См. раздел С чего начать?.

Только бизнес-организация

Управление доступами недоступно из личного аккаунта. Если API-ключ создан в личном аккаунте (а не в бизнес-организации), любой запрос раздела вернёт 403 с кодом 13. Используйте ключ бизнес-организации.

Система ролей

Запрос выполняется от имени API-ключа, а ключ действует с ролью создавшего его пользователя (Owner, Admin или Member). Ключ управляет сотрудниками с ролью равной или ниже своей — но не своим собственным аккаунтом. Сотрудников с более высокой ролью изменять нельзя, а ключ с самой низкой ролью (Member) доступа к разделу не имеет.

Роли по уровню прав (сверху вниз): owner (высшая) → admin → member (низшая). Например, ключ с ролью admin управляет другими admin и member, но не owner и не собой.

Как в управлении сотрудниками

В разделе Управление сотрудниками действует то же правило — роль равная или ниже своей.