著者注:OpenAI、Claude、Gemini、Qwen を同時に接続するチームは、1つのアカウント内でプロジェクトごとにトークンを分割し、各トークンに利用枠、有効期限、モデルホワイトリスト、グループを設定し、トークンログで照合できます。
複数のモデルを同時に導入する開発責任者は、通常3つの問題に直面します。第一に、APIキーが各ベンダーの管理画面に分散していて、誰がどのキーを持っているのかを把握しにくいことです。第二に、月末の請求書とプロジェクトが突合できず、どのプロジェクトがいくら使ったのか分からないことです。第三に、1つのキーを複数人で共有した後、特定の1人だけを停止したい場合でも、キー全体を無効化するしかありません。本記事では 1つの APIYI アカウント + プロジェクトごとのトークン分割 という管理方法を紹介し、企業のマルチモデル管理 を実行可能な設定手順に落とし込みます。
これは「なぜ中継が必要なのか」を解説する別の記事ではありません。 以下の各設定項目は、APIYI apiyi.com のドキュメントにあるトークンとグループの説明に対応しています。レートやグループに関する数値には、ドキュメント原文に基づくことを明記します。
本記事の価値:この記事を読めば、プロジェクトごとに独立したトークンを作成し、いくらまで使えるか、いつまで有効か、どのモデルを呼び出せるか、どのグループを使うかを制限できるようになります。さらに、トークンログで各プロジェクトの使用量を確認できます。

企業向けマルチモデル管理の核心:キー、クォータ、ログをプロジェクトごとに分ける
企業向けマルチモデル管理の鍵は、すべてを1本の万能キーにまとめるのではなく、管理の境界を分けることにあります。APIYIでは、トークンがそのまま API Key で、sk- で始まります。ドキュメントによると、各トークンにはクォータ、有効期限、利用可能なモデル、グループを個別に設定でき、消費量・残りクォータ・呼び出しログも個別に記録されます。
| 要点 | 説明 | 開発責任者にとっての価値 |
|---|---|---|
| プロジェクト単位でトークンを作成 | 登録時にデフォルトのトークンが1本付与され、さらにプロジェクトやメンバーごとに追加作成できる | 特定の個人やプロジェクトを停止しても、他の呼び出し元に影響しない |
| クォータと有効期間を個別設定 | 各トークンにクォータ上限と有効期限を設定できる | 予算超過と外部委託の契約満了という2種類の問題を事前に制限できる |
| モデルホワイトリスト | 設定しない場合はサイト全体の200以上の厳選モデル(ドキュメント原文)を利用でき、設定後は指定したモデルのみ | プロジェクトが勝手に高価なモデルへ切り替えるのを防げる |
| グループがチャネルと倍率を決める | グループは上流・利用可能モデル・課金倍率を決める | 同じモデルでもグループが違うと実際の請求額が異なる場合がある |
| ログはトークンごとに分離 | 各トークンの消費量と呼び出しログを個別に確認 | 月末の突合をプロジェクト単位で直接行える |
企業向けマルチモデル管理でプロジェクトごとにトークンを分ける理由
ドキュメントには先に明確にしておきたい点があります。1つのトークンを複数人で使う場合、レート制限はトークンの本数ではなくアカウントに紐づきます。ドキュメント原文では、単一アカウントは概ね 100 RPM 以内なら問題なく、TPM は評価対象外とされています。これはドキュメントの記述であり、負荷テストの結果ではなく、SLA でもありません。
したがって、トークンを分ける目的はレート制限を回避することではなく、管理を分離することです。1本のトークンを1つのプロジェクトまたは1人のメンバーに対応させれば、問題発生時にその1本だけを停止でき、突合時もその1本だけを見れば済みます。全員がデフォルトのトークンを共用すると、ログ上の消費が混在してプロジェクト単位に分解できず、特定の呼び出し元だけを正確に止めることもできません。
企業向けマルチモデル管理におけるグループとフォールバックのルール
グループはリソースのチャネルです。ドキュメント原文によると、1本のトークンには最大1つのデフォルトグループと2つのフォールバックグループを設定できます。フォールバックとは、デフォルトグループでリクエストを満たせない場合に、システムが自動的にフォールバックグループへ切り替えることです。ドキュメントにおけるフォールバックの説明は「呼び出し成功率を高める」であり、可用性の保証ではないため、「絶対に失敗しない」と解釈してはいけません。
ほとんどのテキストモデルは Default グループで問題ありません。動画などの専用モデルは別のグループを選ぶ必要があり、トークンにそのグループが含まれていなければ、対応するモデルは呼び出せません。また、「200+ モデル」はサイト全体の厳選モデルの総数を指し、すべてのモデルが Default グループにあるわけではない点にも注意してください。具体的には各モデルのページに記載されたグループを基準にしてください。

