OpenRouter 支持哪些模型？

覆盖 70+ 供应商、400+ 模型，包括 GPT-4o、Claude 3.5 Sonnet、Gemini 2.5 Pro、DeepSeek、Llama、Qwen 等。可通过 GET /api/v1/models 查询完整列表与实时定价。

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

请求经 OpenRouter 网关路由至底层供应商；对数据合规要求严格的场景（如数据驻留）应评估是否直连官方 API。BYOK 模式可自带供应商 Key，减少中间层暴露。

OpenRouter 和 Claude 直连哪个好？

多模型对比、快速原型、中小体量应用更适合 OpenRouter；单一模型超大体量、需要 Anthropic Prompt Caching 等专属能力、或对延迟极度敏感时应考虑直连官方 API。

OpenRouter 会在 token 单价上加价吗？

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

OpenRouter API 保姆级教程 2026

Q: OpenRouter 收费吗？

OpenRouter 提供 25+ 免费模型（带日请求限制）；付费模型按供应商原价透传 token 单价，充值 Credits 时收取 5.5% 手续费（最低 $0.80）。账户充值 ≥$10 后免费模型限额提升至约 1000 次/天。

Q: OpenRouter 国内能用吗？

OpenRouter 为海外服务，国内访问取决于网络环境。建议在远程 Mac 或稳定出口环境下测试 API 连通性与延迟，OpenClaw、Claude Code 等 CLI Agent 可在 VNC 远程 Mac 上图形化验收。

01

OpenRouter 能做什么——统一调用 GPT / Claude / Gemini / DeepSeek

OpenRouter 不是要取代 OpenAI/Anthropic 官方 SDK，而是在「多模型场景」与「官方直连」之间提供折中：已有 OpenAI SDK 代码基本不用改，只需换 base_url 和 api_key；换模型 = 改一个 model 字符串，例如 openai/gpt-4o、anthropic/claude-3.5-sonnet、google/gemini-2.5-pro、deepseek/deepseek-chat。

内部路由分两层决策，写文章与排障时值得记清：

决策层	决定什么	控制字段
模型选择（Model Routing）	由哪个模型回答这次请求	model，或 openrouter/auto 自动选模型
供应商选择（Provider Routing）	同一模型由哪家供应商机房处理	provider 对象，默认按价格倒平方加权挑「便宜且稳定」的供应商

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

02

痛点拆解：多厂商 API 的隐性成本

在决定用 OpenRouter 还是直连之前，先对齐「不用网关」时常见五条痛点：

01
账号与 Key 碎片化：OpenAI、Anthropic、Google、Meta、DeepSeek 各一套注册、账单、SDK 版本，Agent 框架要维护多套适配层。
02
故障转移要自己写：单一厂商限流/宕机时，重试 + 切换供应商 + 切换模型的逻辑落在业务代码，运维成本高。
03
对账分散：五个后台对 token 消耗、延迟（TTFT）、吞吐量，难以做统一成本分析。
04
聚合层加价：部分同类服务在 token 单价上加价；OpenRouter 官方 FAQ 明确「无 token markup」，只在充值环节收 5.5%。
05
网关额外跳数：OpenRouter 会增加约 10–80ms 延迟；对延迟极度敏感或数据合规/驻留要求严格的场景，直连更合适。

03

OpenRouter vs 直连 OpenAI / Anthropic / Google API

维度	OpenRouter	直连官方 API
接入成本	改 base_url + 一个 Key	每厂商独立 Key、SDK、账单
多模型切换	改 model 字符串即可	重写适配层或换 SDK
故障转移	网关内置 Fallback	业务侧自实现
Token 定价	供应商原价透传 + 充值 5.5% 费	官方标价；大体量可谈 enterprise
专属能力	部分厂商专属 API（Batch、Prompt Caching 等）可能不可用	完整官方功能栈
延迟	多约 10–80ms 网关跳数	通常更低
数据合规	流量经美国第三方网关	可选 Vertex、区域 endpoint 等

