TheAI Academy

OpenRouter 完整教学：一组 API key 打通 364 个模型，储值、路由、省钱全攻略

作者 TheAI 学院 · Jul 31, 2026

OpenRouter 用一个端点聚合数百个 AI 模型且推论不加价。本文从注册储值、建立金钥、第一次 API 呼叫，到 auto-beta 自动选模、供应商路由与 BYOK 进阶玩法，含台湾开发者最容易踩的雷。

凌晨一点，一位台北的独立开发者盯着萤幕叹气：他的 side project 同时要接三家模型——写程式用 Claude、便宜的批次任务用 DeepSeek、偶尔想试试新出的开源模型。三组 API key、三种计费仪表板、三份 SDK 文件，光是管理金钥就快把热情磨光。后来他把整个专案改接 OpenRouter，程式码只改了一行 base_url，三家变一家。这篇就把这条路怎么走，一步一步讲清楚。

OpenRouter 是什么

OpenRouter 是一个「模型聚合闸道」：你只需要一组 API key、一个端点（openrouter.ai/api/v1），就能呼叫上面数百个模型。我在 2026 年 7 月底实际打了一次它的 models API，回传 364 个模型、来自 57 个模型作者——OpenAI 70 个、Qwen 48 个、Google 39 个、Anthropic 26 个，连 MiniMax、Moonshot 这些中国模型厂都在列。

最关键的一点：它的推论计价是「原价转售」，不在模型费率上加价，赚的是储值手续费（刷卡 5.5%、加密货币 5%）。所以你不用担心「透过它呼叫比较贵」，该担心的只有储值时那笔手续费。

能做什么

对开发者来说，它解决三件事：一是免去多家帐号管理，一组 key 走天下；二是自动容错，某家供应商挂了会自动切到备援；三是成本可视化，每个回应都直接附上这次花了多少 token、多少钱，不用事后对帐。

因为它的 API 完全相容 OpenAI 格式，你手上任何用 OpenAI SDK 写的程式，把 base_url 换成 OpenRouter 的端点就能用，Claude 或 ChatGPT 系列模型都直接呼叫得到。

怎么用：五步上手

  1. 注册与储值：到 openrouter.ai 注册，先储值。这里有个实用门槛——累积储值满 10 美元，免费模型的每日额度会从 50 次跳到 1,000 次，建议一开始就储 10 美元。
  2. 建立 API key：到 Keys 页面建一把金钥，可以帮每把 key 设「额度上限」，side project 超支自动断线，这功能我大推。
  3. 挑模型：模型代号是「作者/模型名」格式，例如 openai/gpt-5.1。想免费测试就找结尾带 :free 的模型，目前有 14 个。
  4. 发出第一个请求：对 openrouter.ai/api/v1/chat/completions 发 POST，带上 Bearer token 就行；用 Python 的话直接拿 OpenAI SDK、改 base_url 即可。
  5. 看用量：回应里自带 usage 物件，含 token 数与实际成本；网站仪表板也能按 key、按模型看花费。

进阶技巧

  • 自动选模：用 openrouter/auto-beta 让系统依任务类型帮你挑模型，还能用 cost_quality_tradeoff 参数在品质与成本间调整（0 最重品质、10 最省钱）。旧的 openrouter/auto 已弃用，别再照旧教学设了。
  • 供应商路由：在请求里加 provider 物件，可以指定供应商顺序、按价格或延迟排序；懒人版是在模型代号后面加 :nitro（冲速度）或 :floor（冲低价）。
  • 隐私控制：设 data_collection: "deny" 或 zdr: true，只路由到不保留资料的端点，处理敏感资料时很重要。
  • BYOK：自己手上有 OpenAI 或 Anthropic 的企业额度？可以把自家 key 挂上去，每月前 100 万次请求免手续费，之后收 5%。细节可以搭配我们的 BYOK 金钥管理指南 服用。

注意事项

储值手续费是唯一的「隐形成本」，5% 起跳、刷卡最低收 0.8 美元，小额频繁储值很吃亏，建议一次储足。另外，余额变负数时会全面回 402 错误——连免费模型都不能用，这点蛮多人踩雷。还有，同一个模型在不同供应商端点的量化精度可能不同，输出品质有落差，在意的话用 quantizations 参数锁定。如果你偏好自架的闸道方案，LiteLLM 和 Portkey 是另一条路，但维运成本要自己扛。

TheAI学院 总结与评语

评语：对台湾独立开发者和小团队来说，OpenRouter 是目前「多模型接入」摩擦最低的选择——一行 base_url 换来 364 个模型与自动容错，储值手续费就当付保护费。

我自己的建议：先储 10 美元解锁免费模型额度，用 :free 模型把流程跑通，再上正式模型。每把 key 都设额度上限，这个习惯迟早会救你一次。

常见问题

OpenRouter 会比直接用官方 API 贵吗？

推论费率是原价转售、不加价，成本差异只在储值手续费（刷卡 5.5%、最低 0.8 美元，加密货币 5%）。一次储多一点可以摊薄手续费。

OpenRouter 有免费模型吗？

有，模型代号结尾带 :free 的都免费，目前约 14 个。限制是每分钟 20 次请求；累积储值满 10 美元后，每日上限从 50 次提高到 1,000 次。

我原本用 OpenAI SDK 写的程式要改很多吗？

几乎不用改。OpenRouter 的 API 完全相容 OpenAI 格式，把 base_url 换成 https://openrouter.ai/api/v1、金钥换成 OpenRouter 的 key 就能跑。

公司资料敏感，走 OpenRouter 安全吗？

OpenRouter 预设只记录 metadata、不记录提示词内容；可在请求中设 zdr:true 只路由到零资料保留端点，或用 data_collection:'deny' 排除会收集资料的供应商。

繁體中文版 →