OpenRouter API 完全ガイド:GPT・Claude・Gemini 全モデル接入(2026年版)

約18分で読了 · MACCOME · 2026年7月24日

こんな方におすすめです。GPT・Claude・Gemini を同一アプリから呼び出したい AI 開発者、独立開発者、多言語テックブログの SEO 担当者。結論:OpenRouter は 1 つの API Key と OpenAI 互換 Endpoint で 70+ プロバイダー、400+ モデルにアクセスでき、モデル切替は model 文字列の変更だけで済みます。本記事の内容:6 つの課題、ルーティング原理表、OpenRouter vs 直連比較、5 つの利点と不向きな場面、curl/Python/Node コード、料金、英語ページ流量診断、多言語 SEO、P0–P2 チェックリスト、FAQ です。

OpenRouter API 接入で直面する 6 つの課題

マルチモデル Agent 時代、「モデルを変えるたびに SDK を書き直す」コストは見落とされがちです。OpenRouter API 導入前にチームがつまずく点は次のとおりです。

  1. 複数アカウント・複数 Key・複数請求書。OpenAI、Anthropic、Google それぞれで登録とクォータ管理が必要で、FinOps 負担が増えます。
  2. プロバイダー側のレート制限=サービス停止。429/5xx 時に circuit breaker を自前実装していないと、ユーザーにエラーがそのまま表示されます。
  3. モデル切替=リファクタ。SDK ごとにメッセージ形式・ツール呼び出し・ストリーム処理が異なり、A/B テストコストが過小評価されます。
  4. レイテンシとコンプライアンスのトレードオフ。集約ゲートウェイは約 10–80ms の追加ホップがあります。米国経由の第三者ゲートウェイが許されない場合、OpenRouter は適しません。
  5. 料金の誤解。「5.5% 手数料」が token 単価への上乗せと混同されがちですが、実際は Credits 購入時のみです。
  6. 英語ページのトラフィック低迷。中国語の直訳、hreflang 欠落、CDN が Googlebot を遮断する等、技術 SEO の問題が重なります(後述の診断リスト参照)。

OpenRouter とは?ルーティング機構の解説

OpenRouter は統一 LLM API ゲートウェイ/集約レイヤーです。Endpoint は https://openrouter.ai/api/v1/chat/completions、認証は Authorization: Bearer $OPENROUTER_API_KEY、プロトコルは OpenAI Chat Completions 互換です。既存の OpenAI SDK コードは通常 base_urlapi_key の変更だけで動作します。

モデル命名:プロバイダー/モデル名(例:openai/gpt-4oanthropic/claude-3.5-sonnetgoogle/gemini-2.5-pro)。openrouter/auto で自動選択も可能です。

決定層決定内容制御フィールド
モデルルーティングどのモデルが応答するかmodel または openrouter/auto
プロバイダールーティング同一モデルをどのデータセンターが処理するかprovider オブジェクト(デフォルトは価格の逆二乗加重)
自動 Failover主力が制限された際の切替models 配列 + route: "fallback"

OpenRouter と OpenAI / Anthropic API 直連の違い

観点OpenRouter公式 API 直連
接入コスト1 Key、1 Endpointプロバイダーごとに登録・Key・SDK
モデル切替model 文字列の変更のみSDK とアダプター層の変更が必要な場合が多い
可用性プロバイダー横断 Failover 内蔵自前でリトライ・circuit breaker が必要
レイテンシゲートウェイで +10–80ms 程度通常はより低い
料金token 原価透過;チャージ 5.5%中間層手数料なし;大用量は enterprise 交渉可
専用機能汎用 Chat CompletionsBatch API、Assistants、Prompt Caching、Vertex ツールチェーン等
コンプライアンス第三者ゲートウェイ経由データ residency・enterprise 契約を選択可能

詳細な選定フレームワークは OpenRouter マルチモデルルーティング決定マトリクス をご参照ください。

OpenRouter の 5 つの利点と「使うべきでない場面」

5 つの利点

  1. 1 Key で全モデルにアクセス——移行コストがほぼゼロ、モデル変更でビジネスロジックを書き換える必要がありません。
  2. プロバイダー横断 Failover——レート制限・障害をゲートウェイ層で処理、circuit breaker の自前実装が不要です。
  3. 統一ダッシュボード——全モデルの token 消費、コスト、TTFT を一画面で確認できます。
  4. token マークアップなし——プロバイダー原価;BYOK は月 100 万リクエストまでサービス料無料です。
  5. 25+ 無料モデル——プロトタイプと A/B テストのコストを抑えられます。