五个核心优势

一个 Key 打通所有模型，迁移成本几乎为零。
跨供应商自动 Failover，可显式配置 models fallback 链。
统一 Dashboard 看消耗、成本、延迟与吞吐量。
无 token 加价，中大体量可用 BYOK 进一步降本。
场景明确：原型验证、A/B 测模型、多模型 Agent、月消费几千美元以内应用。

⚠

什么时候不该用 OpenRouter（建立信任的关键段落）：单一模型、月消费数万美元以上时 5.5% 充值费值得自建直连；需要 Anthropic Prompt Caching、OpenAI Batch/Assistants、Vertex 专属工具链；对延迟极度敏感；或有数据驻留要求不允许流量经美国中间层。这类「劝退」内容利于 E-E-A-T，也承接「OpenRouter vs 直连 API」长尾搜索。

04

实战：3 步接入 OpenRouter API

01
注册：访问 openrouter.ai 创建账户。
02
获取 Key：在 Keys 页面创建 API Key，存入环境变量 OPENROUTER_API_KEY，勿提交到 Git。
03
充值（可选）：免费模型可先试；付费模型在 Credits 页充值，注意 5.5% 手续费。
04
查模型列表：curl https://openrouter.ai/api/v1/models -H "Authorization: Bearer $OPENROUTER_API_KEY"
05
发起第一次请求：见下一节代码；建议携带 HTTP-Referer 与 X-Title 便于 OpenRouter 排行榜统计。

05

代码示例：curl / Python / Node.js / OpenAI SDK

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

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)

javascript

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

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

06

进阶：Fallback、免费模型与成本控制

用 models 数组 + route: "fallback" 配置主力→备选链，Claude 限流时自动试 GPT/Gemini。
免费档适合开发调试；生产环境关注 Dashboard 中各模型 prompt/completion 单价。
月请求量大时评估 BYOK：自带 OpenAI/Anthropic Key，前 100 万次/月免 OpenRouter 服务费。
OpenClaw 用户可结合多模型路由与成本优化做降级策略。

可引用数字（便于摘要抓取）：

70+ 供应商、400+ 模型；25+ 免费模型。
充值手续费 5.5%（最低 $0.80）；无 inference token markup。
网关额外延迟约 10–80ms；BYOK 每月前 100 万次请求免费。

07

自建博客：为什么英文页面流量低？诊断清单

若你在 VNCMac 或自建站同时发中英版本，英文展现为 0 往往是抓取/索引问题而非内容质量。按优先级自查：

层级	检查项
抓取与索引	CDN/WAF 是否拦截 Googlebot；hreflang 是否正确；robots.txt 是否误 disallow /en/；sitemap 是否分语言列出；是否 CSR 空壳 HTML
内容层	英文是否为「机翻」而非本地化重写；关键词是否对齐英文搜索习惯（如 "OpenRouter vs OpenAI API"）；E-E-A-T 是否不足
外链层	中文在掘金/知乎有分发，英文是否在 dev.to、Reddit、Hacker News 有初始外链

修复顺序（性价比从高到低）：① Google Search Console 网址检查；② 排查 CDN/WAF；③ 补齐 hreflang、canonical、sitemap；④ 重写 3–5 篇重点英文文（非直译）；⑤ dev.to / Reddit 首批分发。

08

中文 SEO 策略要点

核心词：OpenRouter、OpenRouter API、OpenRouter 教程须在标题、首段、H2 原样出现。中腰部词做小节标题：OpenRouter 怎么用、OpenRouter 和 OpenAI 的区别、OpenRouter 免费模型、OpenRouter 收费吗。FAQ 承接长尾：OpenRouter API Key 怎么获取、OpenRouter 国内能用吗、OpenRouter Python 怎么调用。

标题信号词组合：「保姆级教程 + 从 0 到 1 + 2026 最新」提升 CTR。Meta Description 控制在 70–110 字，含核心词 + 行动号召 + 信任词（真实踩坑/代码示例）。分发：掘金、知乎、V2EX、百度搜索资源平台提交 sitemap。

