OpenRouter API 完全ガイド：
GPT・Claude・Gemini を1キーで呼び出す（2026）

OpenRouter はモデルベンダーではなく、複数プロバイダを束ねる集約レイヤーです。認証は Authorization: Bearer $OPENROUTER_API_KEY を用い、リクエスト形式は OpenAI Chat Completions と同一のため、base_url と api_key を差し替えるだけで既存の OpenAI SDK コードが動作します。モデル名は provider/model 形式（例：openai/gpt-4o、anthropic/claude-3.5-sonnet、google/gemini-2.5-pro）です。

直結 API だけでは解決しにくい課題は次のとおりです。

• アカウントの分散：OpenAI、Anthropic、Google、Meta、DeepSeek ごとにキー、SDK、請求ポータルを別管理する必要があります。
• 組み込み failover の欠如：あるプロバイダがレート制限や障害に陥った場合、リトライとプロバイダ切り替えを自前実装しなければなりません。
• コスト集計の断片化：5 つのダッシュボードを毎月突合する運用はミスが起きやすく、予算管理が困難です。
• モデル比較の試行コスト：A/B テストのたびに SDK と認証方式を書き換える手間が積み上がります。
• エージェント基盤の不安定さ：ノート PC のスリープや Linux VPS では Xcode/Metal が使えず、長時間エージェントジョブが途中で停止しがちです。

OpenRouter は各リクエストで 2 層のルーティング判断を行います。

• 自動 failover：レート制限やエラー時、models 配列で次のプロバイダまたはフォールバックモデルへ切り替え、アプリ側が 500 エラーを受け取らない設計が可能です。
• 無料枠：25 以上の無料モデル、Credits 未購入で 1 日約 50 回、$10 以上チャージ後は 1 日 1,000 回・20 回/分まで利用できます。
• 料金モデル：token 単価への上乗せなし。Credits 購入時に 5.5%（最低 $0.80）の手数料。BYOK モードは月 100 万リクエストまで無料、その後は相当使用量の 5%。

本番投入前に、公式ドキュメントで最新の挙動を再確認してください。

https://openrouter.ai/docs

https://openrouter.ai/docs/faq

• 1 キーですべてのモデル：文字列 1 つを差し替えるだけで GPT から Claude へ切り替え、ベンダーごとの adapter 層が不要です。
• 組み込み failover：models: ["anthropic/claude-3.5-sonnet", "openai/gpt-4o", "google/gemini-2.5-pro"] を設定すれば、ゲートウェイがサーキットブレークを処理します。
• 統合ダッシュボード：token 消費、レイテンシ（TTFT）、スループットを 1 画面で確認できます。
• token 上乗せなし：多くの aggregator と異なり、プロバイダ単価をそのまま透過。5.5% は Credits 購入時のみです。
• 最適な利用シーン：プロトタイピング、マルチモデル A/B テスト、月 $10k 未満のワークロード、あらゆる frontier モデルで動くエージェントフレームワーク。

OpenRouter を選ぶべきでない場面：月数万ドル規模の単一モデル利用で 5.5% の Credits 手数料が直結統合コストを上回る場合。Anthropic Prompt Caching、OpenAI Batch/Assistants、Google Vertex などベンダー固有機能が必須の場合。ゲートウェイ経由の追加 10〜80ms が許容できない超低レイテンシパス。米国第三者ルーティングがコンプライアンス上禁止されている場合。

メリットとデメリットを正直に書くことで E-E-A-T が高まり、「OpenRouter vs OpenAI API」「OpenRouter 使う価値ある」といった実際の検索意図に合致します。

1. アカウント作成：openrouter.ai で GitHub またはメールアドレスを使って登録します。
2. API キー生成：Settings → Keys からキーを発行し、OPENROUTER_API_KEY として環境変数に保存します。git へのコミットは禁止です。
3. Credits チャージ（任意）：無料モデルは未課金でも利用可能です。有料モデルには Credits が必要で、$10 以上のチャージで無料枠の上限が引き上がります。
4. モデル選定：Models ページまたは GET /api/v1/models から provider/model 文字列を控えます。
5. 初回リクエスト送信：https://openrouter.ai/api/v1/chat/completions に POST し、choices[0].message.content が返ることを確認します。
6. 本番向け硬化：HTTP-Referer と X-Title ヘッダーを追加し、models フォールバックチェーンを設定します。エージェントプロセスは常時稼働の macOS ホスト上で実行し、ノート PC のスリープによるジョブ中断を防ぎます。

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

from openai import OpenAI
import os

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://calmvps.com",
        "X-Title": "CALMVPS Blog 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);

ストリーミング応答：

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

高可用性のためのモデル Fallback：

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

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

• エンドポイント：https://openrouter.ai/api/v1/chat/completions
• カタログ規模：70+ プロバイダ、400+ モデル
• 無料モデル：25 以上、Credits 未購入で 1 日約 50 回、$10 以上チャージ後 1 日 1,000 回
• Credits 手数料：購入額の 5.5%（最低 $0.80）、暗号資産決済は +5%
• BYOK：自社プロバイダキーを持ち込み、月 100 万リクエストまで無料、その後相当使用量の 5%
• ゲートウェイレイテンシ：直結 API 比でおおよそ 10〜80ms の追加

