OpenRouter 完全入門：1本の API Key で GPT / Claude / Gemini を横断する

複数の LLM ベンダーごとにアカウント登録、SDK 管理、請求処理を分けていると、運用コストはモデル数に比例して膨らみます。OpenRouter は、1本の API Key と OpenAI 互換エンドポイントで GPT-4o、Claude 3.5 Sonnet、Gemini 2.5 Pro、DeepSeek、Qwen など 400 超のモデルへアクセスできる統合ゲートウェイです。本記事は AI アプリ開発者とテックリード向けに、二重ルーティングの仕組み、5つの強み、公式 API との選定基準、6 ステップの接入手順、curl / Python / Node.js / OpenAI SDK のコード例、Fallback 設定までを整理します。結論：中規模の多モデル運用なら OpenRouter の移行コストはほぼゼロです。超大規模・超低遅延・厳格なデータ residency が必要な場合は各社公式 API を選んでください。

SECTION 01 多モデル連携で開発者が直面する4つの壁

• アカウントと Key の分散：OpenAI、Anthropic、Google、Meta、DeepSeek それぞれで登録・課金・SDK 対応が必要になり、モデルを増やすほど運用負荷が線形に増えます。
• 単一障害点への無防備：特定ベンダーのレート制限や障害時に、リトライ・フェイルオーバー・サーキットブレーカーを自前実装しなければなりません。
• 請求の突合が困難：複数の管理画面と請求書を横断し、token 消費量・TTFT・スループットを一元的に把握できません。
• モデル切替のコスト：モデルを変えるたびにリクエスト層の改修が発生します。DeepSeek V4 API 移行やKimi K3 多モデル比較のように、評価対象が増えるほどアダプター層の保守がボトルネックになります。

SECTION 02 OpenRouter とは？二重ルーティングの仕組み

定義：OpenRouter は LLM API の統合ゲートウェイです。1本の API KeyとOpenAI 互換エンドポイント https://openrouter.ai/api/v1/chat/completions から、70 超のベンダー・400 超のモデルを呼び出せます。認証は Authorization: Bearer $OPENROUTER_API_KEY です。モデル名は ベンダー/モデル名 形式で、例として openai/gpt-4o、anthropic/claude-3.5-sonnet、google/gemini-2.5-pro、deepseek/deepseek-chat があります。

既存の OpenAI SDK コードは base_url と api_key を差し替えるだけで、リクエストボディ・メッセージ形式・ストリーミング処理はそのまま使えます。

加えて、無料モデルは 25 超（Llama、Gemma、DeepSeek 無料枠など）あり、未入金は約 50 回/日、$10 以上入金後は 1000 回/日（20 回/分）まで利用できます。料金体系：token 単価にマークアップはなく、ベンダー原価をそのまま適用します。Credits 購入時のみ 5.5% の手数料（最低 $0.80）、暗号資産決済は別途 5% です。BYOK（Bring Your Own Key）では月 100 万リクエストまで無料、超過分は同等額の 5% サービス料が発生します。

SECTION 03 OpenRouter と OpenAI / Anthropic 公式 API の違い

5つのコア強み：① 1 Key で全モデルにアクセス、移行コストが極小；② クロスベンダー自動 Failover；③ 統一請求と用量分析；④ token マークアップなし；⑤ 多モデル比較や Agent フレームワークの統一実行に適しています。

OpenRouter が向かないケース：

• 単一モデルの超大規模利用（月額数万ドル超）で、5.5% の入金手数料を避けたい場合
• Anthropic Prompt Caching、OpenAI Batch API / Assistants API、Google Vertex AI 専用機能が必須の場合
• ゲートウェイ追加の 10–80ms が許容できない超低遅延要件
• 米国第三者中継を許容できないデータ residency / コンプライアンス要件

OpenRouter は OpenAI / Anthropic 公式 SDK の代替ではなく、「多モデル運用」と「公式直結」の間にある折衷案です。

SECTION 04 実践：OpenRouter API 接続手順とコード例

1. OpenRouter アカウント登録：openrouter.ai にアクセスし、Google / GitHub またはメールで登録して Dashboard に入ります。
2. API Key 作成：Keys ページでキーを生成し、環境変数 OPENROUTER_API_KEY に保存します。リポジトリへのコミットは避けてください。
3. 初回リクエスト送信：下記の curl または SDK サンプルで疎通と課金を確認します。
4. HTTP-Referer の設定（推奨）：HTTP-Referer と X-Title ヘッダーを付与すると、ランキング統計と用量帰属に反映されます。
5. 利用可能モデルの確認：GET /api/v1/models でリアルタイムのモデル一覧と料金を取得します。
6. Fallback チェーンの構成：本番環境では models 配列を設定し、主力モデルがレート制限に達した際の自動切替を有効にします。
7. 用量とコストの監視：Dashboard で各モデルの token 消費、TTFT、レイテンシ分布を確認し、入金アラートを設定します。

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": "Hello!"}],
    extra_headers={
        "HTTP-Referer": "https://vpsnix.com",
        "X-Title": "VPSNIX 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 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": "Hello" }]
}

主力モデルがレート制限またはエラーになった場合、OpenRouter はリスト順に次のモデルを自動試行します。アプリ側で追加のリトライロジックを書く必要はありません。

利用可能モデル一覧の取得：

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

SECTION 05 料金・無料枠・引用可能な技術データ

引用可能な技術データ：

• モデル規模：70 超ベンダー、400 超モデル、統一エンドポイント /v1/chat/completions
• プロトコル互換：OpenAI Chat Completions 形式、既存 SDK は 2 行変更で移行可能
• ルーティング：Model Routing（model フィールド）+ Provider Routing（provider オブジェクト、価格逆二乗加重）
• Failover：models 配列 + route: "fallback" で主力障害時に自動切替
• 料金：token マークアップなし、入金 5.5%、BYOK 月 100 万回無料
• 無料モデル：25 超、未入金 50 回/日 → $10 以上入金後 1000 回/日

公式ドキュメントと FAQ（公開後にリンクを再確認してください）：

OpenRouter 公式ドキュメント

OpenRouter 公式 FAQ — 料金と BYOK の説明

OpenRouter モデル一覧とリアルタイム料金

実務では、OpenRouter で多モデル推論と A/B 比較を担い、VPSNIX M4 / M4 Pro 物理ノードで Xcode ビルド、Metal デバッグ、AI Agent の 7×24 デプロイを分担する構成が効率的です。クラウド LLM がどれほど高性能でも、Hypervisor 上の仮想 macOS では iOS 証明書チェーンを安定運用できません。仮想化は EULA リスクと 20–40% の性能損失を伴います。ゼロオーバーヘッドのネイティブ算力、安定した iOS CI/CD、AI Agent 自動化が必要な本番環境では、VPSNIX のクラウド物理ノードが通常より適した選択です。100% Apple 純正ハードウェア、完全 Root 権限、Hypervisor 損失なし、日/週/月の柔軟な契約が可能です。料金は料金ページをご確認ください。OpenRouter でKimi K3やDeepSeek V4のコード推論を回しているなら、コンパイルチェーンはコンプライアンス対応の物理環境に固定することをお勧めします。

SECTION 06 よくある質問 FAQ