コアコンセプト
ToRouter を支える 5 つの概念 — アカウント、チャネル、モデル、キー、クォータ。
ToRouter には 5 つの基本概念があります。これらを押さえれば、残りのドキュメントは自然と理解できます。
5 つの概念
アカウント(Account)
ToRouter のユーザーです。portal.torouter.ai でメールアドレスとパスワードを使って作成します。1 つのアカウントは アカウント残高(プリペイド済みのクレジット)と任意の数の API キーを保有します。
チャネル(Channel)
上流プロバイダーへの接続です。ToRouter が認証情報を保持している OpenAI / Anthropic / Gemini / OpenRouter / DeepSeek / Qwen / Bedrock / Replicate のアカウントを指します。上流バインディングを直接管理することはありません。どのモデルを呼び出せるかは、ポータル上の サブスクリプションとアクセス権 に従います。エンドユーザーはモデルカタログを通して間接的にルーティング可能な範囲を把握します。
モデル(Model)
model フィールドで指定するモデル識別子です(gpt-5、claude-opus-4-7、gemini-2.5-pro、deepseek-v3 など)。リクエストが届くと、ToRouter は利用を許可されたチャネルの中からそのモデルを提供するものを選び、呼び出しを転送します。モデル識別子 を参照してください。
API キー(API Key)
Authorization ヘッダーに含める sk-*** の値です。コンソールで作成します。各キーには次の設定を個別に持たせることができます。
- 利用クォータ
- レートリミット(RPM / TPM)
- IP 許可リスト(CIDR)
- モデルホワイトリスト
- 有効期限
キーごとの制限 を参照してください。
クォータ(Quota)
リクエストの利用上限です。これは次の 3 つの 最小値 として算出されます。アカウント残高、サブスクリプションプランに基づく月次上限(該当する場合)、キーごとに設定された任意のクォータ。いずれかが先に尽きた時点でリクエストは停止されます。
リクエストの流れ
Client SDK
| Authorization: Bearer sk-***
v
ToRouter gateway
| identify key -> account -> access (subscriptions)
v
Model router
| pick a channel that serves `model`
v
Upstream provider (OpenAI / Anthropic / Gemini / ...)
|
v
Response + usage logged to your dashboard保有するのは常に 1 つのキーと 1 つの base URL だけです。gpt-5 から claude-opus-4-7 に切り替えるのは model フィールドの 1 行の変更で済みます。新しいアカウントも認証情報も必要ありません。