OpenRouter 保姆级教程
从0到1接入 GPT / Claude / Gemini 全模型 + 双语 SEO 实战（2026）

OpenRouter 是什么？统一调用 GPT / Claude / Gemini 的 API 网关

OpenRouter 是一个「统一 LLM API 网关 / 聚合层」：用一个 API Key + 一个 OpenAI 兼容的 Endpoint，即可调用来自 70+ 家供应商、400+ 个模型（GPT、Claude、Gemini、Llama、DeepSeek、Qwen、Mistral 等），而不需要为每个厂商单独注册账号、接入 SDK、管理账单。

• 统一 Endpoint：https://openrouter.ai/api/v1/chat/completions
• 认证方式：Authorization: Bearer $OPENROUTER_API_KEY
• 兼容协议：OpenAI Chat Completions 格式，已有 OpenAI SDK 代码基本不用改，只需换 base_url 和 api_key
• 模型命名：供应商/模型名，如 openai/gpt-4o、anthropic/claude-3.5-sonnet、google/gemini-2.5-pro、deepseek/deepseek-chat

双层路由机制：Model Routing + Provider Routing

OpenRouter 内部做了两件独立的路由决策——这是理解其技术价值的关键：

此外：自动故障转移（Fallback）——主力供应商限流/报错时，OpenRouter 自动切换下一个可用供应商或备选模型（models 数组），业务侧不会收到 500。

开发者接入前必须知道的五大痛点

1. 01

   多厂商账号碎片化：OpenAI、Anthropic、Google 各需独立注册、Key 管理与 SDK 适配，Agent 框架切换模型时代码改动大。

2. 02

   单一供应商限流/宕机：直连 API 时业务代码须自己写 circuit breaker 与重试逻辑，生产可用性难保障。

3. 03

   账单分散对账：5 个后台分别看消耗、延迟与成本，中小团队财务口径难统一。

4. 04

   聚合服务 token 加价：多数同类网关会在 token 单价上加价，长期成本不透明。

5. 05

   网关额外延迟：OpenRouter 网关会增加约 10–80ms 跳数，对延迟极度敏感的场景需评估。

6. 06

   数据合规中间层：流量经过美国第三方网关，有数据驻留要求的场景可能不符合合规。

实战教程：6 步接入 OpenRouter API + 全套代码示例

1. 01

   注册账号：访问 openrouter.ai，用 GitHub 或邮箱注册。

2. 02

   创建 API Key：进入 Keys 页面，生成 Key 并妥善保存（只显示一次）。

3. 03

   充值 Credits（可选）：调用付费模型需充值；免费模型可跳过此步（有频率限制）。

4. 04

   发起第一次请求：用下方 cURL 或 SDK 示例验证 Key 有效。

5. 05

   配置 OpenAI SDK 零成本迁移：仅改 base_url 与 api_key，建议携带 HTTP-Referer 与 X-Title 头（OpenRouter 用于排行榜统计）。

6. 06

   生产部署 Fallback 链：配置 models 数组 + route: "fallback"，查询可用模型列表 GET /api/v1/models。

cURL 直接请求

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（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"])

Python（OpenAI SDK 零成本迁移——重点）

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

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

流式输出（Streaming）

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

查询可用模型列表（实用小技巧）

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

双语 SEO 实战：为什么英文页面流量低 + 可执行优化清单

若你用 OpenRouter 搭建 Agent 的同时维护自建双语博客，英文页面访问量低通常不是单一原因。以下诊断清单按优先级排列（性价比从高到低）：

P0：抓取与索引层（最常被忽视）

• CDN/WAF 拦截 Googlebot：国内 CDN + WAF 可能把海外 IP 判定为攻击流量，用 Google Search Console「网址检查」实测抓取效果。
• 缺少 hreflang 标注：Google 可能只收录中文版，英文版被当成重复内容。推荐子目录结构 /zh/ 与 /en/，互相声明 hreflang="zh-Hans" 与 hreflang="en"，并设 x-default。
• robots.txt / noindex 误配置：检查是否把 /en/ 路径 disallow 了。
• sitemap 缺英文条目：中英文各自独立列出，带 <xhtml:link> alternate 标注。
• CSR 空壳 HTML：纯前端渲染页面爬虫可能拿到空壳，须 SSR/SSG。

P1：内容层——英文必须本地化重写，不能机翻

中文标题「OpenRouter 优势」直译成 "OpenRouter Advantages" 无法匹配英文搜索习惯；英文用户更常搜 "OpenRouter vs OpenAI API" 或 "is OpenRouter worth it"。2026 年 Google AI Mode 会把一次搜索拆解成多个子问题（query fan-out），内容须覆盖「是什么、怎么用、多少钱、和谁比、安全吗、局限是什么」全部子意图。

结构化数据（Schema）建议

至少植入 BlogPosting/TechArticle + FAQPage JSON-LD。FAQ 问句用真实口语表达（英文："Is OpenRouter free?" 而非 "Free usage of OpenRouter"）。中文版 FAQ 用中文长尾词原句。

发布与分发渠道

可执行行动 Checklist + 效果追踪

• P0 本周：GSC 检查英文页面抓取索引 → 排查 CDN/WAF → 补全 hreflang/canonical/sitemap
• P1 写作：中英文分别独立成稿（共享代码示例，文字本地化重写）→ 嵌入关键词 → 加 Article + FAQPage Schema
• P2 分发：中文发掘金/知乎/V2EX；英文发 dev.to；两语言 sitemap 提交 GSC 与百度
• 追踪指标：GSC 按 /en/ 与 /zh/ 分别看 Impressions/CTR——展现量为 0 是收录问题，展现高 CTR 低是标题/描述问题；站内统计分语言看自然搜索流量与跳出率

可引用硬核数据（EEAT）

• 模型规模：70+ 供应商、400+ 模型，统一 Endpoint 一个 Key 调用
• 网关延迟：额外约 10–80ms 跳数（对比直连官方 API）
• 充值手续费：5.5%（最低 $0.80）；BYOK 每月前 100 万次请求免服务费
• 免费档额度：未充值 50 次/天 → 充值 ≥$10 后 1000 次/天、20 次/分钟

OpenRouter 适合快速验证多模型 Agent 原型，但若你的 Agent 需要7×24 常驻运行、稳定 SSH 长会话与 iOS/macOS 原生构建环境，在 Linux VPS 上跑 CLI Agent 往往面临 Metal 不可用、Xcode 缺失与 Keychain 隔离等硬限制。对于更稳定、更适合 iOS CI/CD 与 AI Agent 自动化的生产环境，NodeMini 的 Mac Mini 云端租赁通常是更优解——独占 Apple Silicon 算力、秒级拨备，像租 VPS 一样按需使用远程 Mac 节点。详见 租赁价格说明。