OpenRouter完全マニュアル — エージェント時代の最強ルーティング
OpenRouter完全マニュアル — エージェント時代の最強ルーティング
出典: note.com / 2026-03-24
なぜ今OpenRouterなのか
2026年、AIモデルは毎週出てくる。Claude、GPT、Gemini、Kimi、MiMo、GLM、MiniMax、DeepSeek——もう追いきれない。
で、試すたびにアカウント作って、APIキー発行して、課金設定して……とやってたら人生が終わる。
OpenRouterは「AIモデルの食べログ」だ。
1つのAPIキーで100以上のモデルを即切り替え。先週出たXiaomiのMiMo-V2-Pro？モデル名を1行変えるだけ。無料のStep 3.5 FlashがOpusを超えた？今すぐ試せる。
他のサービスにはこれができない：
-
Anthropicコンソール → Claudeだけ
-
OpenAI Playground → GPTだけ
-
Google AI Studio → Geminiだけ
OpenRouterだけが「全部入り」。しかもマニアックな中国製モデルまで網羅。エージェント時代に「どのモデルが最強か」は毎月変わる。だからこそ、モデルを自在に切り替えられるルーティング層が必須になった。
今日は朝5時から自分のAIエージェント艦隊で実際にOpenRouterを使い倒した体験を元に、全機能を解説する。
目次
1. 基本概念
仕組み
あなたのアプリ → OpenRouter API → 最適なプロバイダー → AIモデル
（1つのキー） （自動選択）
OpenAI互換のAPIを1本叩くだけ。URLもスキーマもOpenAIと同じ。既存のコードの base_url を https://openrouter.ai/api/v1 に変えるだけで全モデルが使える。
料金体系
-
プロバイダーの料金をそのまま通す — マークアップなし
-
クレジット購入時に手数料 — Stripe決済で数%、暗号通貨決済で別率
-
無料モデルあり — プロンプトを学習に使う代わりにタダ
-
BYOK — 月の最初の一定リクエストは無料、以後は同モデルの通常料金の数%
2. アカウント設定
APIキー
https://openrouter.ai/settings/keys で発行。
sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
キーごとに設定できるもの：
-
日次上限（例：$5/日）— 暴走防止に必須
-
月次上限
-
レート制限
-
ガードレール（後述）
クレジット
事前にチャージする方式。使った分だけ減る。
-
Stripe（クレカ）
-
暗号通貨（Coinbase Commerce）
APIキーのガードレール
キーごとにポリシーを設定できる。例えば：
-
「このキーはClaudeしか使えない」
-
「このキーは日次$2まで」
-
「このキーはBYOKのみ」
チームで使う時や、エージェントごとにキーを分ける時に便利。
3. ルーティング（心臓部）
ここがOpenRouterの真骨頂。
3-1. モデル直接指定
一番シンプル。モデル名を指定する：
{
“model”: “xiaomi/mimo-v2-pro”,
“messages”: [{“role”: “user”, “content”: “こんにちは”}]
}
3-2. 自動ルーター（openrouter/auto）
OpenRouterがリクエスト内容を見て最適なモデルを自動選択：
{
“model”: “openrouter/auto”
}
許可モデルを設定できる：
anthropic/, openai/gpt-4o, google/, xiaomi/, minimax/
ワイルドカード * 対応。この範囲内から最適なものが選ばれる。
3-3. プロバイダー並べ替え
同じモデルでも複数のプロバイダーがホスティングしてることがある。並べ替え方式を選べる：
方式 | 特徴
|------|------|
デフォルト（バランス型） | 価格と稼働率のバランス
価格優先 | 最安プロバイダー
スループット優先 | 最速プロバイダー
3-4. フォールバック
指定モデルが落ちてる時、自動で別モデルに切り替え：
{
“model”: “xiaomi/mimo-v2-pro”,
“route”: “fallback”,
“models”: [
“xiaomi/mimo-v2-pro”,
“anthropic/claude-sonnet-4-6”,
“openai/gpt-4o”
]
}
上から順に試して、最初に応答したモデルを使う。
3-5. プロバイダー制限
-
無視されたプロバイダー — このプロバイダーは絶対使わない
-
許可されたプロバイダー — ここだけ使う
-
常に許可を強制 — APIリクエストで追加指定も禁止
3-6. デフォルトモデル
アプリ側がモデルを指定しなかった場合のデフォルト。設定しておくと、うっかりモデル未指定でもエラーにならない。
4. プライバシー設定
4つのスイッチで制御する：
設定 | 意味 | おすすめ
|------|------|---------|
有料エンドポイントの学習許可 | 有料APIでもデータを学習に使っていいか | OFF
無料エンドポイントの学習許可 | 無料モデルがプロンプトを学習に使う | ONにしないと無料モデル使えない
プロンプト公開許可 | 入力が公開データセットに出る | OFF
ZDRエンドポイントのみ | データ保持ゼロのプロバイダーだけ使う | ONにすると選択肢が激減
現実的な判断： 有料学習とプロンプト公開はOFF。無料学習は妥協してON。ZDRは機密作業の時だけON。
5. マルチモーダル
テキストだけじゃない。OpenRouter経由で以下も送れる：
入力 | 対応モデル例
|------|-------------|
画像 | Claude、GPT-4o、Gemini
PDF | Claude、Gemini
音声 | Gemini、GPT-4o Audio
動画 | Gemini（動画理解）
APIは同じ。content の中に image_url や file を入れるだけ。全部OpenRouterが対応モデルにルーティングしてくれる。
6. ツール呼び出し（Function Calling）
AIに外部ツールを呼ばせる機能。OpenAI互換の形式で送る：
{
“tools”: [{
“type”: “function”,
“function”: {
“name”: “get_weather”,
“parameters”: { … }
}
}]
}
OpenRouterが各プロバイダーの形式に自動変換してくれる。Claude用、GPT用、Gemini用——全部違う形式だけど気にしなくていい。
対応モデルは openrouter.ai/models?supported_parameters=tools で確認できる。
7. 構造化出力（Structured Outputs）
AIの応答をJSON Schemaで強制する：
{
“response_format”: {
“type”: “json_schema”,
“json_schema”: {
“name”: “song_analysis”,
“schema”: {
“type”: “object”,
“properties”: {
“genre”: {“type”: “string”},
“bpm”: {“type”: “number”},
“mood”: {“type”: “string”}
}
}
}
}
}
応答が必ず指定したJSON形式で返ってくる。パースエラーとおさらば。
8. プラグイン
OpenRouterにはモデルの能力を拡張するプラグインがある：
プラグイン | 機能
|-----------|------|
Web Search | AIがリアルタイムでWeb検索してから回答
PDF Parser | PDFを自動解析してコンテキストに追加
Response Healing | 壊れたJSON等の応答を自動修復
リクエストに plugins フィールドを追加するだけ。
9. 画像生成
テキスト入力だけじゃない。OpenRouter経由で画像も生成できる：
output_modalities に “image” を含むモデル（GPT-image-1、DALL-E等）を指定して、テキストプロンプトから画像を生成。
10. BYOK（自前キー持ち込み）
Bring Your Own Key — 自分で持ってるAnthropicやOpenAIのAPIキーをOpenRouter経由で使う。
メリット：
-
OpenRouterの統一APIを使いつつ、自前キーの料金体系を適用
-
ルーティング・フォールバック・ログ管理はOpenRouterが担当
-
月の最初の一定リクエストはOpenRouter手数料無料
使い方：
設定画面で各プロバイダーのキーを登録。リクエスト時に自動的に自前キーが使われる。
11. ストリーミング
ChatGPTみたいにリアルタイムで文字が流れてくる：
{
“stream”: true
}
Server-Sent Events（SSE）で返ってくる。OpenAIと全く同じ形式。
12. 使用量モニタリング
APIで確認（最速、ダッシュボード不要）
curl -s https://openrouter.ai/api/v1/auth/key \
-H “Authorization: Bearer sk-or-v1-xxxxx”
{
“usage_monthly”: 1.055,
“usage_daily”: 0,
“limit”: 5,
“limit_remaining”: 5
}
AIエージェントに「OpenRouterいくら？」と聞けば即答できる。
アクティビティ画面
https://openrouter.ai/activity で詳細履歴：
-
タイムスタンプ
-
使用モデル
-
アプリ名（どのエージェントが使ったか）
-
トークン数（入力→出力）
-
料金
-
速度（tok/s）
-
完了理由（停止/ツール呼び出し等）
暴走防止
日次上限（例：$5/日）を設定。エージェントが無限ループしても上限で止まる。これは絶対に設定しろ。
13. ランキングとリーダーボード
OpenRouterにはモデルのランキングページがある：
-
openrouter.ai/rankings— ユーザー投票によるモデルランキング -
アプリ帰属 — HTTPヘッダーでサイト名を送ると、OpenRouterのリーダーボードに表示される
開発者コミュニティでどのモデルが実際に使われてるか、リアルタイムでわかる。
14. 2026年3月のおすすめモデル
無料で使える
モデル | スコア | 特徴
|--------|--------|------|
StepFun Step 3.5 Flash | 81.0 | Opus超え。196B MoE。100-350 tok/s
Kimi K2.5 | 80.5 | 1Tパラメータ。4月末まで無料
低コスト高性能
モデル | Input/1M | Output/1M | 特徴
|--------|---------|-----------|------|
Xiaomi MiMo-V2-Pro | $1 | $3 | 1Mコンテキスト。コーディング最強
MiniMax M2.7 | 低 | 低 | 自動ルーティングで選ばれがち
高性能（有料）
モデル | 特徴
|--------|------|
Claude Opus 4.6 | 最高品質
GPT-5.2 | ベンチ最高
Gemini 3.0 Pro | バランス型
俺の使い分け
エージェント | モデル | 理由
|-------------|--------|------|
レディ（1号・指揮） | Claude Opus 4.6 | 判断力最重視
スポック（4号・実行） | MiMo-V2-Pro | コーディング＋コスパ
Hermes（2号・機密） | MiniMax M2.7 | 自動選択された
15. 実践で学んだこと
AIが出すコマンドは「提案」
今日、OpenClawの設定コマンドを何度も間違えた。tools.exec.approvals.telegram → 存在しないキー。allowFrom: true → 配列が必要。3回試行錯誤してやっと正解。
AIが出すコマンドは検証済みの完成品じゃない。 エラーが出たらAIに返して修正させる。この往復が実際の運用。
無料と有料の境界が消えつつある
Step 3.5 Flash（無料）がOpus 4.5（有料）をベンチで超えた。MiMo-V2-Pro（$1/$3）がSonnetのコーディングを超えた。「高い＝良い」は2026年にはもう成り立たない。
遊びにこそAIを使え
今日の出発点は「Spotifyで遊びたい」だった。仕事じゃなく遊び。そこからSpotify MCP、音楽生成AI、OpenRouterの全設定まで一気に学んだ。遊びの方が学習効率が高い。好奇心が止まらないから。
OpenRouterは「AIの食べログ」
気になったモデルをすぐ試食できる。ハズレでも損失は数セント。当たりを見つけたらメインに昇格。この気軽さが、他の追従を許さない。
まとめ：OpenRouterの全機能一覧
| 機能 | 一言
|---|------|------|
1 | 統一API | 1キーで100+モデル
2 | 自動ルーティング | 最適モデル自動選択
3 | フォールバック | 障害時自動切替
4 | プロバイダー制限 | 使うプロバイダーを制御
5 | プライバシー設定 | データ学習/公開の制御
6 | ZDR | データ保持ゼロポリシー
7 | マルチモーダル | 画像/PDF/音声/動画入力
8 | ツール呼び出し | Function Calling統一
9 | 構造化出力 | JSON Schema強制
10 | プラグイン | Web検索/PDF解析/修復
11 | 画像生成 | テキスト→画像
12 | BYOK | 自前キー持ち込み
13 | ストリーミング | リアルタイム応答
14 | 使用量API | コードで即確認
15 | 日次上限 | 暴走防止
16 | ガードレール | キーごとのポリシー
17 | ランキング | モデル人気投票
18 | アプリ帰属 | リーダーボード掲載
これだけの機能が1つのサービスに集約されてる。エージェント時代の必須インフラ。
書いた人：KT / AIエージェント艦隊を毎日運用してる人
明日は何のモデルが最強になってるか、誰にもわからない。だからOpenRouterを使う。
この記事は note.com から KTBLOG に移行されました。元記事: https://note.com/famous_prawn2009/n/n329930618ab5