ToRouterドキュメントAPI キー
キーが呼び出せるモデルを制限する
ToRouter API キーを特定のモデル ID リストに限定します。空の場合はグループカタログを継承。
キーの モデルホワイトリスト は、そのキーで呼び出せるモデル ID のカンマ区切りリストです。上流リクエストの前にサーバー側で適用されます。
動作
| ホワイトリスト | 効果 |
|---|---|
| 空 | サブスクライブしているグループのカタログ内のすべてのモデルを呼び出せる |
| 設定済み | リストに 含まれる モデルのみ呼び出せる |
model がホワイトリストにないリクエストは 403 model_not_allowed を返し、課金されません。
形式
カンマ区切り、引用符は不要です。空白はトリムされます。
gpt-5, gpt-5-mini, claude-opus-4-7, gemini-3-flash-previewOpenRouter スタイルのベンダープレフィックスはそのままリテラルでマッチします。
anthropic/claude-opus-4-7, google/gemini-2.5-proToRouter は内部で -thinking サフィックスを除去するため、claude-opus-4-7 は claude-opus-4-7 と claude-opus-4-7-thinking の両方をカバーします。ベース ID を指定すれば推論バリアントも自動的に含まれます。
利用シーン
- 安価なキー（例：チャットボット用）を
gpt-5-miniのみに限定 —claude-opus-4-7で予算を吹き飛ばすリスクをなくす。 - チームメイトに埋め込み専用のキーを発行する。
- 評価中の単一モデルに実験用キーを限定する。
ホワイトリストを設定する
API Keys → Edit → Model whitelist フィールド → 保存。
モデル ID は モデル · カタログ で確認するか、GET /v1/models で取得できます（Base URL を参照）。