OpenRouter API 完全ガイド 2026：
GPT・Claude・Gemini を一つのキーで呼び出す

OpenAI、Anthropic、Googleそれぞれの API キーを抱えながら Agent やバッチパイプラインを組むと、モデルを差し替えるたびにクライアント実装の二重コストが発生します。本稿は、OpenRouter API 一つで GPT-4o、Claude 3.5 Sonnet、Gemini 2.5 Pro、DeepSeek、Llama など 400 超のモデルを呼び出したい開発者向けに、定義の要約、直接 API との比較表、5 つの導入理由、向かないケース、7 ステップのキー取得手順、cURL・Python・Node.js・OpenAI SDK のコード、ストリーミングとフォールバック、具体的な料金数値、日本語 SEO 公開チェックリスト、FAQ、計測指標をまとめます。料金は NOVAKVM 料金ページ、注文は 注文ページをご参照ください。モデル市場の文脈は OpenRouter 週次トークンランキング解説と併読すると理解が深まります。

[ SECTION_01 ] // TLDR OpenRouter とは何か：開発者向け30秒定義

OpenRouter は LLM 向けの統合 API ゲートウェイです。API キー 1 本、OpenAI 互換エンドポイント（https://openrouter.ai/api/v1/chat/completions）、70 超のプロバイダを横断する単一請求ダッシュボードで、フロンティアモデル群に到達できます。model 文字列を openai/gpt-4o から anthropic/claude-3.5-sonnet や google/gemini-2.5-pro に変えるだけで、リクエストボディ・ストリーミング・SDK ラッパーをそのまま使えます。

• 認証：Authorization: Bearer $OPENROUTER_API_KEY
• モデル ID 形式：provider/model-name（例：deepseek/deepseek-chat、meta-llama/llama-3.1-405b）
• 移行の容易さ：OpenAI SDK の base_url="https://openrouter.ai/api/v1" に向け、キーを差し替えるだけ
• 二重ルーティング：各リクエストで OpenRouter は独立に 2 つ決定します。モデル（model または openrouter/auto）と、同モデルを提供するプロバイダホスト（provider オブジェクト。既定はコスト加重の安定ルート）

OpenRouter は各社公式 SDK の全機能を置き換えるものではありません。統合面を 1 つに揃え、透過的なパススルー料金とゲートウェイレベルのフェイルオーバーを自前サーキットブレーカーなしで得たい本番マルチモデル構成向けの最短経路です。

[ SECTION_02 ] // COMPARE OpenRouter vs 直接 API（OpenAI・Anthropic・Google）比較表

OpenRouter vs OpenAI API を検索する開発者は、請求と SDK を 1 つにまとめたい一方で、レイテンシ・上乗せ・ベンダーロックインを懸念しています。以下が実務で使える意思決定マトリクスです。

プロバイダルーティングは OpenRouter の半分の話です。同一モデル ID を提供するホストが複数あっても、OpenRouter は価格・稼働率・スループットでスコアリングし、レート制限やエラー時に自動フェイルオーバーします。これは モデルルーティング（どのモデルが応答するか）とは別レイヤーです。

[ SECTION_03 ] // WHY_SWITCH OpenRouter に切り替える5つの理由

• 1 キーで全フロンティアモデル：5 社のサインアップを省略できます。Agent フレームワークで実行時に GPT・Claude・Gemini を選ばせる場合、文字列 1 つ差し替えで済みます。
• ゲートウェイレベルのフェイルオーバー：レート制限と地域障害は日常です。OpenRouter はプロバイダ間リトライと明示的 models フォールバック配列に対応し、自前サーキットブレーカーなしで可用性を上げられます。
• 統合ダッシュボード：全モデルのトークン支出・TTFT・スループットを 1 画面で見られる点は、OpenAI・Anthropic・Google Cloud 各コンソールを行き来して請求を突合するより実務的です。
• トークン上乗せなし：多くの集約サービスと異なり、OpenRouter FAQ はパススルー料金を明言しています。プロバイダ単価をそのまま支払い、手数料はクレジット購入時（5.5%、最低 $0.80）に発生します。
• 無料枠で試せる：25 超の無料モデルでスモークテスト可能です。未認証は1 日約 50 リクエスト、$10 以上のクレジット追加後は1 日 1,000 リクエスト・分 20 リクエストまで拡張されます。

[ SECTION_04 ] // ANTI_PATTERNS OpenRouter を選ばない方がよいケース

一方通行の賛美より、次の条件に当てはまる場合は直接 API や自ホストを検討した方が合理的です。

• 単一ベンダー超大規模支出：月に 1 モデルで数万ドル規模なら、5.5% のクレジット手数料とゲートウェイレイテンシが、直接エンタープライズ契約より高くつく可能性があります。
• プロバイダ独占 API：OpenAI Batch API、Anthropic 公式 Prompt Caching 請求最適化、Google Vertex 専用ツール、OpenRouter が完全ミラーしていない Assistants エンドポイントが必要な場合。
• 超低レイテンシ：音声・ゲーム・100ms 未満の対話ループでは 10〜80ms の追加ホップが許容できないことがあります。
• 厳格なデータ所在地：米国第三者ゲートウェイ経由が規制上不可なワークロードは、直接 API またはオープンウェイト自ホストが適します。
• 深いコンプライアンス監査：調達が OpenAI や Anthropic との直接 DPA を要求する場合、中間集約層はレビュー摩擦を増やします。