企業向けマルチモデル管理のクイックスタート:プロジェクト別にトークンを作成する5ステップ
ここでは、3つのプロジェクトを抱えるチーム(検索拡張プロジェクト、カスタマーサポートボットプロジェクト、社内ライティングツール)を例に、設定の全流程を説明します。操作入口はトークンページ https://api.apiyi.com/token です。
ステップ1:トークンを計画する——1プロジェクトまたは1人につき1つ
まずトークン計画表を作成してから、管理画面で作成します。こうすることで、作りながら変更を繰り返し、最後には「1つの鍵を全員で使う」状態に戻ってしまうことを避けられます。
| トークン名 | 利用者 | モデルホワイトリスト | デフォルトグループ | フォールバックグループ | クォータと有効期限の推奨 |
|---|---|---|---|---|---|
proj-search |
検索拡張サービス | gemini-3.8-flash、qwen3.8-max |
Default |
モデルページで選択可能なグループ設定による | 月次予算に応じてクォータを設定し、長期間有効 |
proj-support |
カスタマーサポートボット | claude-sonnet-5-5 |
Default |
モデルページで選択可能なグループ設定による | 月次予算に応じてクォータを設定 |
team-writing-zhang |
メンバー個人ツール | claude-opus-5-5 |
Default |
設定しない | 少額のクォータ、有効期限を設定 |
vendor-outsource |
外部委託チーム | 納品に必要なモデルのみ | Default |
設定しない | クォータを契約期間に合わせ、期限切れで自動失効 |
表内の管理上の推奨は私たちの判断です。各モデルが具体的にどのグループに属するかは、そのモデルのページを基準にしてください。この表をそのままコピーしないでください。
ステップ2:トークンを作成し、4つの制限を設定する
トークン画面で新しいトークンを作成するときは、次の4項目を順に入力します。
- クォータ:プロジェクトの月次予算に合わせて入力します。クォータを使い切ると、そのトークンでの課金は停止し、ほかのトークンには影響しません。
- 有効期限:外部委託や一時メンバーには必ず設定しましょう。期限が来れば、手動で回収する必要はありません。
- 利用可能モデル(ホワイトリスト):そのプロジェクトに本当に必要なモデルだけを選択します。未入力の場合はサイト全体のモデルが開放されるため、おすすめしません。
- グループ:まずデフォルトグループを選び、必要に応じて最大2つのフォールバックグループを追加します。
ステップ3:キーを環境変数に置き、プロジェクトごとに変数名を分ける
キーはコードやリポジトリにハードコードしないでください。プロジェクトごとに独立した環境変数名を使うのがおすすめです。たとえばデプロイ環境で APIYI_KEY_SEARCH=sk-...、APIYI_KEY_SUPPORT=sk-... を設定し、それぞれのサービスから読み取ります。こうすれば、あるプロジェクトのキーをローテーションするときは、変数を1つ変更するだけで済みます。
ステップ4:OpenAI互換インターフェースで呼び出す
APIYIはOpenAI互換インターフェースを提供しており、接続時に変更が必要なのは次の2か所だけです。
base_urlをhttps://api.apiyi.com/v1に設定するapi_keyはプロジェクト自身の環境変数から読み取る(例:os.environ["APIYI_KEY_SEARCH"])
Python公式SDKを使う場合、要となるのはたった1行の初期化です。client = OpenAI(api_key=os.environ["APIYI_KEY_SEARCH"], base_url="https://api.apiyi.com/v1")。あとは client.chat.completions.create(model="gemini-3.8-flash", messages=[...]) を呼び出すだけです。model をホワイトリスト以外のモデルに差し替えると、そのトークンでは呼び出しができなくなります。これこそがホワイトリストで実現したい効果そのものです。
ステップ5:毎週トークンログを確認し、月末にトークン単位で照合する
各トークンの消費量、残りクォータ、呼び出しログは個別に確認できます。毎週1回、各トークンのログに目を通すことをおすすめします。重点的にチェックしたいのは次の2点です。想定外のモデルが出現していないか、消費カーブが急に上昇していないか。月末にトークン単位で集計すれば、プロジェクト別に分割したコストが得られます。
🎯 技術的なアドバイス:初回導入時は、まずデフォルトトークンを停止するか管理者専用にしておき、その後 APIYI apiyi.com のトークンページで上記の計画表に沿って1つずつ作成することをおすすめします。そうすれば初日から、すべての呼び出しをログ上で特定のプロジェクトに紐付けられます。
企業のマルチモデル管理における課金:モデルを変えると請求も変わる
マルチモデルを扱うチームが最も見落としやすいポイントは、モデルを変えたりグループを変えたりすると、請求額もそれに伴って変わるということです。以下の価格はAPIYIのモデル一覧から取得したもので、いずれも100万トークンあたりのデフォルト価格です。データの更新日時は2026-11-16 09:39(UTC+8)です。
| モデルID | 入力価格 | 出力価格 | キャッシュ読み取り | ドキュメント記載のエンドポイント / グループ | 利用可能プラットフォーム |
|---|---|---|---|---|---|
claude-opus-5-5 |
$4 | $20 | $0.2 | エンドポイント chat と messages | APIYI apiyi.com |
claude-sonnet-5-5 |
$2 | $10 | $0.1 | モデルページを参照 | APIYI |
qwen3.8-max |
$1.65 | $4.95 | $0.20625 | エンドポイント chat と messages;グループ ClaudeCode、Default、SVIP | APIYI |
gemini-3.8-flash |
$0.75 | $3.75 | $0.075 | Gemini_Reverse 倍率 0.5×、Default と SVIP は 1× | APIYI |
ドキュメントによると、従量課金の計算方法は「入力トークン × 入力価格 + 出力トークン × 出力価格」です。あるプロジェクトが毎月100万入力トークン、20万出力トークンを消費すると仮定して、定価で概算してみましょう。
claude-opus-5-5:4 + 0.2 × 20 = $8claude-sonnet-5-5:2 + 0.2 × 10 = $4qwen3.8-max:1.65 + 0.2 × 4.95 = $2.64gemini-3.8-flash(Default、1×):0.75 + 0.2 × 3.75 = $1.5;Gemini_Reverse(0.5×)経由の場合は、倍率換算で約 $0.75
ご覧のとおり、同じ作業量でもモデルを変えるとコストが数倍の差になることがあり、グループを変えても実際の請求額が直接変わります。つまり、トークンにホワイトリストとグループを設定することは、本質的にプロジェクトの単価に上限を設けることなのです。モデルや価格を確認する際は、APIYI apiyi.com のモデル一覧を基準にしてください。あるモデルがどのグループに属し、倍率がいくつなのかを確認したうえで、対応するトークンに追加してください。呼び出しアドレスは統一で https://api.apiyi.com/v1 となり、モデルを変える際は model パラメータを変更するだけで、base_url を変える必要はありません。
チームが公開されたばかりの新型モデルを評価している場合、たとえば Alibaba Cloud が2026-11-16に公開した qwen4-max などは、現時点で一覧表に含まれておらず、プラットフォームの価格APIでも確認できない点に注意が必要です。まだ提供を開始していませんが、このモデルはできるだけ早く提供を開始する予定です。モデルと価格はプラットフォームのモデル一覧を基準にしてください。提供開始前に、どのトークンのホワイトリスト計画にも含めないでください。

