> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Что такое группа? Объяснение User Group и Token Group
> Подробный разбор концепции группы в APIYI. С точки зрения пользователя это выглядит как «моя группа», но на самом деле для каждого вызова действует группа, выбранная на token. Включает кейсы с выделенной группой для ClaudeCode, Sora2Official, Wan&HappyHorse и реальный тикет с разбором ошибки 429 «upstream-группа насыщена».
## В одном предложении
**Группа — это «канал вызова», который вы выбираете на token. Она определяет доступные модели, коэффициент тарифа и маршрутизацию upstream.** С точки зрения пользователя это ощущается как «своя группа», но **для каждого отдельного вызова фактически действует группа, выбранная на token**.
## Представление пользователя vs представление платформы
Группа — это **канал, который я выбираю** при создании или редактировании token. Он определяет, к каким моделям этот token может обращаться, какой коэффициент тарифа применяется и через какую upstream-линия он идет.
Группы — это инструмент для **управления ресурсами и предоставления функций** — объединение похожих моделей, выделенной мощности и целевых скидок в один канал, чтобы тарификация оставалась точной, а цены можно было дифференцировать.
## «Группа пользователя» ≠ «Группа token» — не путайте их
Типичная первая реакция: «Есть ли в моей учетной записи группа, которую мне нужно где-то переключить?»
* На уровне учетной записи действительно есть понятие «группа пользователя», которое определяет **базовую область разрешений** (появляются ли модели SVIP, разблокированы ли резервные группы enterprise и т. д.)
* Но **маршрутизация каждого API-вызова, коэффициент тарифа и доступность моделей определяются группой, выбранной для token**.
При устранении неполадок сначала проверьте настройки token «Выбор группы» и «Резервная группа» — не ищите «группу моей учетной записи». См. [Токены и группы](/ru/faq/token-and-groups).
## Случай 1: Почему существует группа `ClaudeCode`?
**Назначение**: Объединить модели, которые поддерживают нативный для Anthropic формат вызова `/v1/messages`, в один канал, чтобы вы могли использовать отечественные кодовые модели в Claude Code, Cherry Studio и других клиентах с нативной для Anthropic поддержкой **точно так же, как при вызове Claude — без изменений кода**.
**Включенные модели**:
* Полная линейка Claude (официальный транзит / AWS Claude)
* Отечественные модели, совместимые с `/v1/messages`, например `qwen3.x-max`, `glm-5.x`, `deepseek-v4`
**Скидка**:
* По умолчанию **скидка 5% (95 折)** — ничего делать не нужно
* **Суммируется с бонусом за пополнение (10%–20%)**, поэтому фактическая стоимость получается примерно на 20% ниже, чем при прямой официальной покупке
**Как использовать**:
1. Откройте [https://api.apiyi.com/token](https://api.apiyi.com/token) и создайте или отредактируйте token
2. Установите для поля «Выбор группы» значение `ClaudeCode`
3. Вызывайте из своего клиента в формате Anthropic-native
## Случай 2: зачем видеомоделям нужна отдельная группа?
Видеомодели используют правила тарификации (за секунду, за изображение, за длительность), которые полностью отличаются от текстовых моделей, а их upstream-каналы независимы. Группы позволяют **точно применять особые правила тарификации**:
| Модель | Требуется группа |
| ------------------------------------ | ------------------------------------------------- |
| Официальное видео Sora 2 | `Sora2Official` (тарификация по секундам) |
| Серия видео Alibaba Wan и HappyHorse | `Wan&HappyHorse` |
| Seedance 2 video | выделенная группа (точное название см. в консоли) |
Неправильная группа обычно означает: модель недоступна (404), неверная тарификация или запрос сразу отклоняется. Убедитесь, что token в «Выбор группы» или «Резервная группа» включает группу, соответствующую нужной вам модели.
## Случай 3: «Current group's upstream is saturated» — это ограничение для меня?
Это частый вопрос в многопользовательских SaaS-сценариях. **Он взят из реального обращения в поддержку.**
**Сценарий**:
* Разработчик: Мой инструмент работает в стиле SaaS, и многие пользователи вызывают его параллельно. Когда трафик растет, я получаю:
> `error 429 (content-type-not-allowed)`: Current group's upstream is saturated, please try again later
* Я предположил, что платформа ограничивает мои параллельные запросы — нужно ли мне где-то «настроить группу», чтобы обойти это?
**На самом деле**:
* Это ошибка **не является ограничением на уровне аккаунта по параллельным запросам**
* Она означает: **upstream-канал**, сопоставленный с этой моделью в этой группе, сейчас занят
* Типичный триггер: использование модели, которая на стороне вендора все еще находится в preview (версии с названиями вроде `*-preview-*`), и ее официальная пропускная способность сама по себе колеблется
**Что делать правильно**:
Увеличьте тайм-ауты (например, до 60–120 с) и замените немедленные повторные попытки на экспоненциальный backoff. Не наращивайте параллельные повторные попытки в момент возникновения ошибки.
Для token добавьте 1–2 **резервные группы**, соответствующие целевой модели. Когда основная перегружена, трафик переключается на резервный канал, и процент успешных запросов растет.
Если ваш бизнес чувствителен к задержке или стабильности, **объективно оцените** более стабильные варианты в пределах той же линейки моделей в своем сценарии (у большинства вендоров есть более легкие и более распределенные родственные версии). Ваш бизнес сам выбирает компромисс.
Мы не вводим ограничение по параллельным запросам для клиентских вызовов. Этот 429 приходит от upstream-канала — **это не лимит на уровне тарификации**. Повторные попытки обычно помогают.
## Как выбрать группу — быстрое решение
| Ваш сценарий | Выбираемая группа |
| -------------------------------------------------------------------------- | ------------------------------------------------------------ |
| Текст, мультимодальные сценарии, NanoBanana, Veo 3.1 и большинство моделей | `Default` |
| Claude + отечественные coding-модели в Claude Code (формат `/v1/messages`) | `ClaudeCode` (скидка 5% по умолчанию, суммируется с бонусом) |
| Официальное видео Sora 2 | `Sora2Official` |
| Видео Wan\&HappyHorse / Seedance 2 | их отдельные группы |
| Нестабильные нагрузки с высокой параллельностью | привяжите 1–2 **резервные группы** к token |
## О коэффициенте группы
«Коэффициент группы», отображаемый в консоли, — это **относительное значение, указанное в RMB**, а не прямой коэффициент скидки в USD — `0.14x` НЕ означает «скидку 86%». Обычно **не нужно вникать в это**; просто выберите группу, которая соответствует вашей модели. Чтобы понять коэффициенты и преобразование цен, см. [Что такое коэффициент модели?](/ru/faq/model-multiplier).
## Связанные документы
Роли token, создание/редактирование, просмотр примеров кода, обзор группы.
Различия между режимами оплаты по использованию и оплаты за вызов.
Значение множителя, единица тарификации в RMB и конвертация цены в USD.
Уровни модели и доступ по группе пользователей.