OpenRouter 是一个多模型 API 聚合层:一个 API key、一份余额,通过 OpenAI 兼容端点访问来自数十家供应商的数百个模型,并在它们之间做路由、比价和故障回退。
它解决的问题
同时评估几家模型时,真正费时间的不是写代码,而是重复走开通、密钥管理、结算和错误处理这四件事。OpenRouter 把这一层收敛成一个入口:换模型通常只改一个模型名字符串。
对已经上线的产品,它的价值在另一头——供应商出问题时自动回退,不用等对方状态页更新。
上手三步
- 注册账号,在后台创建 API key;想用付费模型就先充值。
- 把现有 OpenAI SDK 的 base URL 改成
https://openrouter.ai/api/v1,密钥换成 OpenRouter 的 key。 - 模型名按「供应商/模型」的格式填写,可以在模型列表里查到每个模型的准确 ID、上下文长度和各供应商的单价。
from openai import OpenAI
client = OpenAI(base_url="https://openrouter.ai/api/v1", api_key="你的 OpenRouter key")
reply = client.chat.completions.create(
model="供应商/模型名", # 从模型列表复制
messages=[{"role": "user", "content": "你好"}],
)计费口径
按官方 FAQ,模型单价按底层供应商原价透传、不加价,平台的收入来自充值环节:
- 充值手续费:银行卡(Stripe)支付收 5.5%,最低 0.8 美元;加密货币支付收 5%。
- 免费模型:没有充值时每天可请求 50 次;累计充值满 10 美元后提高到每天 1000 次。
- 自带密钥(BYOK):用你自己在各家供应商的 key 走 OpenRouter 路由,按量付费档每月前 2.5 万美元用量免费,超出部分按 OpenRouter 标准价的 5% 收费;企业版的免费额度是每月 20 万美元。
所以一笔 100 美元的充值,实际能用的额度要扣掉手续费;小额频繁充值时,最低 0.8 美元那一条会让费率更高,不如一次多充一些。
开发者能拧的旋钮
- 路由变体:按价格或性能动态选供应商。
- 单次请求价格上限:设定阈值,没有供应商满足就不发这次请求。
- 数据策略:限定只路由到信任的供应商。官方说明默认不记录提示词与回复;主动选择允许记录,可以换取 1% 的折扣。
什么时候不该用
如果你的产品只用一家模型、也没有回退需求,这层路由就是纯开销,直连更简单。另外要注意:供应商调价之后,请求照样路由过去,按新价格计费——预算敏感的场景建议配合价格上限使用。
对数据合规要求严格的企业,还要确认请求会经过 OpenRouter 再到供应商,多了一个数据处理方。
和同类怎么选
- 想自己掌控网关、数据不经第三方:用 LiteLLM 这类开源网关自建,参考本站的 LiteLLM 网关部署指南 和 自用 API 中转站搭建。
- 只是想在一个界面里和多家模型聊天、不写代码:Poe 更直接。
- 想在本地跑开源模型:Ollama。
国内使用
openrouter.ai 在国内需要自行解决网络访问条件,充值通常需要境外银行卡或加密货币。
