OpenRouter API完全ガイド
GPT/Claude/Geminiを1つのキーで呼び出す（2026年版）

多ベンダー API の断片化：統一ゲートウェイ導入前の 5 つの痛点

OpenRouter の本質は統一 LLM API ゲートウェイ（Unified LLM Gateway）です。1 本の API Key を維持するだけで、OpenAI 互換プロトコル経由で OpenAI、Anthropic、Google、DeepSeek など各社のモデルにアクセスでき、ベンダーごとの認証層や SDK アダプタを個別に書く必要がありません。移行を判断する前に、「複数ベンダーへの直接接続」が本番環境で生む 5 つの隠れコストを整理しておくことをおすすめします。

1. 01

   複数 Key のローテーション負荷：GPT、Claude、Gemini それぞれに独立したアカウントと請求が必要です。Key の漏洩対応、クォータ監視、アラートが 3 つのコンソールに分散し、運用面が指数的に膨らみます。

2. 02

   SDK の方言コスト：多くのベンダーが OpenAI 形式をサポートしていても、base_url、Header（Anthropic のバージョン番号など）、ストリーミングフィールド、tool call スキーマに差があります。Agent フレームワークでモデルを切り替えるたびに複数箇所の修正が発生します。

3. 03

   Failover の自前実装：主モデルが 429 やダウン時に、リトライチェーン、指数バックオフ、予備モデルマッピングを自前で書く必要があります。統一ルーティング層がないと、新モデル追加のたびにビジネスコードを変更しなければなりません。

4. 04

   料金照合の負荷：各ベンダーの課金単位、キャッシュ割引、batch ルールが異なり、FinOps では「同じ prompt を別モデルに渡すといくら変わるか」を 1 枚の表で比較しにくくなります。

5. 05

   無料枠の分散：各プラットフォームの無料 tier ルールはバラバラです。OpenRouter は 25+ 無料モデルを集約し、クォータも統一しています（未チャージ 50 回/日、$10 チャージ後 1000 回/日、20 回/分）。ただしプラットフォーム料と BYOK の境界は理解が必要です。

上記の痛点を把握したうえで、次節のルーティング機構と比較表を参照し、OpenRouter がレイテンシ、コンプライアンス、呼び出し量の前提に合うかを判断してください。

6 ステップ Runbook：登録から fallback チェーン検証まで

以下 6 ステップで 30 分以内に初回呼び出しまで到達できます。各ステップの成果物はチーム README に記載し、新メンバーの onboarding に活用してください。

1. 01

   アカウント登録：openrouter.ai にアクセスし、GitHub またはメールでアカウントを作成します。

2. 02

   API Key 作成：Keys ページで Key を生成し、直ちにコピーします。本番環境では Git にコミットせず、シークレット管理サービスで保管してください。

3. 03

   環境変数設定：export OPENROUTER_API_KEY="sk-or-..." とし、CI/CD とローカル .env で命名を統一します。

4. 04

   初回 curl 検証：/v1/chat/completions へ POST し、200 応答と choices[0].message 構造を確認します。

5. 05

   OpenAI SDK 設定：Python/Node で base_url を OpenRouter に向け、任意で HTTP-Referer と X-Title を追加してランキング統計に参加できます。

6. 06

   fallback チェーンのテスト：models 配列を使うか、意図的に利用不可モデルを指定し、auto failover で予備モデルへ切り替わることをログで確認します。

curl 初回リクエスト

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello from OpenRouter"}]
  }'

Python requests

import os, requests

resp = requests.post(
    "https://openrouter.ai/api/v1/chat/completions",
    headers={
        "Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "anthropic/claude-sonnet-4",
        "messages": [{"role": "user", "content": "Explain Model Routing vs Provider Routing"}],
    },
)
print(resp.json()["choices"][0]["message"]["content"])

