Весело
Весело

Команды: общий счёт, права и лимиты

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

Обновлено:

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

Как завести команду

  1. Открой кабинет API → вкладка «Команда» → «Создать команду». Твой API-счёт станет общим счётом команды: деньги на нём остаются твоими, и тратить их своими ключами можно как раньше.
  2. Нажми «Пригласить»: выбери роль и готовый набор прав — «Разработчик», «Контент», «Бухгалтер» или «Наблюдатель» — или настрой права и лимиты сам.
  3. Отправь приглашение на почту или скопируй ссылку и передай её как удобно. Ссылка одноразовая и действует 7 дней; отозвать её можно в любой момент.
  4. Человек открывает ссылку, входит на veselo.ai — если аккаунта нет, заводит его тут же — и нажимает «Принять».
  5. Дальше он переключает кабинет на счёт команды (вверху, «Чей счёт») и выпускает ключ команды — или ключ выдаёт ему владелец.

Роли

РольЧто может
ВладелецВсё: пополняет счёт, приглашает и исключает людей, назначает администраторов, меняет права и лимиты, распускает команду. Сам без ограничений. Владелец у команды один, и общий счёт — его 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-счёте.

← Цены и списания · Оплата для компаний →

Вся документация одним текстом · Все модели и цены