企業のマルチモデル管理における課金方式:従量課金と従課金は混同しない
ドキュメントでは、テキストモデルには「従量優先」を推奨しています。従課金はリクエストごとに固定価格で、主に画像と動画に用いられます。同じトークン1本でテキスト処理と画像生成の両方を実行すると、ログにはトークン単位の課金と従課金の2種類の記録が並びます。単位が異なるため、単純に合算することはできません。
より安全な方法は、テキスト系プロジェクトと画像生成・動画系プロジェクトでトークンを分けることです。動画などの専用モデルはもともと専用グループが必要なので、分離すればグループ設定も請求単位もすっきりします。
| 課金方式 | 計算方法(ドキュメント原文) | 典型的な用途 | トークン分割の推奨 |
|---|---|---|---|
| 従量課金 | 入力token × 入力価格 + 出力token × 出力価格 | テキスト対話、コード、要約 | テキストプロジェクト専用に1本。ドキュメントは従量優先を推奨 |
| 従課金 | リクエストごとに固定価格 | 画像・動画生成 | 画像生成/動画専用に1本、対応する専用グループを設定 |
決済について、ドキュメントには「チャージは1:7の固定レートで決済され、チャージ特典と併用可能。実際の課金額はコンソールを正とする」と記載されています。購買フロー、契約、請求書などは本記事の範囲外です。必要に応じてプラットフォームへ直接ご確認ください。
💡 選択のヒント:高価格モデル(例:
claude-opus-5-5)には少額のトークンを別途発行し、本当に必要な人にだけ配布しましょう。日常のバッチ処理用トークンには低単価モデルだけを割り当てます。APIYI apiyi.com ではモデル一覧でグループと倍率を確認してから割り当てできるので、月末の予想外の請求を防げます。