[ SECTION_05 ] // SETUP OpenRouter API キー取得：7ステップ手順

1. アカウント作成：openrouter.ai でメールまたは OAuth 登録します。無料モデル試験用のキー生成にクレジットカードは不要です。
2. Keys ページを開く：Settings → API Keys（または openrouter.ai/keys）へ移動します。キーはアカウント単位で、独立ローテーション可能です。
3. 本番キーを発行：Create Key を押し、環境名（prod-agent、staging-ci 等）でラベル付けします。シークレットは一度だけ表示されるため、シークレットマネージャに保存し Git には置きません。
4. 環境変数を設定：シェルプロファイルまたはアプリの .env に OPENROUTER_API_KEY をエクスポートします。
5. 有料モデル用にクレジット追加：Credits からチャージします。5.5% 手数料（最低 $0.80）、暗号資産はさらに 5%。$10 以上の残高で無料モデル日次上限が引き上げられます。
6. curl でスモークテスト：anthropic/claude-3.5-sonnet または無料モデルへ 1 回 chat completion を送り、本番 Agent 配線前に疎通を確認します。
7. 任意で BYOK を有効化：プロバイダ設定に自社 OpenAI や Anthropic キーを登録します。月100 万リクエストまで OpenRouter サービス料無料、超過は5%が相当使用量に課金されます。

OpenRouter のドキュメントと料金ページは更新されます。本番予算確定前に公式ソースを再確認してください。

https://openrouter.ai/docs

https://openrouter.ai/docs/faq

[ SECTION_06 ] // CODE コード例：cURL・Python・Node.js・OpenAI SDK 差し替え

日本語圏の開発者が実際に検索する 4 パターン（生 HTTP、Python requests、Node、OpenAI SDK ゼロ移行）をカバーします。

$ 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": "量子コンピュータを一文で説明してください。" }
    ]
  }'

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"])

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": "こんにちは"}],
    extra_headers={
        "HTTP-Referer": "https://novakvm.com",
        "X-Title": "NOVAKVM Agent Demo",
    },
)

print(completion.choices[0].message.content)

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);

動的 Agent UI 向けに、利用可能モデルをプログラムで列挙する例です。

$ curl https://openrouter.ai/api/v1/models \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

[ SECTION_07 ] // HA ストリーミングとモデルフォールバックで高可用性を確保

ストリーミングは OpenAI SDK と同じ stream: true です。チャンクを反復すれば、OpenRouter がプロバイダ SSE を透過転送します。

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);
}

モデルフォールバックはモデルレイヤーの可用性を担います。プライマリがエラーまたはレート制限に当たると、OpenRouter は models 配列を順に試します。

{
  "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": "こんにちは" }]
}

ゲートウェイのプロバイダルーティング（同一モデル ID のホスト自動切替）と、明示的モデルフォールバック（Claude → GPT → Gemini）を組み合わせると、単一ベンダー障害に耐える Agent 構成が組めます。コストドリフトのデバッグ時は、レスポンスメタデータから実際に応答したモデルをログに残してください。

[ SECTION_08 ] // PRICING OpenRouter 料金解説：無料枠・クレジット・5.5%・BYOK

Agent ループの予算化前に、公開料金ページでモデル別単価を確認してください。リスト価格だけでなくトークン量ランキングが実支出を予測します。週次ランキング分析を参照してください。

https://openrouter.ai/models

[ SECTION_09 ] // SEO_PUBLISH 日本語 SEO と多言語公開チェックリスト（要約版）

日本語記事のインプレッションが伸びない場合、キーワード密度よりインデックスとネイティブ表現の問題であることが多いです。OpenRouter 系チュートリアル向けの圧縮ランブックです。

低トラフィック診断（この順で対処）：

1. Google Search Console：/ja/ で URL 検査。インプレッション 0 は順位以前のクロール/インデックス問題です。
2. CDN/WAF のボット遮断：Googlebot が空 SPA や WAF チャレンジではなく完全 HTML を受け取るか確認します。
3. 言語別 canonical：日本語ページの canonical は novakvm.com/ja/blog/... 自身を指し、他言語 URL を指しません。
4. サイトマップ：日本語 URL を明示列挙。古いサイトマップは発見を遅らせます。
5. 機翻ではなく書き直し：タイトルと FAQ は「OpenRouter API 使い方」「OpenRouter 無料」等、日本語の実検索語に合わせます。

Schema：チュートリアルには BlogPosting と FAQPage JSON-LD を併載。FAQ 質問文は実検索語（「OpenRouterは無料ですか？」等）に合わせます。

配信チャネル：

