OpenRouter 保姆级教程：从 0 到 1 接入 GPT / Claude / Gemini 全模型（2026 最新完整指南）

OpenRouter 是统一 LLM API 聚合层：用一个 API Key + 一个 OpenAI 兼容 Endpoint 调用来自多家供应商的能力，而不必分别对接 OpenAI、Anthropic、Google、Meta、DeepSeek 等官方 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

OpenRouter 内部做两层独立路由决策——这是理解其可用性的关键：

• 自动故障转移：主力供应商限流或报错时，OpenRouter 可切换下一可用供应商或备选模型（models 数组），业务侧不必自写 circuit breaker。
• 免费模型：25+ 免费模型；未充值约 50 次/天，账户充值 ≥$10 后约 1000 次/天（20 次/分钟）。
• 定价机制：token 单价不加价，按供应商原价透传；充值 Credits 收 5.5% 手续费（最低 $0.80）；加密货币另收 5%。BYOK 模式每月前 100 万次请求免费，超出对等值部分收 5% 服务费。

OpenRouter 并非取代官方 SDK，而是在「多模型场景」与「官方直连」之间提供折中——下文对比表会说明何时该用、何时不该用。

• 痛点一：多厂商账号碎片化。直连需分别注册 OpenAI、Anthropic、Google 等，Key 轮换、账单对账、权限审计成本高。
• 痛点二：换模型等于换集成层。不同厂商消息格式、流式协议、错误码不一致，Agent 框架难以「改一个字符串就换模型」。
• 痛点三：单点限流拖垮生产。单一供应商 429/5xx 时，业务代码若未内置重试与切换，用户直接看到失败。
• 痛点四：成本透明度差。分散在五个后台的用量，很难做统一的 TTFT、吞吐与 spend 分析。

选型结论预览：多模型 A/B、中小体量、需要 Fallback 时优先 OpenRouter；单一旗舰超大体量、极致延迟或严格数据驻留时直连更优——详见下一节「什么时候不该用」。

• 优势一：一个 Key 打通所有模型。换模型 = 改 model 字符串，无需重写业务逻辑或厂商适配层。
• 优势二：跨供应商自动 Failover。可配置 models: ["anthropic/claude-3.5-sonnet", "openai/gpt-4o", "google/gemini-2.5-pro"]，主力挂了依次尝试。
• 优势三：统一账单与用量分析。一个 Dashboard 看全模型 token、成本、TTFT 与吞吐，不用登录五个后台对账。
• 优势四：无 token 加价。FAQ 明确不在单价上加价，仅充值环节 5.5%；中大体量可用 BYOK 降本。
• 优势五：场景边界清晰。适合快速原型、多模型对比、月消费几千美元以内、同一 Prompt 框架跑遍市面模型。

更适合直连官方 API 的情况（建立 E-E-A-T 的平衡视角）：

• 单一模型、月消费数万美元以上——5.5% 手续费已值得自建直连
• 需要 Anthropic Prompt Caching、OpenAI Batch/Assistants、Google Vertex 专属工具链
• 对延迟极度敏感（网关 +10–80ms 不可接受）
• 数据合规 / 数据驻留不允许流量经美国第三方中间层

写「什么时候不该用」不是劝退，而是覆盖 OpenRouter vs 直连 API 等高转化长尾词，并提升 AI 摘要引用的可信度。

1. 注册账户：访问 openrouter.ai，用 GitHub 或邮箱创建账户。
2. 创建 API Key：在 Keys 页面生成 Key，生产环境按项目拆分 Key 并设置 spend limit。
3. 配置环境变量：export OPENROUTER_API_KEY="sk-or-..."，勿把 Key 提交进 Git。
4. 发起第一次请求：用下方 curl 或 OpenAI SDK 验证 200 响应与模型 ID 正确。
5. 查询可用模型：curl https://openrouter.ai/api/v1/models -H "Authorization: Bearer $OPENROUTER_API_KEY"，确认目标模型 slug 存在。
6. 生产部署：配置 Fallback 链、流式输出、HTTP-Referer/X-Title 头（OpenRouter 建议携带用于排行榜统计），并将 Key 注入 7×24 Agent 宿主而非个人笔记本。