公式 API 直連が適する場面

  • 単一モデルで月額数万ドル以上——5.5% チャージ手数料を避ける価値があります。
  • Anthropic Prompt Caching、OpenAI Batch/Assistants、Google Vertex 専用ツールが必要な場合。
  • レイテンシが極めて重要(リアルタイム音声、高頻度取引向け)。
  • 米国第三者ゲートウェイ経由がコンプライアンス上許されない場合。

OpenRouter 料金:無料枠、Credits、BYOK

項目ルール
無料モデル25+ モデル;未チャージ約 50 回/日;$10 以上チャージ後 1000 回/日、20 回/分
有料モデルプロバイダー原価で token 課金;token markup なし
チャージ手数料5.5%(最低 $0.80);暗号資産は別途 5%
BYOK自社プロバイダー Key 利用;月 100 万リクエストまで無料、超過分 5%

OpenRouter API コード例:curl / Python / Node / ストリーム / Fallback

cURL 基本リクエスト

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

Python(OpenAI SDK ドロップイン置換)

python
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": "Hello!"}],
    extra_headers={
        "HTTP-Referer": "https://maccome.com",
        "X-Title": "MACCOME Blog Demo",
    },
)
print(completion.choices[0].message.content)

Node.js(OpenAI SDK)

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

ストリーミング出力

javascript
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

json
{
  "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" }]
}

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

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

補足:Agent ゲートウェイ(OpenClaw マルチプロバイダールーティング)では OpenRouter を統一 upstream として利用できます。Fallback チェーンは Gateway 設定と整合させ、二重リトライを避けてください。

6 段階 Runbook:登録から初回 API 呼び出しまで

  1. OpenRouter アカウント登録——openrouter.ai で Email 認証を完了します。
  2. API Key 作成——Keys ページで Key を生成し、シークレット管理に保存します(リポジトリにコミットしないでください)。
  3. (任意)Credits チャージ——有料モデル利用または無料枠拡大時に $10 以上チャージします。5.5% はチャージ時のみです。
  4. 環境変数設定——export OPENROUTER_API_KEY=sk-or-... をローカルまたは CI シークレットに設定します。
  5. curl で疎通確認——claude-3.5-sonnet または無料モデルで HTTP 200 を確認します。
  6. OpenAI SDK 接入——base_urlapi_key を変更し、HTTP-Referer ヘッダーを付与します。
  7. Fallback チェーン設定——本番環境で models 配列を設定し、主力のレート制限に備えます。

英語ページのトラフィックが低い理由:診断チェックリスト

クロール・インデックス層(最優先)

  • CDN/WAF が Googlebot を遮断——Search Console の「URL 検査」でシミュレート取得してください。
  • hreflang 欠落——Google が中国語版のみを canonical とみなし、英語版を重複と判断する可能性があります。
  • robots.txt/en/ を誤って disallow、sitemap に言語別 URL が未掲載。
  • CSR のみで HTML が空——クローラーが本文を取得できず、長期間インデックスされません。

コンテンツ層

  • 英語が中国語の直訳——"OpenRouter vs OpenAI API" 等のネイティブ検索語に合わせる必要があります。
  • E-E-A-T 不足——著者情報・実測データがなく、評価が下がります。

修復順序(費用対効果順)

  1. Search Console で英語ページのクロール状況を確認します。
  2. CDN/WAF ログを調査します。
  3. hreflang、canonical、sitemap の言語別标注を補完します。
  4. 重点記事 3–5 本を英語ネイティブ表現で書き直します(機械翻訳不可)。
  5. dev.to / Reddit / Hacker News で初期配信します。

日本語 SEO 戦略と構造化データ

コアキーワード:OpenRouter API、OpenRouter 使い方、OpenRouter チュートリアル。中間:OpenRouter と OpenAI の違い、無料モデル、料金。ロングテール(FAQ):API Key の取得方法、Python 呼び出し、安全か。

タイトル・リード・H2 にコアキーワードを自然に配置し、FAQPage JSON-LD を併用してください(本ページ head に実装済み)。

多言語サイト技術:hreflang / canonical / sitemap

