グループとは

MoleAPI では、グループ は「ある API Key がどのモデルチャネルと価格戦略を通るか」を表すものとして理解できます。

これは単なる表示用のフィールドではなく、次の点に直接影響します。

• この Key でどのモデルを参照できるか
• それらのモデルを呼び出す際にどの種類のチャネルを通るか
• 対応する価格戦略
• 場合によっては安定性や適用シナリオ

なぜグループがあるのか

プラットフォーム上で、すべてのモデル、すべての価格、すべてのチャネルが混在していると、ユーザーは用途ごとに区別して管理しにくくなります。

グループの目的は、異なる目的を分けて管理できるようにすることです。たとえば、次のような使い分けができます。

• テスト環境と本番環境で異なるグループを使う
• コスト重視のトラフィックをより安価なグループに流す
• 安定性を優先するトラフィックをより安定したグループに流す
• 特定のモデルを特定の Key でのみ利用可能にする

グループは何として理解すればよいか

実態に近い表現をすると、次のように考えられます。

グループ = モデル集合 + チャネル戦略 + 価格戦略 の組み合わせ

そのため、同じモデルであっても、グループが異なれば次のような差が生じる可能性があります。

• 可用性が異なり、グループを切り替えるとモデルが利用できなくなることがある
• 単価が異なり、一部は割引される
• 安定性の体験が異なり、たとえば relay グループは安定性が低い場合がある

コンソールの料金ページ左側のフィルターで「利用可能な Token グループ」を選択すると、そのグループで表示されるモデル一覧を確認できます。

よくあるグループの種類

以下は、ドキュメント内でよく登場し、比較的理解しやすい代表的な種類です。

実際には、コンソールおよびシステム通知に表示される最新のグループ情報を基準にしてください。

初めて使う場合はどう選ぶべきか

初めて接続する場合は、次のように進めることを推奨します。

• まずはデフォルトグループ で一通りのフローを動かす
• 動作確認後に、価格、モデルのカバレッジ、安定性に応じて調整する

初めて使う場合は、極限までコストを下げることよりも、まず正常に動作させることのほうが重要だからです。

どのような場合にグループを明確に分けるべきか

次のようなケースでは、グループを明確に設計することをおすすめします。

1. 本番とテストを分離したい場合

テスト用のトラフィックと本番業務のトラフィックを、同じ戦略に混在させないでください。

2. コストを管理したい場合

価格に敏感な場合、グループは非常に重要な調整手段になります。

3. システムごとに権限が異なる場合

たとえば、次のようなケースです。

• 内部の実験プロジェクトでは、より安価なグループを利用できる
• 正式なプロダクトでは、少数の安定したモデルのみを公開する

4. 異なるチャネルの効果を比較したい場合

同じモデルでも、グループによって体験が異なることがあります。まずは少量のトラフィックでテストし、その後に長期的な戦略を決めるのが適しています。

グループと API Key の関係

グループは通常、API Key に設定されます。API Key を作成または編集する際、「Token グループ」でその Key が属するグループ（default、discount、relay など）を選択します。グループごとに異なる倍率とモデル範囲が適用されます。

これは次のことを意味します。

• 異なる Key を異なるグループに割り当てられる
• 同じアカウントで複数の戦略を同時に持てる
• プロジェクトや環境ごとに異なる Key を割り当て、それぞれに異なるグループを設定できる

そのため、以下のような構成を推奨することがよくあります。

• テスト用 Key を 1 つ
• 本番用 Key を 1 つ
• 必要に応じて、各システムごとに専用の Key を 1 つずつ

利用の推奨事項

推奨される方法

• 初めての場合はまず default を使う
• 環境ごとに複数の Key を分ける
• 重要な業務では、まず安定性を確保してから、より安価なグループを検討する
• 本番リリース前に、対象グループで実際のテストを行う

推奨されない方法

• すべてのプロジェクトで 1 つの Key と 1 つのグループを共用する
• グループを十分に理解しないまま、本番トラフィックを未知のグループへ直接切り替える
• 価格だけを見て、モデルの可用性や安定性を確認しない

次に読むもの

• API Key とは
• API Key の作成方法
• 従量課金