Команды: общий счёт, права и лимиты
Команда в API Весело: общий счёт на всех, люди по приглашению, права на виды моделей и лимиты на запрос, сутки и месяц, расход по людям.
Обновлено:
Команда — общий API-счёт для компании, студии или проекта. Владелец пополняет его, приглашает людей и решает, что каждому можно и сколько тратить. Люди работают своими ключами команды или подключают нейросети без ключа, а платит общий счёт. Людей в команде — сколько угодно.
Как завести команду
- Открой кабинет API → вкладка «Команда» → «Создать команду». Твой API-счёт станет общим счётом команды: деньги на нём остаются твоими, и тратить их своими ключами можно как раньше.
- Нажми «Пригласить»: выбери роль и готовый набор прав — «Разработчик», «Контент», «Бухгалтер» или «Наблюдатель» — или настрой права и лимиты сам.
- Отправь приглашение на почту или скопируй ссылку и передай её как удобно. Ссылка одноразовая и действует 7 дней; отозвать её можно в любой момент.
- Человек открывает ссылку, входит на veselo.ai — если аккаунта нет, заводит его тут же — и нажимает «Принять».
- Дальше он переключает кабинет на счёт команды (вверху, «Чей счёт») и выпускает ключ команды — или ключ выдаёт ему владелец.
Роли
| Роль | Что может |
|---|---|
| Владелец | Всё: пополняет счёт, приглашает и исключает людей, назначает администраторов, меняет права и лимиты, распускает команду. Сам без ограничений. Владелец у команды один, и общий счёт — его API-счёт. |
| Администратор | Приглашает людей, меняет права и лимиты участников, видит весь расход и журнал, выдаёт и отзывает ключи команды, пополняет счёт. Сам без ограничений. Других администраторов и владельца не меняет. |
| Участник | Тратит общий счёт — по своим правам и лимитам. |
Права участника
Новому участнику можно всё, кроме того, что закрыли в приглашении. Права меняются в любой момент в карточке человека и действуют со следующего запроса.
- Виды моделей — текст, картинки, видео, озвучка и музыка, распознавание речи, эмбеддинги, переранжирование. Запрос к закрытому виду получает 403
team_forbiddenдо удержания денег. - Модели без цензуры (18+) — закрыты, тоже 403
team_forbidden. - Выпускать свои ключи команды. Нельзя — ключ выдаёт владелец или администратор.
- Подключать нейросети без ключа — Claude, Cursor и другие программы по MCP: на экране «Разрешить» человек выбирает, чей счёт платит, — личный или команды. Право закрыли — подключения к счёту команды отключаются сразу.
- Видеть счёт и расход команды — баланс, историю счёта, расход всех и каждого. Нельзя — видно только свой расход по счёту команды и сколько можно потратить.
- Пополнять счёт команды — картой, СБП или счётом для компании.
Лимиты
Каждому участнику можно задать лимиты в рублях: на один запрос, на сутки и на месяц (сутки и месяц — по московскому времени). Перед запросом складываются потраченное человеком по счёту команды за сутки или месяц и удержание нового запроса. Не помещается — ответ 403 team_limit_reached с полями period (request, day или month), limit_rub, spent_rub и required_rub. Текстовый запрос без max_tokens сначала получает потолок ответа поменьше — как при месячном лимите ключа.
Лимиты человека — сверх лимитов ключа: у ключа команды может быть и свой месячный лимит. Если ответ вышел дороже удержания, разница списывается не дальше остатка лимитов.
Ключи и подключения
- Ключ команды выпускается в кабинете, переключённом на счёт команды. Запросы по нему платит общий счёт, а в расходе видно, чей это ключ.
- Владелец и администраторы видят все ключи команды, выдают ключ человеку в его карточке и отзывают любой ключ.
- Человека исключили, он вышел или команду распустили — его ключи команды и подключения к счёту команды перестают работать сразу: ответ 401. Личный API-счёт и личные ключи у него остаются.
GET /v1/balanceи заголовокx-veselo-balance-rubс ключом команды показывают, сколько можно потратить сейчас: свободное на общем счёте, но не больше остатка лимитов человека. Сумму на счёте видят те, кому открыт счёт команды.GET /v1/usage— расход по счёту команды: весь или только свой, по тому же праву. Подробнее — Справочник.
Журнал и расход
Во вкладке «Команда» — люди с расходом за сутки и месяц, приглашения и журнал: кто кого пригласил, что поменял в правах и лимитах, какие ключи выпустил и отозвал, какие нейросети подключил, кто пополнил счёт. Во вкладке «Расход» — запросы людей с именами. Кэшбэк начисляется на общий счёт — от расхода всей команды.
Выйти или распустить
Участник может выйти из команды сам. Владелец может распустить команду: все выйдут, ключи команды погаснут, приглашения сгорят, а деньги останутся на его API-счёте.