OpenRouter 完全入門:ゼロから GPT/Claude/Gemini 全モデル API 連携(2026 最新ガイド)

Cursor、OpenClaw、自研 Agent に GPT・Claude・Gemini を同時接続したいのに、5 セットの Key と SDK を維持したくない場合、本記事は OpenRouter 統一 LLM ゲートウェイを軸に、定義とルーティング原理、公式 API 直連との比較表、5 大メリットと「使うべきでない場面」、5 ステップ Runbook、curl/Python/Node 完全コード、Fallback 冗長化、料金と BYOK、日英 SEO 診断戦略、FAQ まで一気通貫で解説します。

抽象的神経ネットワークノードと API ルーティング可視化。OpenRouter 統一 LLM ゲートウェイを象徴

目次

1. 3 つの接続痛点:マルチベンダー Key 地獄

  1. アカウントと Key の断片化。 OpenAI、Anthropic、Google、Meta、DeepSeek それぞれに独立登録・請求・ SDK 適応が必要で、モデル変更は適応層の書き直しに等しい。
  2. レート制限と障害時の組み込みフォールトトレランスなし。 単一ベンダーが 429/500 を返すと、業務側で circuit breaker、リトライ、モデル降格ロジックを自前実装する必要がある。
  3. 請求照合コストが高い。 5 つの管理画面で Token 消費・レイテンシ・費用を個別確認し、Agent ルーティング戦略を統一最適化しにくい。

2. OpenRouter とは——統一 LLM API ゲートウェイ

OpenRouter は「統一 LLM API ゲートウェイ / 集約レイヤー」です。1 つの API Key + 1 つの OpenAI 互換 Endpoint で、70 以上のベンダー、400 以上のモデル(GPT、Claude、Gemini、Llama、DeepSeek、Qwen、Mistral 等)を呼び出せます。各ベンダーへの個別登録、SDK 接続、請求管理は不要です。

内部ルーティング機構(技術ハイライト)

決定層決定内容制御フィールド
モデル選択(Model Routing)どのモデルがリクエストに応答するかmodel フィールド、または openrouter/auto で自動選択
プロバイダ選択(Provider Routing)同一モデルをどの DC が処理するかprovider オブジェクト。デフォルトは価格の逆二乗加重で「安くて安定した」プロバイダを選択

主力プロバイダがレート制限/エラーになると、OpenRouter は次の利用可能プロバイダまたは代替モデル(models 配列)へ自動切替し、業務側が 500 を受け取ることを防ぎます。

3. OpenRouter と OpenAI / Anthropic 公式 API 直連の違い

観点OpenRouter各ベンダー API 直連
Key 数1 Key で 400+ モデルベンダーごとに独立 Key + SDK
移行コストbase_url + api_key 変更のみベンダー変更で適応層を書き直し
フェイルオーバーゲートウェイ内蔵 Fallback + プロバイダ切替自前でリトライ/降格ロジックが必要
請求統一 Dashboard で全モデル消費を可視化複数管理画面で個別照合
Token 料金markup なし、ベンダー原価公式原価(中間層なし)
チャージ手数料5.5%(最低 $0.80)、暗号資産は別途 5%なし(直接カード紐付け)
追加レイテンシゲートウェイで約 10–80ms 増最低レイテンシ
専用機能Batch API、Prompt Caching 等のベンダー専用機能非対応公式機能フルスタック

4. OpenRouter の 5 大コアメリット

  1. 1 Key で全モデル接続、移行コストほぼゼロ。 モデル変更 = model 文字列の変更。リクエスト body とストリーミングロジックは不変。
  2. プロバイダ横断の自動フェイルオーバー。 レート制限/障害時にゲートウェイ層でリトライ + 切替。業務側 circuit breaker 不要。
  3. 統一請求と用量分析。 1 Dashboard で全モデルの消費、コスト、TTFT、スループットを確認。
  4. ユーザーに優しい料金——token 上乗せなし。 チャージ時のみ 5.5%。BYOK モードは月 100 万リクエストまで手数料 0。
  5. 用途が明確。 迅速なプロトタイプ、多モデル A/B テスト、中小規模(月数千ドル以内)、Fallback による可用性向上に最適。

5. OpenRouter を使うべきでない場面(信頼を築くバランス視点)

6. 実践チュートリアル——OpenRouter API 5 ステップ連携

ステップ 1 — OpenRouter アカウント登録

openrouter.ai で登録。チャージアラートも設定し、Agent の無限ループによる额度消費を防ぎましょう。

ステップ 2 — API Key 取得

Dashboard → Keys → Create Key。環境変数に保存し、Git へコミットしない

export OPENROUTER_API_KEY="sk-or-v1-..."

ステップ 3 — 初回リクエスト(疎通確認)

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": "量子コンピューティングを一文で説明して"}] }'