以下示例覆盖「how to」与「code example」两类搜索意图；代码可原样运行，仅需替换 Key。

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
r = requests.post(
  "https://openrouter.ai/api/v1/chat/completions",
  headers={"Authorization": f"Bearer {os.environ['OPENROUTER_API_KEY']}"},
  json={"model": "google/gemini-2.5-pro",
        "messages": [{"role": "user", "content": "写一个快速排序 Python 实现"}]}
)
print(r.json()["choices"][0]["message"]["content"])

Python（OpenAI SDK 零成本迁移——高频搜索场景）

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://jexcloud.com", "X-Title": "JEXCLOUD Demo"},
)

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" }],
});

流式输出（Streaming）

const stream = await openai.chat.completions.create({
  model: "anthropic/claude-3.5-sonnet", stream: true,
  messages: [{ role: "user", content: "写一首关于秋天的短诗" }],
});
for await (const chunk of stream) {
  const c = chunk.choices[0]?.delta?.content;
  if (c) process.stdout.write(c);
}

多模型 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"}]
}

• 供应商规模：70+ 家供应商、400+ 模型（官方文档口径，路由前请用 /models 复核）。
• 免费档：25+ 免费模型；未充值约 50 次/天，充值 ≥$10 后约 1000 次/天、20 次/分钟。
• 手续费：充值 Credits 5.5%（最低 $0.80）；加密货币 +5%；BYOK 每月前 100 万次免费。
• 延迟代价：网关层通常增加约 10–80ms，对 TTFT 敏感场景需实测。
• 成本控制：默认路由指向 Flash/低价模型；高风险步骤再升 Opus；启用项目级 spend limit 与周报导出。

OpenRouter 不在 token 单价上加价——这是与多数聚合服务的关键差异；真正要算的是充值手续费 + 网关延迟 + 合规边界，而非「模型标价 × 神秘系数」。

OpenRouter 收费吗？ 有免费模型与付费模型；付费按供应商 token 原价，充值收 5.5%。

OpenRouter 国内能用吗？ 通常可 API 调用，但需自行评估网络与数据出境合规。

OpenRouter 支持哪些模型？ 400+ 模型，格式 vendor/model；用 /api/v1/models 拉全量列表。

OpenRouter 和 Claude 直连哪个好？ 多模型与容灾选 OpenRouter；官方专属能力与超大体量选直连。

OpenRouter 一个月多少钱？ 取决于模型与用量——Flash 档 Agent 可能几十美元，全 Opus 可能数千；Dashboard 可预估。

OpenRouter 安全吗？ 流量经网关转发；敏感数据请评估 BYOK、直连或私有部署。

OpenRouter Python 怎么调用？ 见第五节 requests 或 OpenAI SDK 示例。

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

• CDN/WAF 拦截 Googlebot——用 Google Search Console「网址检查」实测，比浏览器打开更可靠
• 中英文缺少正确 hreflang，Google 可能只收录中文版为规范版本
• robots.txt / noindex 误伤 /en/ 路径
• sitemap.xml 未分语言列出或未带 alternate 标注
• 纯 CSR 空壳 HTML，爬虫拿不到正文

内容层：

• 英文为中文直译，关键词不匹配 OpenRouter vs OpenAI API、is OpenRouter worth it 等原生表达
• 缺少英文独立关键词研究；E-E-A-T 不足（无作者、无实测数据）

权重与外链层：

• 中文在掘金/知乎/V2EX 有分发，英文未在 Reddit / Hacker News / dev.to 曝光，英文页几乎零外链
• 新域名需时间 + 外链 + 持续更新才能提高抓取频率

建议修复顺序（性价比从高到低）：

