OpenRouter API 完全ガイド:GPT・Claude・Gemini を1キーで呼び出す(2026)
対象読者: OpenRouterと直接OpenAI/Anthropic/Google APIのどちらを選ぶか迷っているバックエンド・Agent開発者の方です。得られる成果: 意思決定用の比較表、APIキー3ステップ設定、curl/Python/Node.jsの実行可能サンプル(ストリーミング・フォールバックJSON含む)、正直な料金試算(トークン上乗せなし・5.5%チャージ手数料・BYOK)。構成: 5つの導入理由、使わない方がよい4シナリオ、検証チェックリスト、FAQ 8項目です。
目次
関連記事:OpenRouterランキングとAgent選定、週次トークンランキング、CLIツールランキング。
要約(Featured Snippet向け)
OpenRouterは統合LLM APIゲートウェイです。1つのOpenRouter APIキーとOpenAI互換エンドポイント(https://openrouter.ai/api/v1/chat/completions)で、400以上のモデル(GPT、Claude、Gemini、DeepSeek、Llama、Qwenなど)をmodel文字列の変更だけで呼び出せます。既存のOpenAI SDKコードはbase_urlとapi_keyの差し替えで動作し、トークン上乗せはありません(クレジット購入時5.5%手数料)。
01 · OpenRouterとは
- 単一エンドポイント:
Authorization: Bearer $OPENROUTER_API_KEYとprovider/model形式のモデルID。 - 二段階ルーティング:
modelでモデル選択、providerオブジェクトでプロバイダ偏好(デフォルトは価格加重)。 - 組み込みフェイルオーバー: 上流のレート制限や5xx時に
models配列で自動切替可能です。 - 料金透明性: トークン単価は上流と同一。収益はチャージ手数料(5.5%、最低0.80ドル)またはBYOK超過(月100万req超で5%)。
- 無料枠: 25以上の無料モデル。未チャージ約50 req/日、10ドルチャージ後約1,000 req/日、無料モデルは20 req/分上限。
データポイント #1: 公開ランキングではローリング7日間で28兆トークン超の消費が記録される週もあり、本番Agentの選択が反映されています。詳細は請求データ分析をご覧ください。
02 · 導入前に陥りやすい3つの判断ミス
- 「無料GPT」と誤解する: 無料モデルはありますが、フロンティアのGPT/Claude/Geminiは有料クレジットを消費します。予算アラート未設定のチームは、経理から指摘されるまで5.5%手数料に気づきません。
- レイテンシコストを軽視する: ゲートウェイ経由で典型10〜80 ms追加されます。音声リアルタイムや低遅延取引向けには事前ベンチマークが必須です。
- 日常MacでA/Bテストする: Cursor・OpenClaw・カスタムAgentはキーをシェルプロファイルに残し、キャッシュを汚染します。隔離ハードウェアの方が「後でenvを消す」より確実です。
03 · OpenRouter vs 直接API(OpenAI・Anthropic・Google)
| 観点 | OpenRouter API | 直接API |
|---|---|---|
| APIキー | 1キーで400+モデル | ベンダーごとにアカウント・キー・請求 |
| SDK移行 | OpenAI互換(base_url差替) | 各社SDKまたはアダプタ自作 |
| トークン料金 | 上乗せなし | リスト価格 |
| プラットフォーム料 | チャージ5.5%(最低0.80ドル) | ゲートウェイ手数料なし |
| フェイルオーバー | 組み込み | 自前実装 |
| ダッシュボード | 統一使用量・コスト・TTFT | ベンダー別コンソール |
| 独占機能 | 一部のみ(Batch/Assistants非第一級) | フル機能 |
| レイテンシ | +10〜80 ms典型 | プロバイダ直結 |
| 最適用途 | マルチモデル・プロトタイプ・月~1万ドル未満 | 単一モデル大規模・厳格コンプライアンス |
データポイント #2: 月100万トークンのClaude Sonnet workloadでは、5.5%手数料は約4〜8ドル——3ベンダー統合の工数より安いことが多い一方、月5万ドル超ではBYOKや直接契約の試算が必要です。
04 · 開発者がOpenRouterへ移行する5つの理由
理由1:1キーですべてのモデル
openai/gpt-4oからanthropic/claude-3.5-sonnetへmodelを変えるだけで、メッセージ形式やストリームパーサはそのまま使えます。
理由2:自動フェイルオーバー
上流レート制限は日常です。modelsフォールバックチェーンでサーキットブレーカー実装を省略できます(第08節)。
理由3:統一請求と分析
1ダッシュボードでトークン支出・レイテンシ・モデルmixを把握——CLIツールがOpenRouterトラフィックの70%超を占める現状では特に重要です。
理由4:トークン上乗せなし
公式FAQでも上流価格のパススルーが明記されています。
理由5:無料モデルでプロトタイプ
Llama・Gemma・DeepSeek無料枠など25+モデルでハッカソンやCIスモークテストが可能です。
OpenRouterを使わない方がよいケース
- 単一モデルの超大規模本番(5.5%が直接契約を上回る)
- OpenAI Batch/Assistants、Anthropic prompt cache最適化など独占APIが必要
- 米国第三者ゲートウェイ経由が禁止されるデータレジデンシー(BYOKで法務確認を除く)
- 50 ms未満の推理SLA
05 · APIキー取得:3ステップ
- アカウント作成とキー発行: openrouter.aiでGitHub/Google SSOログイン後、Keysでキーを作成します(
dev-mac-sandboxなど環境名を推奨)。 - 環境変数と上限設定:
export OPENROUTER_API_KEY="sk-or-..."(gitにコミットしない)。ダッシュボードでキーごとのcredit limitを設定します。 - curlで検証してからIDE接続: 次節の例でGPT・Claude・Gemini各1回成功を確認してからCursor・LangChain・OpenClawへ接続します。
推奨追加:10ドルチャージで無料モデル枠拡大、SettingsでBYOK(月100万reqまで無料)、Models APIでslug確認。
06 · コード例:curl / Python / Node.js
6.1 curl
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic/claude-3.5-sonnet",
"messages": [
{ "role": "user", "content": "量子コンピュータを一文で説明して。" }
]
}'6.2 Python(requests)
import os
import requests
response = requests.post(
url="https://openrouter.ai/api/v1/chat/completions",
headers={
"Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "google/gemini-2.5-pro",
"messages": [
{"role": "user", "content": "Pythonでクイックソートを書いて。"}
],
},
)
print(response.json()["choices"][0]["message"]["content"])6.3 OpenAI SDK ドロップイン
import os
from openai import OpenAI
client = OpenAI(
base_url="https://openrouter.ai/api/v1",
api_key=os.environ["OPENROUTER_API_KEY"],
)
completion = client.chat.completions.create(
model="openai/gpt-4o",
messages=[{"role": "user", "content": "OpenRouterからこんにちは!"}],
)
print(completion.choices[0].message.content)6.4 Node.js
import OpenAI from "openai";
const openai = new OpenAI({
baseURL: "https://openrouter.ai/api/v1",
apiKey: process.env.OPENROUTER_API_KEY,
});
const completion = await openai.chat.completions.create({
model: "deepseek/deepseek-chat",
messages: [{ role: "user", content: "OpenRouterを一文で。" }],
});
console.log(completion.choices[0].message.content);データポイント #3: モデルIDは必ずprovider/model形式。400+エントリがあり、gpt-4o単体は404になります。
07 · ストリーミング応答
const stream = await openai.chat.completions.create({
model: "anthropic/claude-3.5-sonnet",
messages: [{ role: "user", content: "秋の短い詩を書いて。" }],
stream: true,
});
for await (const chunk of stream) {
const content = chunk.choices[0]?.delta?.content;
if (content) process.stdout.write(content);
}08 · フォールバックルーティング JSON
{
"model": "anthropic/claude-3.5-sonnet",
"models": [
"anthropic/claude-3.5-sonnet",
"openai/gpt-4o",
"google/gemini-2.5-pro"
],
"route": "fallback",
"messages": [{ "role": "user", "content": "Hello" }]
}09 · Models API
curl https://openrouter.ai/api/v1/models \
-H "Authorization: Bearer $OPENROUTER_API_KEY"10 · 料金:5.5%・BYOK・無料枠
| 種別 | 率 | 備考 |
|---|---|---|
| 有料トークン | 上流リスト価格 | 上乗せなし |
| クレジット購入 | 5.5%(最低0.80ドル) | 残高チャージ時 |
| BYOK | 月100万reqまで無料 | 超過後5% |
| 無料モデル | 0ドル | ~50 req/日→10ドル後~1,000 req/日 |
| 無料モデル上限 | 20 req/分 | 無料エンドポイントのみ |
11 · 5ステップ検証チェックリスト
- 隔離マシンで disposable キーを発行し、curlで3モデルテスト
- OpenAI SDKのbase_urlを差し替え、schema一致を確認
- stream: trueでTTFTを直接APIと比較
- fallback JSONで意図的失敗→チェーン成功を確認
- CSV保存後キー失効・環境消去
12 · よくある質問
Q:無料ですか?
A:25+無料モデルあり。フロンティアは有料クレジット。
Q:上乗せは?
A:トークン上乗せなし。5.5%チャージ手数料またはBYOK 5%。
Q:直接OpenAIより価値は?
A:マルチモデル・中規模支出なら多くの場合Yes。超大規模単一モデルは直接API。
Q:既存Pythonコードは?
A:base_url・キー・provider/model形式のみ変更。
Q:フォールバックは?
A:models配列+route: fallback。
Q:対応モデル数は?
A:400+。GET /api/v1/models参照。
Q:本番安全?
A:広く利用中。キー分離・ローテーション必須。
Q:ストリーミング?
A:stream: trueでOpenAI互換SSE。
13 · レンタルMacでOpenRouter多モデル検証
Linux VPSでもcurlは動きますが、実務ではCursor BYOK、OpenClawゲートウェイ、macOS Keychain隔離、IDE Agent並行を検証したいケースが多いです。日常MacBookでGPT/Claude/GeminiのA/Bテストをすると、キーが.zshrcに残り、キャッシュが混ざり、本番プロファイルと実験設定が共存します。
3日間のルーティング検証のためにMac miniを購入するのは固定費が重いです。日次レンタルは「キー作成→計測→失効→ノード破棄」サイクルに合います。ブラウザチャットUIは手軽ですが、ストリームパーサ・フォールバックチェーン・モデル別コストログの検証には不向きです。隔離されたApple SiliconレンタルMacなら、実験キーを日常Keychainから分離し、Cursor/OpenClawにOpenRouterを接続しても本番設定を汚しません。料金はMac mini M4レンタルTCOをご参照ください。
14 · 参考リンク
最終更新:2026-07-24