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