モデルごとの token 単価は OpenRouter Models ページで公開されており、プロバイダの改定に追随して変動します。発版後はリンク先を再度開いて最新値を確認してください。

https://openrouter.ai/models

• OpenRouter は無料ですか？25 以上のモデルがレート制限付きで無料です。有料モデルはプロバイダ単価が適用され、Credits 購入時に 5.5% の手数料が加算されます。
• token に上乗せはありますか？いいえ。上乗せは Credits 購入手数料のみです。
• 使う価値はありますか？マルチモデルアプリと failover 要件には有効です。単一ベンダー大規模利用やコンプライアンス厳格なワークロードには直結 API が適します。
• 対応モデルは？400 以上。/api/v1/models で最新一覧を取得できます。
• 安全ですか？トラフィックは米国ゲートウェイを経由します。機密データには BYOK または直結 API を検討してください。
• OpenRouter と OpenAI API の違いは？OpenRouter は OpenAI モデルに加え Anthropic、Google、DeepSeek など複数プロバイダを 1 キーで呼び出すゲートウェイです。
• 料金体系は？従量課金（プロバイダ単価透過）+ Credits 購入手数料。固定月額サブスクリプションはありません。
• Python からの呼び出し方は？OpenAI SDK の base_url を https://openrouter.ai/api/v1 に変更するか、requests で POST します。

日英バイリンガルで技術ブログを運営しているのに英語版のインプレッションがゼロのままなら、次のレイヤーを順に確認してください。

P0 — クロールとインデックス（最優先）：

• CDN/WAF が Googlebot をブロック：ブラウザ表示だけでなく Google Search Console の URL 検査で確認します。
• hreflang の欠落：Google が英語版を日本語版の重複と判断する可能性があります。
• robots.txt / noindex の誤設定：/en/ パスが disallow されていないか確認します。
• サイトマップの漏れ：言語ごとに別エントリと alternate 注釈を設定します。
• CSR の空シェル：SSR/SSG なしの SPA はクローラーに空 HTML を返します。

P1 — コンテンツ（翻訳ではなく書き直し）：

• 英語ユーザーは「OpenRouter vs OpenAI API」「is OpenRouter worth it」を検索し、日本語見出しの直訳は刺さりません。
• クエリファンアウトを 1 記事でカバー：定義、使い方、料金、比較、安全性、制限事項。
• 実測請求額、レイテンシ、バージョン番号など検証可能な具体値で E-E-A-T を高めます。

英語キーワードターゲット：OpenRouter API、OpenRouter tutorial、OpenRouter vs OpenAI API、OpenRouter Python example、OpenRouter OpenAI SDK drop-in replacement、OpenRouter fallback routing、is OpenRouter free。

日本語キーワードターゲット：OpenRouter API、OpenRouter 使い方、OpenRouter 料金、OpenRouter vs OpenAI、OpenRouter Python、OpenRouter 無料モデル、OpenRouter チュートリアル。

テクニカル SEO：サブディレクトリ URL（/ja/、/en/）、自己参照 canonical、BlogPosting + FAQPage JSON-LD、GSC で言語プレフィックス別プロパティを分離。

配信：dev.to、Reddit（r/LocalLLaMA、r/programming）、Hacker News、Indie Hackers など英語圏コミュニティ。日本語圏だけにリンクを集約すると英語版は評価されにくくなります。

• 今週 P0：GSC で /en/ のインデックス確認、CDN/WAF ログ監査、hreflang・canonical・サイトマップ修正。
• P1 執筆：日本語と英語を独立原稿として作成。タイトル、導入、H2、FAQ にキーワードを配置し、構造化データを追加。
• P2 配信：dev.to とコミュニティ投稿、GSC と百度サイトマスターツールへ各言語 URL を個別送信。

言語プレフィックス別に計測：GSC の /en/ と /ja/ のインプレッション・CTR を分離。インプレッションゼロはランキング以前のインデックス問題です。Umami、Plausible、GA4 で直帰率と滞在時間を追跡し、月次で 3〜5 コアキーワードをシークレットモードの米国 Google で確認します。

OpenRouter はモデルルーティングを解決しますが、エージェントランタイムには信頼できるホストが依然として必要です。ノート PC のスリープ、Xcode/Metal 非対応の Linux VPS、共有 VM のリソース競合は、Cursor、OpenClaw、OpenRouter を呼び出すカスタムエージェントでよくある障害原因です。

iOS CI/CD と常時稼働 AI エージェント自動化の本番環境では、CALMVPS の Mac Mini 裸金属レンタルがより安定した基盤となります。専有 Apple Silicon、root 権限、7×24 稼働、120 秒プロビジョニングにより、ゲートウェイと推論バックエンドを分離し、モデルを差し替えてもランタイムの安定性に影響を与えません。