1. GSC 检查英文 URL 是否被抓取、是否已索引
2. 排查 CDN/WAF 对 Googlebot 的拦截
3. 补齐 hreflang、canonical、分语言 sitemap
4. 重写 3–5 篇重点英文文（非翻译），对齐英文关键词
5. 在 dev.to / Reddit / Hacker News 做首批英文分发

中文核心词：OpenRouter、OpenRouter API、OpenRouter 教程；中腰部：OpenRouter 怎么用、和 OpenAI 的区别、免费模型、收费吗；长尾 FAQ：API Key 怎么获取、国内能用吗、Python 怎么调用。

中文标题信号词：完整指南、保姆级教程、从 0 到 1、2026 最新——核心词须在标题、首段、H2 原样出现（百度字面匹配 + AI 搜索语义集群双下注）。

英文核心词：OpenRouter API、tutorial、integration；对比类：OpenRouter vs OpenAI API、is OpenRouter worth it；how-to：OpenRouter Python example、fallback routing、streaming response。

英文标题信号词：The Complete Guide、Step-by-Step、For Beginners、Honest Review——勿堆砌 Ultimate+Complete+Beginner（英文读者对标题党容忍度更低）。

本地化原则：中英文不要简单互译——共享代码示例，但标题、首段、H2、FAQ 问句按各自搜索意图重写；英文首段用 TL;DR 定义块；加入「When NOT to use it」平衡视角；Meta Description 中文 150–160 字、英文 150–160 字符含 step-by-step / honest 等信任词。

推荐 URL 结构（子目录共享域名权重）：

https://jexcloud.com/zh/blog/2026-0724-openrouter-api-tutorial-gpt-claude-gemini-guide.html
https://jexcloud.com/en/blog/2026-0724-openrouter-api-tutorial-gpt-claude-gemini-guide.html

hreflang 示例（各语言页 head 互指 + x-default）：

<link rel="alternate" hreflang="zh-Hans" href="https://jexcloud.com/zh/blog/..." />
<link rel="alternate" hreflang="en" href="https://jexcloud.com/en/blog/..." />
<link rel="alternate" hreflang="x-default" href="https://jexcloud.com/en/blog/..." />

每语言 canonical 指向自身；sitemap 中各语言独立 <url> 并声明 xhtml:link alternate。

Schema：本文已含 BlogPosting + FAQPage JSON-LD；中文版 FAQ 问句用中文长尾原句。

分发渠道：中文 → 掘金、知乎、V2EX、CSDN、百度搜索资源平台；英文 → dev.to（带 canonical 回链）、Hacker News、Reddit（r/LocalLLaMA 等）、Indie Hackers；X 可发双语线程摘要。

P0（本周止血）：GSC 查英文抓取/索引 → 排查 CDN/WAF → 补 hreflang/canonical/sitemap。

P1（写作发布）：中英文分别成稿（英文本地化重写）→ 嵌入关键词 → Article + FAQPage Schema。

P2（分发追踪）：掘金/知乎 + dev.to/Reddit → 双语言 sitemap 提交 GSC 与百度 → 分路径看 Impressions/CTR/排名。

效果追踪：GSC 按 /en/ 与 /zh/ 看展现量（0 = 收录问题，高展现低 CTR = 标题问题）；站内 Umami/GA4 分语言看自然搜索与跳出率；每月无痕搜索 3–5 个核心词抽查排名。

跑 OpenRouter Agent 时，个人 Mac 合盖即断流；超卖 VPS 常非官方 macOS，SSH 抖动会打断多步工具循环；团队共用机器则 Key 轮换与 CLI 版本难以统一——这些与「API 怎么接」无关、却决定生产可用性。

对需要 7×24 跑 Cursor Agent、OpenClaw Gateway 与 OpenRouter 路由 的团队，JEXCLOUD 多区域裸金属 Mac 是更稳的宿主：独占 Apple Silicon、真 macOS、120 秒交付、按月弹性；模型账单走 OpenRouter，算力走裸金属，分层清晰。规格见 定价页，接入见 帮助中心。