Python OpenAI SDK（HTTP-Referer / X-Title 付き）

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
    default_headers={
        "HTTP-Referer": "https://your-app.example.com",
        "X-Title": "My Agent App",
    },
)

completion = client.chat.completions.create(
    model="google/gemini-2.5-pro-preview",
    messages=[{"role": "user", "content": "Summarize OpenRouter pricing"}],
)
print(completion.choices[0].message.content)

Node.js OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
  defaultHeaders: {
    "HTTP-Referer": "https://your-app.example.com",
    "X-Title": "My Agent App",
  },
});

const res = await client.chat.completions.create({
  model: "openai/gpt-4o",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(res.choices[0].message.content);

JavaScript ストリーミング出力

const stream = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-4",
  messages: [{ role: "user", content: "Stream this response" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

Fallback モデルチェーン（JSON）

{
  "model": "openai/gpt-4o",
  "models": [
    "openai/gpt-4o",
    "anthropic/claude-sonnet-4",
    "google/gemini-2.5-flash-preview"
  ],
  "messages": [{"role": "user", "content": "If primary fails, try fallbacks"}]
}

curl でモデル一覧取得

curl https://openrouter.ai/api/v1/models \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" | jq '.data[] | {id, pricing}'

引用可能なハードデータ、開発者向け SEO、本番デプロイの整理

以下の数値は技術方案や README に直接引用できます。出典は OpenRouter 公式ドキュメントとプラットフォーム公開データ（2026 年 7 月）です。

• プロバイダー規模：同一ゲートウェイ後ろに 70+ inference プロバイダーを集約しています。
• モデル数：400+ モデル。命名規則は vendor/model です。
• 無料モデル：25+ モデル。未チャージ 50 回/日、$10 チャージ後 1000 回/日、20 回/分です。
• プラットフォーム料：チャージ 5.5%（最低 $0.80）。BYOK 100 万 req/月 無料枠、超過 5% です。
• レイテンシ overhead：直接接続比で通常 10–80ms 増加（リージョンと provider により変動）します。

開発者向け多言語 SEO と英語トラフィック診断

Agent 製品や技術ブログが中英日の開発者に同時リーチする場合、OpenRouter 系 API ドキュメントの SEO では次の実践が重要です（単純な機械翻訳では不十分です）。

• hreflang マトリクス：各言語ページは canonical と hreflang を相互参照する必要があります。同一 URL に複数言語が混在すると Google が duplicate と判定します。
• CDN / WAF と Googlebot：一部 CDN のデフォルトルールが海外クローラーを誤ブロックします。Search Console の URL 検査で英語ページが Googlebot に取得可能か確認してください。
• 機械翻訳英文の禁止：英語ページは母語の技術ライティングで書き直す必要があります（用語、コードスタイル、検索語）。中文からの一括翻訳は EEAT と直帰率を同時に損ないます。
• キーワードマトリクス：日本語は「OpenRouter チュートリアル / API 接続 / 無料モデル」、英語は "OpenRouter API guide", "unified LLM gateway", "OpenAI compatible multi-model" など。コード例の model ID は全球共通に保ちます。

OpenRouter は「多モデル API 統合接続」を解決しますが、ローカル開発機がスリープ、OS 更新、プロセス kill により 7×24 Agent、cron、webhook コールバックを中断させる問題は別です。API Key が安定してもホストが不安定なら failover チェーンは空転します。ノート PC を閉じると OpenClaw、LangGraph、自前 daemon の SLA は保証できません。純 Linux VPS には Apple Silicon と macOS ツールチェーンがありません。長期稼働の AI Agent と自動化パイプラインには、VpsMesh の Mac Mini クラウドレンタルが通常より適した選択です。専用ノード、柔軟な契約期間、監査可能な環境で、OpenRouter ルーティング戦略を真に 7×24 オンラインのホスト上で動かせます。ローカルマシンが今夜フタを閉じないかに賭ける必要はありません。詳細はMac Mini M4 レンタル料金とヘルプセンターをご参照ください。