国内开发者手里最常见的场景:想对比 Claude、GPT、Gemini、DeepSeek,就得注册四五个平台、办四五个 Key、绑四五种卡,充个值还得纠结汇率。而海外圈子里早就有个“中间层”把这事儿统一了——OpenRouter(openrouter.ai)。它不是一个模型,而是一个模型路由器:一个 API Key、一套 OpenAI 兼容接口,能调到平台上聚合的数百个模型(具体数量以官网 Models 页为准,官方口径是“数百款”)。
但国内教程基本只讲到“注册、充值、换个 base_url 就完事”,这等于只用了它 10% 的功能。这篇文章挖的就是剩下 90%:模型名后缀系统、自动路由、供应商级路由规则、BYOK、免费额度规则这些“隐藏层”。知道这些的人,同样的预算能多跑几倍的实验。
说明:以下功能与价格均来自 OpenRouter 官方文档体系(openrouter.ai/docs),价格可能随时调整,动手前请以文档页实时数字为准。
OpenRouter 的模型 ID 支持“后缀”,这是它最容易被忽略的设计。同一个模型,加不同后缀行为完全不同:
:free —— 调用该模型的免费变体(如 deepseek/deepseek-r1:free)。代价是限流:官方文档写明每分钟约 20 次请求,且每日免费额度和你账户充值的钱挂钩(规则见技巧六)。:nitro —— 强制路由到吞吐最快、响应最短的供应商。跑批量数据处理、追求单位时间产出时用它,价格可能略高。:floor —— 反过来,优先路由到该模型定价最低的供应商。跑离线批处理、不赶时间的任务用它省钱。:online —— 给任何模型临时挂上联网检索能力(见技巧五)。:thinking —— 让支持扩展思考的模型(如 Claude 系列)以 thinking 模式输出。国内用法对比:国内 API 中转站大多只做“转发”,没有这套后缀语义。OpenRouter 把“路由策略”编码进了模型名本身,你的代码里不用改任何参数,换个字符串就切换了策略——这是认知差最大的地方。
:free 免费额度的隐藏规则——充 10 美元解锁 1000 次很多人白嫖几天发现每天只能调几十次就放弃了,其实规则写在文档里:
:free 模型每天约 50 次请求;:free 请求。也就是说,一次性充 10 美元(这钱本身还能用于付费模型),免费额度直接翻 20 倍。对做毕设、写脚本、做 Demo 验证的人来说,1000 次/天的免费额度加上 DeepSeek、Qwen 等免费变体,基本够一个轻量项目跑很久。
两个官方功能国内几乎没人讲:
1. Auto Router(模型 ID:openrouter/auto)。你不指定模型,它根据你的 prompt 自动从高分模型池里挑一个。官方称背后是微调的分类器在打分选路。适合两类人:一是懒得追榜单的“懒人用例”——写周报、翻译、总结,用 auto 就行;二是做产品原型期不想锁死模型的团队。
2. Presets(预设)。在 openrouter.ai/presets 里你可以把“模型 + 系统提示词 + 温度等参数”打包成一个预设,得到一个 @preset/你的预设名 的模型 ID,直接填进任何兼容 OpenAI 的客户端。妙用是把提示词工程从代码里剥离:提示词改版不用发版,改预设即可;还能把预设分享给同事,团队统一“人设”不靠口头传。
这是 OpenRouter 区别于普通中转站的核心护城河。同一个模型名(比如 deepseek/deepseek-chat),背后可能有官方 API、也可能有第三方推理商(如 Together、Fireworks 等)在供货,价格、速度、量化精度都不同。请求体里的 provider 参数让你精细控制:
sort: "throughput" 或 "price" —— 按最快或最便宜排序选供应商;quantizations —— 指定接受 fp16、int8、int4 等量化精度,做严肃任务可以排除低精度供应商,防止“同一个模型,别人家跑的是缩水版”;ignore —— 拉黑某些你不信任的供应商;require_parameters: true —— 只选支持你所需参数(如结构化输出)的供应商;allow_fallbacks: false —— 严格模式:选不出就报错,不允许偷偷降级。配合请求体里的 models 数组(按顺序写主模型和备胎模型),可以搭出“主用 A 模型,挂了自动切 B,B 也挂切 C”的容灾链。做生产服务的人应该都懂这条有多值钱。
请求里加一个 plugins 参数(或直接用 :online 后缀),OpenRouter 会自动用 Exa 的搜索接口给模型喂网页结果,再由模型总结。文档定价为 每 1000 条结果 4 美元,单条约 0.4 美分,可设 max_results 控制。自己搭 RAG 之前,先用它验证“加了搜索到底能提升多少”,是个低成本试错入口。
flowchart TD
A[你的应用<br/>OpenAI 兼容请求] --> B{模型 ID 是什么?}
B -->|openrouter/auto| C[Auto Router 分类器<br/>自动选模]
B -->|带 :free / :nitro / :floor 后缀| D[后缀改写路由策略]
B -->|普通模型 ID| E[Provider Routing 引擎]
C --> E
D --> E
E --> F{provider 参数}
F -->|sort: price| G[最便宜供应商]
F -->|sort: throughput| H[最快供应商]
F -->|quantizations 过滤| I[指定精度的供应商]
E --> J{请求是否失败?}
J -->|是| K[models 数组备胎模型<br/>自动降级切换]
K --> L[返回结果]
J -->|否| L
L --> M[统一账单 + 用量分析面板]
如果手上已经有 OpenAI、Anthropic、Google、Azure、Bedrock 的 Key,可以在 OpenRouter 的 Integrations 里接入(BYOK,Bring Your Own Key),之后这些模型的调用依然走 OpenRouter 的统一接口、统一账单和容灾逻辑。代价是官方文档写明的 5% 使用费(按供应商账单额计)。听起来亏?但它换来的是:一个面板看所有模型消耗、自动容灾、密钥泄露时可以只换 OpenRouter 这一层。对管着好几朵云 Key 的团队,这 5% 买的是可观测性。
OpenRouter 支持创建带消费上限和有效期的临时 API Key(Provisional API Keys)。典型用法:给公司每个 Agent/每条 CI 流水线发一把限额子钥匙,某条流水线被拖库打爆,损失上限就是那把钥匙的额度,主 Key 永不下发。国内用各家原生 API 的人大多没有这套子钥匙体系,只能一个 Key 全局共享。
两个情报价值:
HTTP-Referer 和 X-Title,你的应用也能上榜。反过来用:这是观察“海外 AI 应用都在用什么模型、什么赛道在起量”的免费情报站——比看融资新闻快一拍。| 维度 | 你以为的 OpenRouter | 实际上的 OpenRouter |
|---|---|---|
| 定位 | 一个 API 中转站 | 带“策略路由”的模型基础设施层 |
| 模型名 | 只是 ID | ID 后缀 = 路由开关(:free/:nitro/:floor/:online) |
| 免费额度 | 每天 50 次 | 充值满 $10 解锁每天约 1000 次 |
| 选模型 | 自己看榜单 | openrouter/auto 自动选 + Presets 打包分享 |
| 可靠性 | 靠单一供应商 | provider 参数 + models 备胎链自动容灾 |
| 密钥管理 | 一个 Key 全用 | Provisional 子钥匙限额隔离,BYOK 统一纳管 |
:free 额度,本 metal 花得值);base_url 换成 https://openrouter.ai/api/v1,模型名换成你要测的免费变体(如 deepseek/deepseek-chat-v3:free,具体 ID 以 Models 页为准);models 数组和 provider.sort 的请求,跑一次“最便宜优先 + 失败降级”实验;@preset/名字。本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生(微信ID: gprshome201101)维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。
