Организации и общий баланс

Назначение

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

Роли

• owner — полное управление организацией и участниками.
• admin — управление участниками и доступами в рамках настроек.
• member — использование API с учетом правил организации.
• billing_viewer — просмотр финансовой статистики (если роль включена).

Как это работает

1. Пользователь состоит в организации.
2. Для него включен режим списаний с организационного баланса.
3. При вызовах API расход идет с общего кошелька организации.

Если режим выключен, расход идет с личного баланса пользователя.

Где смотреть баланс и usage

• личные API-метрики: через обычные ключевые endpoints;
• командные показатели: в разделах кабинета, где отображаются данные организации;
• технический контроль: по транзакциям и usage в административных разделах.

Практические рекомендации

• Используйте отдельные ключи для production/staging/dev даже внутри одной организации.
• Назначайте минимум один owner и один admin на команду.
• Регулярно проверяйте лимиты и остатки, особенно при batch-нагрузке.