09

英文 SEO 与双语站点架构

英文核心词：OpenRouter API, OpenRouter tutorial, how to use OpenRouter；高转化对比词：OpenRouter vs OpenAI API, is OpenRouter worth it。英文标题勿堆砌形容词，用 1 个 Complete Guide / Step-by-Step + 技术元素（2026、Python & Node.js）。

不要逐句翻译中文稿——至少重写标题、首段 TL;DR、H2、FAQ 问句。推荐 URL 结构：

url

https://yourblog.com/zh/openrouter-api-guide/
https://yourblog.com/en/openrouter-api-guide/

hreflang 示例（各语言页 <head>）：

html

<link rel="alternate" hreflang="zh-Hans" href="https://yourblog.com/zh/openrouter-api-guide/" />
<link rel="alternate" hreflang="en" href="https://yourblog.com/en/openrouter-api-guide/" />
<link rel="alternate" hreflang="x-default" href="https://yourblog.com/en/openrouter-api-guide/" />
<link rel="canonical" href="https://yourblog.com/en/openrouter-api-guide/" />

结构化数据：至少 TechArticle/Article + FAQPage JSON-LD（本文 head 已嵌入示例）。英文 FAQ 问句用口语：Is OpenRouter free? 而非 Free usage of OpenRouter。

10

发布分发与可执行行动清单

优先级	行动
P0	GSC 检查英文抓取；排查 CDN/WAF；补 hreflang + canonical + sitemap
P1	中英分别撰写/本地化；嵌入 Article + FAQPage Schema
P2	中文→掘金/知乎/V2EX；英文→dev.to、视质量 HN/Reddit；双语言 sitemap 提交 GSC 与百度

效果追踪：GSC 按 /en/ 与 /zh/ 分别看 Impressions/CTR/排名——展现量为 0 = 收录问题，展现高 CTR 低 = 标题/描述问题。站内统计分语言看自然搜索、跳出率、阅读时长。

FAQ

常见问题

25+ 免费模型带日限；付费模型按供应商原价计费，充值时收 5.5% 手续费。充值 ≥$10 后免费模型限额约 1000 次/天。

取决于网络出口。建议在稳定环境下测试；在远程 Mac上跑 OpenClaw/CLI Agent 时，可用 VNC 图形会话验收 API 连通与日志。

不会。仅在充值 Credits 时收 5.5%；BYOK 每月前 100 万次请求免服务费。

多模型、原型、中小体量 → OpenRouter；超大体量、Prompt Caching、极致延迟或合规 → 直连。见第三节对比表。

只改 base_url="https://openrouter.ai/api/v1" 与 api_key，其余请求体、流式逻辑不变。见第五节 Python 示例。

结语

OpenRouter 把「多模型接入」从五套账号收成一把 Key + 两行配置，Fallback 与统一账单则把 Agent 运维从业务层挪到网关层。但若你同时在 Mac 上跑 OpenClaw、Claude Code 或 Kimi Code，本地或 SSH-only 环境常卡在OAuth 回调、系统权限弹窗与 Gateway 图形验收——纯终端很难对照浏览器 Network 与 macOS 隐私面板。

自购 Mac 还要承担睡眠策略、系统更新与硬件折旧；Windows 主力机则缺少原生 macOS Agent 生态。相较之下，租用 VNCMac 远程 Mac + VNC 图形会话可在与 Gateway 同机环境下完成多模型路由验收，把 OpenRouter 接进生产 Agent 的隐性排障成本压到可预期区间。

若你希望少押一台自有硬件、又要在 OpenClaw 控制台里对照 OpenRouter 模型切换与 Token 消耗，可直接通过 VNCMac 开通云端 Mac：下方主按钮进入购买页；需要对比套餐时先浏览首页。

OpenRouter 保姆级教程从 0 到 1 接入 GPT / Claude / Gemini