• 日本語：Zenn、Qiita（canonical を自サイトに）、はてなブックマーク、X スレッド、開発者向け Slack/Discord。
• 英語（並行）：dev.to、Hacker News Show HN、Reddit r/LocalLLaMA。

P0〜P2 アクション：

• P0（今週）：/ja/ の GSC インデックス監査、WAF ボットテスト、canonical とサイトマップ修正。
• P1（執筆）：日本語ネイティブ書き直し、タイトル・リード・H2・FAQ にキーワード矩阵を反映、BlogPosting + FAQPage スキーマ追加。
• P2（配信）：Zenn/Qiita シンジケーション、GSC サイトマップ再送信、週次インプレッション追跡。

[ SECTION_10 ] // FAQ_CLOSE FAQ・計測指標・NOVAKVM Mac Mini 7×24 Agent ホスティング

Q: OpenRouter は無料で使えますか？
A: 部分的に可能です。25+ 無料モデルがあり、未認証は1 日約 50 リクエスト、$10 以上クレジット後は1 日 1,000 リクエスト（20/分）。有料フロンティアモデルはプロバイダトークン単価 + クレジット購入 5.5% 手数料です。

Q: トークン単価に上乗せはありますか？
A: トークン上乗せはありません。クレジット購入時 5.5%（最低 $0.80）、BYOK 月 100 万 req 超過後 5% です。

Q: 本番環境で安全ですか？
A: 広く採用されていますが、プロンプトは OpenRouter インフラを経由します。規制対象チームは DPA とデータ経路を確認し、必要なら直接 API を選んでください。

Q: 対応モデルは？
A: 400+ モデル、70+ プロバイダ。GPT-4o、Claude 3.5 Sonnet、Gemini 2.5 Pro、Llama、DeepSeek、Qwen、Mistral 等。/api/v1/models で最新一覧を取得できます。

Q: コードを書き換えずモデル切替は？
A: model パラメータを変更し、同じ OpenAI 互換クライアントを使います。耐性が必要なら models 配列と "route": "fallback" を追加します。

Q: 直接 OpenAI/Anthropic と比べて価値は？
A: マルチモデル Agent、迅速な A/B、統合請求の中規模利用では Yes。超大規模単一ベンダー、独占 API、厳格なレイテンシ/所在地要件では No です。

公開後に追う指標：

• Google Search Console：/ja/ と /en/ のインプレッション・CTR・平均順位を分離。インプレッション 0 はインデックス問題、高インプレッション低 CTR はタイトル/meta 見直し。
• サイト内分析（Matomo/GA4）：言語別オーガニック、直帰率、チュートリアル区間の滞在時間。
• 手動スポットチェック：月 1 回、シークレットモードで「OpenRouter API 使い方」等 3〜5 コアクエリを検索し順位変動を確認。

• 400+ モデル / 70+ プロバイダ：単一 OpenAI 互換ゲートウェイ（出典：OpenRouter docs、2026年7月）。
• トークン上乗せなし：クレジット手数料 5.5% のみ、最低 $0.80（出典：OpenRouter FAQ）。
• 無料枠：未認証 約 50 req/日、$10 クレジット後 1,000 req/日・20 req/分（出典：OpenRouter FAQ）。
• BYOK：月 100 万 req 無料、超過 5%（出典：OpenRouter FAQ）。
• ゲートウェイレイテンシ：直接プロバイダ比 約 10〜80ms 追加を見込む（2026 集約ベンチ参考）。

OpenRouter は統合面（1 キー、1 SDK、組み込みフェイルオーバー）を解決しますが、ホスト問題は解決しません。数秒ごとに OpenRouter を叩く長時間 Agent は、MacBook のフタを閉じた瞬間、OAuth セッション切れ、CI ランナーの時間制限で停止します。

OpenRouter Agent ワークロードでよくある代替案の限界：（1）ローカルノート PC ホスト — スリープ、サーマルスロットリング、不安定 Wi-Fi が 7×24 ツール呼び出しを途切れさせます。（2）Linux VPS のみ — Xcode、Simulator、Metal がなく、Apple Silicon 上で macOS ネイティブ Agent スキルを検証できません。（3）共有クラウド Mac スライス — 隣接テナントの CPU スパイクがストリーミング推論と並列サブエージェントを停滞させます。iOS CI/CD とマルチモデル Agent 自動化に専有 Apple Silicon、安定 Metal、日/週/月の弾性請求が必要な本番環境では、NOVAKVM Mac Mini M4 / M4 Pro ベアメタルクラウドレンタルが通常より適した選択です。Hermes、OpenClaw、Claude Code、カスタム OpenRouter クライアントを、設定 1 ファイルでモデル差し替えしながら常時オンラインのノードで動かせます。プラン比較は NOVAKVM 料金ページ、トライアルは 注文ページ、リモート接続は ヘルプセンターをご利用ください。

以下は執筆時点の公開ソースです。上流ドキュメントが更新された場合は原典を正としてください。

OpenRouter Documentation

OpenRouter FAQ

OpenRouter Models and Pricing