ステップ 4 — OpenAI SDK へ切替(ゼロコスト移行)

既存 OpenAI コードは 2 行変更のみ:

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://your-domain.com", "X-Title": "My Agent Demo", }, ) print(completion.choices[0].message.content)

ステップ 5 — Fallback 設定と Mac クラウド 7×24 デプロイ

本番 Agent では models 降格チェーンを設定し、Gateway を VPSMAC Mac クラウドの launchd 常駐へ移行——詳細は応用セクションと結論を参照。

7. コード例(curl / Python / Node.js / OpenAI SDK)

7.1 Python(requests ネイティブ)

import requests, os 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"])

7.2 Node.js(OpenAI SDK)

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: "Explain OpenRouter in one sentence" }], }); console.log(completion.choices[0].message.content);

7.3 ストリーミング出力

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

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

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

8. 応用——Fallback 冗長化、無料モデル、コスト管理

8.1 マルチモデル 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 が順番に次を試行。業務側の追加リトライロジックは不要。

8.2 無料モデルとクォータ

OpenRouter は 25 以上の無料モデル(一部 Llama、Gemma、DeepSeek 無料枠)を提供。未チャージは約 50 回/日。$10 以上チャージ後は 1000 回/日、20 回/分 に増加。プロトタイプ向け。本番の機密データは有料 API を使用。

8.3 料金メカニズム

9. 引用可能な技術要点

10. 日英 SEO 戦略とページトラフィック診断

VPSMAC のような自社日英ブログで OpenRouter チュートリアルを公開する場合、日英ページのトラフィック差は以下の要因が重なる——優先度順に自己診断を推奨:

10.1 クロールとインデックス層(P0、最も見落とされがち)

10.2 コンテンツ層

10.3 日本語キーワードマトリクス(タイトル/H2/FAQ カバー)

コア:OpenRouter、OpenRouter API、OpenRouter 使い方。ミドル:OpenRouter とは、OpenAI との違い、無料モデル、料金。ロングテール:API Key 取得方法、対応モデル、Claude 直連との比較、安全か。

10.4 英語キーワードマトリクス(ローカライズ再執筆、直訳不可)

コア:OpenRouter API, OpenRouter tutorial。比較系高 CV:OpenRouter vs OpenAI API, is OpenRouter worth it。How-to:OpenRouter Python example, OpenRouter fallback routing, OpenRouter streaming response。

10.5 公開と配信チャネル

チャネル言語用途
Qiita / Zenn / note日本語チュートリアル配信、国内技術読者獲得
dev.to英語技術チュートリアル読者層、canonical バックリンク可
Hacker News / Reddit英語垂直オーディエンス、初期被リンク獲得
Google Search Console日英sitemap 送信、パス別 Impressions 確認

10.6 効果追跡指標

GSC で /en//ja/ を分けて Impressions を確認——Impressions 0 はインデックス問題、Impressions 高 CTR 低はタイトル/説明問題。毎月シークレット検索でコアキーワード 3–5 件の順位を確認。

11. よくある質問 FAQ

OpenRouter は有料ですか? 有料モデルは token 原価課金。チャージ時 5.5%。25 以上の無料モデルに日次上限あり。

日本から使えますか? ネットワーク出口の安定性に依存。本番 Agent は Mac クラウドノードからのリクエストを推奨。

対応モデルは? 400 以上。ベンダー/モデル名 形式。/api/v1/models で照会。

安全ですか? トラフィックは第三者ルーティング経由。コンプライアンス要件がある場合は直連または自ホスト。

OpenAI SDK と互換? 完全互換。base_url と api_key を変更するだけ。

英語ページにトラフィックがない? まず GSC インデックス確認。機翻か、英語検索意図に合ったキーワードかを確認。

12. 結論と選型アドバイス

ノート PC や Windows/Linux 一般 VPS で OpenRouter Agent を動かすと、ローカル蓋閉じ断線、純 Linux で Apple ツールチェーン欠如、ネットワーク揺らぎで Gateway と API が同時タイムアウト——といった問題が起きやすい。OpenRouter は「多モデル統一接続」を解決しますが、ランタイム環境が Agent の 7×24 安定性を決めます。Docker は柔軟ですが、追加抽象層、トラブルシュート複雑化、性能折损があります。

2026 ベストプラクティス:OpenRouter でモデル選択 + 自前 API Key + VPSMAC Mac クラウドで OpenClaw Gateway 運用——モデル切替は Route 変更のみ。ランタイムはネイティブ macOS + launchd で常駐。OpenRouter 接続検証が完了したら、Mac クラウドで launchd 検収と Fallback プローブを実施し、Gateway がローカルマシンのスリープと一緒に止まらないようにしましょう。