MACCOME は /ja//en//zh/ 等のサブディレクトリ構成です。各言語版の canonical は自身を指し、hreflang で 8 言語を相互宣言します(本ページ参照)。sitemap では言語別 URL を個別に列挙し alternate を付与します。

配信チャネル一覧

チャネル言語用途
Qiita / Zenn日本語技術チュートリアル配信
dev.to英語canonical リンク付き再投稿
Hacker News / Reddit英語深度コンテンツ、垂直コミュニティ
X(Twitter)日英短い要約と初期クリック信号

P0–P2 アクションリストと効果測定

P0(今週:止血)

  • Search Console で英語ページのクロール/インデックスを確認します。
  • CDN/WAF の Googlebot 遮断を調査します。
  • hreflang、canonical、独立 sitemap エントリを補完します。

P1(執筆・公開)

  • 言語ごとに独立原稿を作成します(コード共有、論述はローカライズ)。
  • キーワードをタイトル、リード、H2、FAQ に配置します。
  • BlogPosting + FAQPage Schema を実装します。

P2(配信・追跡)

  • 日本語は Qiita/Zenn、英語は dev.to に配信します。
  • 言語別 sitemap を Search Console に送信します。

追跡指標

  • GSC:/en//ja/ で Impressions を分離——0 表示=インデックス問題
  • サイト分析:言語別オーガニック、直帰率、滞在時間。
  • 毎月シークレットモードでコアキーワード 3–5 件を確認します。

引用可能な 3 つの数値

  • 70+ プロバイダー、400+ モデル——Endpoint /v1/chat/completions で統一接入(OpenRouter 公式ドキュメント)。
  • 25+ 無料モデル——未チャージ 50 回/日、$10 チャージ後 1000 回/日(公式 FAQ)。
  • チャージ 5.5%、token markup なし——BYOK は月 100 万リクエストまで無料(料金ページ)。

まとめ:OpenRouter はマルチモデル原型に最適、本番 Agent には安定実行環境が必要

OpenRouter は「複数 Key・複数 SDK・Failover なし」の接入課題を解決し、2026 年のマルチモデル Agent にとって高コスパな出発点です。ただしノート PC のスリープは MCP 長時間接続を切断し、ローカルの sleep ポリシーでは 7×24 Cron Agent を保証できません——これらは OpenRouter 自体では解決できない実行環境の問題です。

Claude Code、OpenClaw Gateway、自社 Agent を OpenRouter 上で運用する場合、runtime を MACCOME クラウド Mac mini(M4/M4 Pro)専用ノードに固定する方が、ローカル PC のスリープ対策より安定します。詳細は Mac レンタル料金OpenRouter CLI ツールランキング をご参照ください。

最終更新:2026年7月24日 | 参考:OpenRouter 公式ドキュメント

よくある質問

OpenRouter は有料ですか?

25+ の無料モデルがあります(未チャージ約 50 回/日)。有料モデルはプロバイダー原価で token 課金され、token への上乗せはありません。Credits 購入時に 5.5% の手数料(最低 $0.80)がかかります。

OpenRouter と OpenAI API 直連の違いは?

OpenRouter は統一 Endpoint と Failover を提供します。直連はレイテンシが低く Batch/Assistants 等にアクセスできます。月額数万ドル以上または高コンプライアンス要件では直連が有利です。

OpenRouter を Python から呼び出すには?

OpenAI SDK で base_url="https://openrouter.ai/api/v1"OPENROUTER_API_KEY を設定してください。完全なコードは第 6 節をご参照ください。

OpenRouter は token に上乗せ料金がありますか?

いいえ。公式 FAQ で token markup なしと明記されています。BYOK モードでは月 100 万リクエストまでサービス料無料です。

OpenRouter は安全ですか?

リクエストは OpenRouter ゲートウェイを経由してプロバイダーにルーティングされます。機密データは各プロバイダーの DPA を確認してください。高コンプライアンス要件では BYOK または直連を検討してください。

Mac 上で OpenRouter Agent を安定稼働させるには?

ノート PC のフタ閉じは Agent を中断します。MACCOME の M4/M4 Pro クラウド Mac ノードで 7×24 実行が可能です。詳細は Mac レンタル料金 をご覧ください。

英語ページのトラフィックが低いのはなぜですか?

hreflang 欠落、CDN による Googlebot 遮断、中国語直訳の英語コンテンツが主因です。P0 チェックリストでインデックスを確認し、英語タイトルと FAQ をネイティブ表現で書き直してください。