OpenRouter 支持哪些模型？

覆盖 70+ 供应商、400+ 模型，命名格式为供应商/模型名，如 openai/gpt-4o、anthropic/claude-3.5-sonnet。可通过 GET /api/v1/models 查询完整列表。

OpenRouter 会在 token 单价上加价吗？

不会。OpenRouter 官方 FAQ 明确无 token markup，仅在充值购买 Credits 时收取 5.5% 手续费。BYOK 模式下每月前 100 万次请求免费。

OpenRouter 和 Claude 直连哪个好？

多模型对比、中小体量、需要 Fallback 容灾时 OpenRouter 更省心；单一模型超大体量、需要 Anthropic Prompt Caching 或极低延迟时直连官方 API 更优。

OpenRouter 安全吗？数据会泄露吗？

请求会路由至第三方供应商机房。有数据合规或数据驻留要求时，不应使用 OpenRouter 中间层，应直连官方 API 或自托管开源模型。

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

Q: OpenRouter 收费吗？

付费模型按供应商原价透传 token 计费，充值 Credits 时收取 5.5% 手续费（最低 $0.80）。另有 25+ 免费模型，未充值约 50 次/天，充值 ≥$10 后提升至 1000 次/天。

Q: OpenRouter 国内能用吗？

OpenRouter 为海外服务，国内访问取决于网络环境。建议在生产环境通过稳定出口或 Mac 云节点发起 API 请求，避免本地网络波动导致 Agent 断链。

Q: OpenRouter 支持哪些模型？

覆盖 70+ 供应商、400+ 模型，命名格式为 供应商/模型名，如 openai/gpt-4o、anthropic/claude-3.5-sonnet。可通过 GET /api/v1/models 查询完整列表。

如果你要为 Cursor、OpenClaw 或自研 Agent 同时接入 GPT、Claude、Gemini 却不想维护五套 Key 和 SDK，本文以 OpenRouter 统一 LLM 网关为核心，给出定义与路由原理、vs 直连 API 对比表、5 大优势与「什么时候不该用」、五步 Runbook、curl/Python/Node 全套代码、Fallback 容灾、定价与 BYOK 说明，以及自建博客中英双语 SEO 诊断策略与 FAQ。

1. 三个接入痛点：多厂商 Key 地狱

账号与 Key 碎片化。 OpenAI、Anthropic、Google、Meta、DeepSeek 各需独立注册、账单与 SDK 适配，换模型等于重写适配层。
限流与宕机无内置容错。 单一供应商 429/500 时，业务侧需自行写 circuit breaker、重试与模型降级逻辑。
账单对账成本高。 五个后台分别看 Token 消耗、延迟与费用，Agent 路由策略难以统一优化。

2. OpenRouter 是什么——统一 LLM 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

内部路由机制（技术亮点）

