> ## 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.
# グループとは？ユーザーグループとtokenグループの違いを解説
> APIYIのグループ概念を深掘りします。ユーザーの視点では「自分のグループ」のように感じますが、実際に各呼び出しで有効になるのはtokenに選択されたグループです。ClaudeCode、Sora2Official、Wan&HappyHorseの専用グループ事例と、「upstream group is saturated」という429エラーを分析した実際のチケットも含みます。
## 一言でいうと
**グループは、token で選択する「呼び出しチャネル」です。利用可能なモデル、課金倍率、上流ルーティングを決定します。** ユーザーの視点では「自分専用のグループ」のように感じられますが、**各呼び出しごとに実際に適用されるのは、token で選択されたグループです。**
## ユーザー視点とプラットフォーム視点
グループとは、トークンを作成または編集するときに**自分が選ぶチャネル**です。これによって、そのトークンがどのモデルを呼び出せるか、どのレート倍率が適用されるか、どの上流ルートをたどるかが決まります。
グループは、**リソース管理と機能の提示**のためのツールです。類似したモデル、専用キャパシティ、対象を絞った割引を1つのチャネルにまとめることで、課金を正確に保ちながら価格を差別化できます。
## 「ユーザーグループ」≠「tokenグループ」—混同しないでください
最初によくある反応は、「自分のアカウントには、どこかで切り替える必要があるグループがあるの？」というものです。
* アカウントレベルには「ユーザーグループ」という概念があり、これが**基本権限スコープ**（SVIP モデルが表示されるか、エンタープライズのフォールバックグループが有効になるか、など）を決めます
* ただし、**すべての API 呼び出しのルーティング、レート倍率、モデルの利用可否は、token に選択されたグループによって決まります。**
トラブルシューティングでは、まず token の「Select group」と「Fallback group」の設定を確認してください。—「自分のアカウントのグループ」を探し回る必要はありません。詳しくは [Tokens & グループ](/ja/faq/token-and-groups) を参照してください。
## ケース 1: なぜ `ClaudeCode` グループが存在するのですか？
**目的**: Anthropicネイティブの `/v1/messages` 呼び出し形式をサポートするモデルを1つのチャネルにまとめ、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. 「Select group」を `ClaudeCode` に設定します
3. お使いのクライアントから Anthropicネイティブ形式で呼び出します
## ケース 2: なぜ動画モデルには専用グループが必要なのですか？
動画モデルは、課金ルール（秒単位、画像単位、時間単位）がテキストモデルとは完全に異なり、上流チャネルも独立しています。グループを使うことで、**特殊な課金ルールを正確に有効化**できます。
| モデル | 必要なグループ |
| ------------------------------------- | ---------------------------- |
| Sora 2 official video | `Sora2Official` (秒単位課金) |
| Alibaba Wan & HappyHorse video series | `Wan&HappyHorse` |
| Seedance 2 video | 専用グループ（正確な名称はコンソールで確認してください） |
グループが間違っていると、通常はモデルが利用できない（404）、課金が誤る、または呼び出し自体が拒否されます。token の「Select group」または「Fallback group」には、対象モデルに一致するグループを含めてください。
## ケース3: 「Current group's upstream is saturated」は私へのレート制限ですか？
これは SaaS のマルチユーザーシナリオでよくある質問です。**実際のサポートチケットに基づいています。**
**シナリオ**:
* 開発者: 私のツールは SaaS 形式で、多くのユーザーが同時に呼び出します。トラフィックが増えると、次のエラーが出ます:
> `error 429 (content-type-not-allowed)`: 現在、グループの上流が混雑しています。しばらくしてから再度お試しください
* プラットフォームが同時実行数を制限しているのだと思っていました。回避するために、どこかで「グループを設定」する必要がありますか？
**真実**:
* このエラーは**アカウントレベルの同時実行制限ではありません**
* これは、そのグループ内でそのモデルに割り当てられている**上流チャネル**が現在ビジーであることを示しています
* よくある引き金は、ベンダー側でまだプレビュー中のモデル（`*-preview-*` のようなバージョン名）を使っており、その公式なキャパシティ自体が変動することです
**適切な対応**:
タイムアウトを延長（例: 60〜120秒）し、即時リトライを指数バックオフに切り替えます。エラーが発生した瞬間に同時リトライを重ねないでください。
token に、対象モデルに対応する **フォールバックグループ** を 1〜2 個追加します。プライマリが混雑した場合、トラフィックはバックアップチャネルに切り替わり、成功率が向上します。
ビジネスがレイテンシーや安定性に敏感なら、同一モデルファミリー内の、より負荷に強い派生版を自分のシナリオで**公平に評価**してください（多くのベンダーは、より軽量で分散性の高い兄弟版を提供しています）。トレードオフは自社で判断します。
お客様の呼び出しに同時実行の壁は設けていません。この 429 は上流チャネルに起因するもので、**課金レベルのレート制限ではありません**。再試行すれば通常は回復します。
## グループの選び方 — すばやい判断
| あなたのケース | 選ぶグループ |
| ----------------------------------------------------- | -------------------------------- |
| テキスト、マルチモーダル、NanoBanana、Veo 3.1、ほとんどのモデル | `Default` |
| Claude + Claude Code での国内コーディングモデル（`/v1/messages` 形式） | `ClaudeCode`（標準で 5% オフ、ボーナスと併用可） |
| Sora 2 公式動画 | `Sora2Official` |
| Wan\&HappyHorse / Seedance 2 動画 | それぞれの専用グループ |
| 不安定な高同時実行数のワークロード | token に 1〜2 個の予備グループを付ける |
## 「グループ倍率」について
コンソールに表示される「グループ倍率」は、**RMB建ての相対値**であり、USD の直接的な割引率ではありません。`0.14x` は「86% 割引」を意味しません。通常は**深く気にする必要はありません**。モデルに合ったグループを選べば十分です。倍率と価格換算については、[モデルの倍率とは何ですか?](/ja/faq/model-multiplier) をご覧ください。
## 関連ドキュメント
Token の役割、作成・編集、コード例の表示、グループの概要。
従量課金と従量課金ごとの違い。
レート倍率の意味、RMB の価格単位、USD 価格への換算。
モデルのティアとユーザーグループごとのアクセス。