Ключи организации

Откуда берутся деньги

Если ваша организация подключена к epicai, ключ на организацию выпускает её администратор. В кабинете организации, в разделе API он выбирает сотрудника и создаёт ключ. Ключ показывается один раз, администратор передаёт его сотруднику. Запросы по такому ключу оплачиваются из кошелька организации. Личный баланс сотрудника остаётся нетронутым. Резерв, списание и сумма в epic.cost_tok работают так же, как у личного ключа, описанного в статье Баланс и списание в API.

Чьим считается ключ

Ключ организации привязан к сотруднику, на чьё имя его выпустили, и действует, пока тот состоит в организации. Сам сотрудник такой ключ не создаёт, не меняет и не отзывает. В кабинете разработчика он видит ключи, выпущенные на его имя, а управляет ими администратор. Если сотрудника отключили или организация заморожена, ключ перестаёт работать с ответом 403 organization_inactive. Личные ключи того же человека это не затрагивает. На одного сотрудника может быть выпущено до 20 действующих ключей в одной организации.

Лимиты и расход

К ключу организации применяются те же настройки, что к личному, плюс лимиты самой организации и сотрудника. Достижение лимита даёт 402 organization_limit_reached, и текст сообщения называет исчерпанный лимит. Когда в кошельке не хватает токенов, приходит 402 insufficient_funds, как и с личным ключом.

Задачи с картинками, видео и другими медиа платятся из того же кошелька. Результат такой задачи можно забрать любым ключом того же сотрудника.

Запрос GET /v1/account для такого ключа показывает баланс кошелька, в нём source равен organization и добавлено organization_id. Запрос GET /v1/usage суммирует расход ключей этого сотрудника в организации, личные ключи в него не входят. Администратор организации выпускает, меняет и отзывает ключи сотрудников и видит расход по ним в кабинете организации.