OpenRouter API 1キー統合 400+ モデル 2026-07-24

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 API統合ゲートウェイ:1つのAPIキーでGPT Claude Geminiを呼び出す構成図

関連記事: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_urlapi_keyの差し替えで動作し、トークン上乗せはありません(クレジット購入時5.5%手数料)。

01 · OpenRouterとは

  • 単一エンドポイント: Authorization: Bearer $OPENROUTER_API_KEYprovider/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つの判断ミス

  1. 「無料GPT」と誤解する: 無料モデルはありますが、フロンティアのGPT/Claude/Geminiは有料クレジットを消費します。予算アラート未設定のチームは、経理から指摘されるまで5.5%手数料に気づきません。
  2. レイテンシコストを軽視する: ゲートウェイ経由で典型10〜80 ms追加されます。音声リアルタイムや低遅延取引向けには事前ベンチマークが必須です。
  3. 日常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-sonnetmodelを変えるだけで、メッセージ形式やストリームパーサはそのまま使えます。

理由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ステップ

  1. アカウント作成とキー発行: openrouter.aiでGitHub/Google SSOログイン後、Keysでキーを作成します(dev-mac-sandboxなど環境名を推奨)。
  2. 環境変数と上限設定: export OPENROUTER_API_KEY="sk-or-..."(gitにコミットしない)。ダッシュボードでキーごとのcredit limitを設定します。
  3. 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ステップ検証チェックリスト

  1. 隔離マシンで disposable キーを発行し、curlで3モデルテスト
  2. OpenAI SDKのbase_urlを差し替え、schema一致を確認
  3. stream: trueでTTFTを直接APIと比較
  4. fallback JSONで意図的失敗→チェーン成功を確認
  5. 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