企業向けマルチモデル管理のよくある質問 FAQ
Q1:プロジェクトごとにトークンを分割する企業向けマルチモデル管理とは何ですか?
1つのアカウント内で、プロジェクトやメンバーごとに独立した APIキー(トークン)を発行し、それぞれにクォータ、有効期限、モデルホワイトリスト、グループを設定する運用のことです。消費量とコールログはトークン単位で分けて記録されるため、停止や突合(照合)をプロジェクト単位で正確に行えます。
Q2:トークンをたくさん作ると、レート制限も倍になるのでしょうか?
いいえ。ドキュメントには、レート制限はアカウントに紐づき、トークン数とは無関係だと明記されています。原文では「単一アカウントであれば通常 100 RPM 以内は問題なし、TPM は評価対象外」とされています。ただしこれはドキュメント上の記述であり、SLA ではありません。トークン分割は管理の分離を目的としたもので、クォータを増やすためのものではありません。
Q3:フォールバックグループを設定すれば、失敗しなくなるのでしょうか?
いいえ。ドキュメントの原文どおり、1つのトークンにはデフォルトグループを最大1つ、フォールバックグループを最大2つ設定でき、フォールバックはデフォルトグループでリクエストを満たせない場合に自動で切り替わる仕組みです。その目的は呼び出し成功率の向上です。業務側では引き続きリトライとフォールバック(デグレード)のロジックを用意しておく必要があります。
Q4:モデルホワイトリストを設定しないとどうなりますか?
ドキュメント原文:ホワイトリストを設定しない場合、そのトークンはサイト全体の 200 以上の厳選モデルを利用できます。これは管理上リスクが大きく、プロジェクトがうっかり高価なモデルに切り替えてしまう可能性があります。企業利用では、各トークンにそのプロジェクトが本当に必要とするモデルだけを登録することをおすすめします。
Q5:すでに OpenAI SDK を使ったコードがある場合、プロジェクト別トークンでの呼び出しにどう変更すればよいですか?
変更するのは2か所だけです。`base_url` を `https://api.apiyi.com/v1` に設定し、`api_key` をプロジェクト自身の環境変数から読み込むように変更します。トークンは APIYI apiyi.com のトークンページで作成し、モデルの切り替えは `model` パラメータを変えるだけです。
Q6:ある動画モデルが自分のトークンでは呼び出せないのはなぜですか?
動画などの専用モデルには、個別のグループが必要です。トークンにそのグループが設定されていなければ、モデルは利用できません。該当モデルのページで所属グループを確認し、トークンのグループ設定に追加してください。動画業務専用のトークンを別途作成する方法もあります。
Q7:同じモデルなのにプロジェクトによって課金額が違うのはなぜですか?
多くの場合、グループ倍率の違いによるものです。たとえば `gemini-3.8-flash` のモデルページには、Gemini_Reverse グループの倍率が 0.5×、Default と SVIP が 1× と記載されています。突合の際は、モデルとグループをセットで確認する必要があり、表示価格だけで判断してはいけません。
Q8:この方法にはどのような限界がありますか?
トークン分割で解決できるのは、キー・クォータ・ログの分離です。アカウントのレート制限を引き上げることはできませんし、業務側のリトライや監視の代わりにもなりません。新しくリリースされたモデルは、プラットフォーム上で提供開始されてからでないとホワイトリストに追加できません。具体的な価格とグループは APIYI apiyi.com のモデル一覧を参照してください。
企業のマルチモデル管理 押さえておきたい要点
- トークンはキーそのもの:
sk-で始まり、プロジェクトやメンバーごとに1つずつ発行すれば、個別に無効化できます - 4つの制限はセットで設定:クォータ、有効期限、モデルホワイトリスト、グループ。どれか1つでも欠けると管理に穴ができます
- レート制限はアカウント単位:ドキュメントには「100 RPM 以内なら通常問題なし、TPM は評価対象外」とあり、トークンを分割してもクォータは増えません
- フォールバックは保証ではない:最大で「デフォルト1 + フォールバック2」のグループ構成(ドキュメント原文)。あくまで成功率を高めるための仕組みです
- モデルを変えると請求も変わる:モデルの単価とグループ倍率の両方で実際の課金額が決まるため、トークン単位で照合してこそ見えてきます
- テキストと画像生成は分けて管理:従量制と従課金制では単位が異なるので、トークンを分けたほうが照合しやすくなります
- 入口は統一:全プロジェクトが
https://api.apiyi.com/v1を経由し、権限と請求はトークンだけで切り分けます
まとめ
企業のマルチモデル管理に必要なのは、全ベンダーの管理画面を開けられる万能鍵ではなく、権限をプロジェクトごとに分けることです。
- キーはプロジェクト単位で分割:1プロジェクトまたは1人につき1トークン。無効化やローテーションが互いに影響しません。
- クォータとモデルに上限を設定:総コストはクォータで、単価はホワイトリストとグループで制御します。
- ログはトークン単位で照合:週に一度は異常をチェックし、月末にはトークンごとにコストを集計します。
まずは本記事のステップ1に沿ってトークン計画表を作成し、次に APIYI apiyi.com のトークンページで1つずつ作成していくことをおすすめします。モデル・価格・グループを確認する際はプラットフォームのモデル一覧を正としてください。そうすれば、一度の導入でマルチモデルの請求をきれいに整理できます。
📚 参考資料
-
APIYI ドキュメントセンター:トークンとグループ、課金モード、モデル一覧
- リンク:
docs.apiyi.com - 説明:対応するパスは
/faq/token-and-groups.md、/faq/token-billing-modes.md、/models.md、/models/gemini-3-8-flash.mdです。本記事のトークン、グループ、価格に関する情報はすべてこちらを基準としています。
- リンク:
-
Alibaba Cloud 百炼(Model Studio)Qwen4-Max の説明:ベンダーによる公開情報
- リンク:
help.aliyun.com/zh/model-studio/qwen4-max - 説明:このモデルは 2026-11-16 にベンダーから公開されました。プラットフォーム上での提供状況については、モデル一覧をご確認ください。
- リンク:
作者:APIYI 技術チーム
技術交流:APIYI のウェブサイトトップページからお気軽にお問い合わせください。トークンとグループの詳しい設定方法については、ドキュメントセンターをご覧いただけます。