决策层	决定什么	控制字段
模型选择（Model Routing）	由哪个模型回答请求	`model` 字段，或 `openrouter/auto` 自动选模型
供应商选择（Provider Routing）	同一模型由哪家机房处理	`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 个核心优势

一个 Key 打通所有模型，迁移成本几乎为零。 换模型 = 改 model 字符串，请求体、流式逻辑完全不变。
跨供应商自动故障转移（Failover）。 限流/宕机时网关层内置重试 + 切换，无需业务侧写 circuit breaker。
统一账单和用量分析。 一个 Dashboard 看所有模型消耗、成本、TTFT、吞吐量。
定价对用户友好——无 token 加价。 只在充值环节收 5.5%；BYOK 模式每月前 100 万次请求 0 手续费。
场景明确。 适合快速原型、A/B 测试多模型、中小体量（月消费几千美元内）、多模型 Fallback 提升可用性。

5. 什么时候不该用 OpenRouter（建立信任的平衡视角）

单一模型、超大体量（月消费数万美元以上）——5.5% 充值手续费成本值得自建直连。
需要供应商专属能力——Anthropic Prompt Caching、OpenAI Batch/Assistants API、Google Vertex AI 工具链。
对延迟极度敏感——网关额外 10–80ms 跳数不可接受。
数据合规 / 数据驻留——不允许流量经过美国第三方中间层。

6. 实战教程——五步接入 OpenRouter API

步骤 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 代码只需改两行：

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 流式输出（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);
}

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 定价机制

无 token markup——按供应商原价透传。
充值 Credits 收 5.5% 手续费（最低 $0.80），加密货币另收 5%。
BYOK（自带供应商 Key）：每月前 100 万次请求免费，超出后对等值部分收 5% 服务费。

9. 可引用技术要点

70+ 供应商、400+ 模型——一个 Endpoint 覆盖 GPT-4o、Claude 3.5、Gemini 2.5、DeepSeek、Llama 等。
网关额外延迟约 10–80ms——对比直连需在 SLA 预算内评估。
25+ 免费模型——未充值 50 次/天，充值 ≥$10 后 1000 次/天。
充值手续费 5.5%（最低 $0.80）——月消费数万美元以上值得评估直连 ROI。
BYOK 每月 100 万次免费——中大体量用户可显著降低中间层成本。

10. 双语 SEO 策略与英文页面流量诊断

若你在 VPSMAC 这类自建双语博客发布 OpenRouter 教程，中英文页面流量差异通常来自以下叠加因素——建议按优先级自查：

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

CDN/WAF 拦截 Googlebot——用 Google Search Console「网址检查」实测抓取，比浏览器打开更可靠。
robots.txt / noindex 误配置——确认未 disallow /en/ 路径。
sitemap 未单独列出各语言页面——中英文应各自独立 <url> 条目。
CSR 空壳——纯前端渲染页面爬虫可能拿到空 HTML，导致长期不收录。

10.2 内容层

英文勿直译中文——英文用户更常搜 "OpenRouter vs OpenAI API"、"is OpenRouter worth it"，而非 "OpenRouter Advantages"。
首段 150 字内给出明确定义——利于百度摘要与 Google AI Overview 抓取。
FAQ 承接长尾问题词——如「OpenRouter 收费吗」「OpenRouter 国内能用吗」「OpenRouter Python 怎么调用」。

10.3 中文关键词矩阵（标题/H2/FAQ 覆盖）

核心词：OpenRouter、OpenRouter API、OpenRouter 教程。中腰部：OpenRouter 怎么用、和 OpenAI 的区别、免费模型、收费吗。长尾：API Key 怎么获取、支持哪些模型、和 Claude 直连哪个好、安全吗。

10.4 英文关键词矩阵（本地化重写，非直译）

核心：OpenRouter API, OpenRouter tutorial。对比类高转化：OpenRouter vs OpenAI API, is OpenRouter worth it。How-to：OpenRouter Python example, OpenRouter fallback routing, OpenRouter streaming response。

10.5 发布与分发渠道

渠道	语言	用途
掘金 / V2EX / 知乎 / CSDN	中文	教程分发，快速获取国内技术受众
dev.to	英文	技术教程受众重合，可带 canonical 回链
Hacker News / Reddit	英文	精准垂直受众，获取初始外链
百度搜索资源平台 / GSC	中英	提交 sitemap，分路径看 Impressions

10.6 效果追踪指标

GSC 按 /en/ 与 /zh/ 分别看 Impressions——展现量为 0 是收录问题，展现高 CTR 低是标题/描述问题。每月无痕搜索 3–5 个核心词确认排名。

11. 常见问题 FAQ

OpenRouter 收费吗？ 付费模型按 token 原价计费；充值收 5.5%。25+ 免费模型有日限额。

OpenRouter 国内能用吗？ 取决于网络出口稳定性；生产 Agent 建议 Mac 云节点发起请求。

支持哪些模型？ 400+ 模型，格式 供应商/模型名，用 /api/v1/models 查询。

OpenRouter 安全吗？ 流量经第三方路由；有合规要求请直连或自托管。

和 OpenAI SDK 兼容吗？ 完全兼容，改 base_url 和 api_key 即可。

英文页面为什么没流量？ 先查 GSC 索引，再查是否机翻、关键词是否对齐英文搜索习惯。

12. 结论与选型建议

在笔记本或 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 跟着本地机器一起休眠。