OpenRouter 怎么用：一个密钥，调用上百个 AI 模型

OpenRouter 是什么

OpenRouter 是 AI 模型的网关，它本身不是模型。你不用在 OpenAI、Anthropic 和 Google 各开一个账号，只要开一个 OpenRouter 账号，充上积分，就能通过同一个地址调用它们的模型。它在 GitHub 上的主页把自己叫作 LLM 的统一接口，说有 400 多个模型，并在 90 多个服务商之间自动切换备用。

它的请求长得像 OpenAI 的请求。OpenRouter 的文档说，它的格式和 OpenAI 的非常接近，同时支持 Responses API 和 Chat Completions，所以把 base URL 和密钥换掉，OpenAI 的 SDK 就能用。Wikipedia 说这家公司 2023 年创立于纽约。

OpenRouter 擅长做什么

• 用一个密钥试很多模型：改一下请求里的模型名，同一份代码就在和另一个模型对话。
• 用免费模型学习：带 :free 的模型版本和 openrouter/free 路由器不花积分，只受每天上限的限制。
• 备用切换：服务商宕机或被限流时，OpenRouter 会试下一个服务商，你还可以用 models 列表指定备用模型。
• 比较服务商：每个模型的页面都显示提供它的每个服务商的延迟和吞吐量，:nitro 和 :floor 后缀分别按速度和价格排序。
• 不只是文字：模型列表可以按图片、视频、语音、转写和嵌入模型来筛选。
• 编程工具：OpenRouter 的文档里有配合 Claude Code、Codex CLI 和 Cursor 使用的指南。

什么时候用 OpenRouter，什么时候换别的工具

OpenRouter 怎么用，一步一步来

下面的步骤针对 OpenRouter 的网站。网站更新后页面位置会变，所以这里只写不容易变的部分：模型列表、积分、密钥和用量记录。

1. 在 OpenRouter 的网站上注册一个账号。它的常见问题页说，付费模型要先充值积分，而没有积分的账号，仍然可以在免费上限之内调用免费模型。
2. 打开模型页面浏览。每个模型都有自己的页面，写着它的服务商、上下文长度，以及它支持什么，比如图片或工具调用。先筛选出免费模型。
3. 要用付费模型，就在 Credits 页面充值积分。常见问题页说，每次请求的费用从你的积分余额里扣，价格按每百万个词元计算。
4. 打开密钥页面，创建一个 API 密钥。给它起个名字，再设一个额度上限，因为文档建议给每个密钥都设上限。
5. 把密钥存进名为 OPENROUTER_API_KEY 的环境变量里。千万别把它贴进要提交或分享的代码。
6. 用下面的例子发出第一个请求。它用的是 openrouter/free，所以由 OpenRouter 替你挑一个免费模型。
7. 看一下回复。里面的 model 字段会写出回答你的是哪个模型。下次想用指定的模型，只改模型名就行。
8. 打开 Activity 页面，看每次请求的用量和花费，跑长任务之前也检查一下密钥的额度。

1. 打开 Models（模型）页面，把左栏里的 Prompt pricing（提示词价格）滑块设到 FREE（免费）。列表就只剩免费模型，正好拿来入门。

   

2. 要用付费模型，打开 Credits（积分）页面，点 Add Credits（充值积分）。免费模型不需要积分。

   

3. 打开 Keys（密钥）页面，点 Create API Key（创建 API 密钥）。填上名字，再填 Credit limit (optional)（额度上限，可不填），这样程序死循环时，花到这个数就会停。

   

4. 发出第一个请求之后，点左侧菜单里的 Activity（用量记录）。它会列出每次请求用的模型、词元数和花费。

   

以下是 AI 绘制的 OpenRouter 界面示意图，绘于 2026 年 11 月 6 日，按这些步骤画成。它们不是截图，实际界面可能不同，请以你看到的为准。

本页顶部的视频教程会在屏幕上演示这些步骤。OpenRouter 时不时会调整页面，如果名称不一样，就按你屏幕上看到的来。

做一个例子试试

在 Mac 或 Linux 的终端，或者在 Git Bash 里运行下面这段，密钥放在 OPENROUTER_API_KEY 里。它是 OpenRouter 文档里的免费路由器示例，只换了一个新问题。

curl https://openrouter.ai/api/v1/responses \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openrouter/free",
    "input": "Explain in two sentences what an API gateway does."
  }'

• 回复是 JSON。里面的 model 字段会写出 OpenRouter 选中的免费模型，每次请求可能不一样。
• 免费请求每分钟和每天都有上限，所以隔一会儿再发第二次，可能会被拒绝。
• 想改用 Python 的 openai 包，就把 base_url 设成 https://openrouter.ai/api/v1，把 api_key 设成你的 OpenRouter 密钥，OpenRouter 的文档就是这么写的。
• 想用别的模型，就把 openrouter/free 换成从它的页面复制来的模型名。

让结果更好的几个办法

• 先用 openrouter/free 学习。等你清楚任务需要什么，再换成指定的模型。
• 给每个密钥设一个额度上限。这样密钥泄露或者程序死循环时，花到上限就停，不会把余额花光。
• 想让一次请求保持免费，就只在 models 列表里放带 :free 的模型。改走付费模型的备用方案，会按那个模型自己的价格收费。
• 在意速度就用 :nitro 后缀，在意价格就用 :floor。两个后缀改变的都是服务商的排序方式。
• 在它上面搭东西之前，先读模型的页面。并不是每个模型都支持工具调用、图片和结构化输出。
• 处理敏感的文字时，打开隐私设置，把路由限制在数据政策你能接受的服务商上。

限制和费用

• OpenRouter 的常见问题页和限制页，在 2026 年 11 月 6 日读到的内容是，免费模型每分钟 20 次请求。每天的上限是，累计购买不到 10 个积分的账号 50 次，买过至少 10 个积分的是 1,000 次。
• OpenRouter 说，它按服务商的价格转收，推理不加价，只在你购买积分时收一笔费用。充一大笔余额之前，先在它的常见问题页看一下这笔费用。
• 免费模型随时可能被限流或者不可用，免费版本的限制也可能和付费模型不一样。
• 除非你开启日志记录，或者内容被标记送去做滥用审查，否则 OpenRouter 不会保存你的提示词和回复。运行你请求的那个服务商有自己的数据政策，有些服务商可能会拿提示词做训练，所以要逐个看。
• 第三方工具可能需要指定的服务商。它的 Claude Code 指南说，这套设置只保证能配合 Anthropic 自己的服务商使用。

深入学习 OpenRouter

1. 1OpenAI API 实战课：Responses、工具调用、结构化输出与智能体 · 第 1 节，共 4 节OpenAI API 教程：用 Python 和 JavaScript 调用 Responses API写给开发者的 OpenAI API 教程：拿到密钥，安装 SDK，用 Python 和 JavaScript 调用 Responses API，做流式输出并保存对话状态。10 分钟
2. 2AI 入门课：适合新手的 AI 基础教程 · 第 2 节，共 4 节我的任务该用哪个 AI 模型？我该用哪个 AI 模型？先按任务和文件所在的位置挑助手，再选快速模型或深度思考模型，并用你自己的活儿对比测试两个助手。7 分钟

常见问题

资料来源

1. GitHub: OpenRouterTeam docs, Quickstart (2026年11月6日 查阅)https://github.com/OpenRouterTeam/docs/blob/main/quickstart.mdx
2. GitHub: OpenRouterTeam docs, FAQ (2026年11月6日 查阅)https://github.com/OpenRouterTeam/docs/blob/main/faq.mdx
3. GitHub: OpenRouterTeam docs, API reference overview (2026年11月6日 查阅)https://github.com/OpenRouterTeam/docs/blob/main/api_reference/overview.mdx
4. GitHub: OpenRouterTeam docs, Authentication (2026年11月6日 查阅)https://github.com/OpenRouterTeam/docs/blob/main/api_reference/authentication.mdx
5. GitHub: OpenRouterTeam docs, Limits (2026年11月6日 查阅)https://github.com/OpenRouterTeam/docs/blob/main/api_reference/limits.mdx
6. GitHub: OpenRouterTeam docs, Free Models Router (2026年11月6日 查阅)https://github.com/OpenRouterTeam/docs/blob/main/guides/routing/routers/free-router.mdx
7. GitHub: OpenRouterTeam docs, Model fallbacks (2026年11月6日 查阅)https://github.com/OpenRouterTeam/docs/blob/main/guides/routing/model-fallbacks.mdx
8. GitHub: OpenRouterTeam docs, Data collection (2026年11月6日 查阅)https://github.com/OpenRouterTeam/docs/blob/main/guides/privacy/data-collection.mdx
9. GitHub: OpenRouterTeam docs, Claude Code guide (2026年11月6日 查阅)https://github.com/OpenRouterTeam/docs/blob/main/cookbook/coding-agents/claude-code-integration.mdx
10. GitHub: OpenRouterTeam organization profile (2026年11月6日 查阅)https://github.com/OpenRouterTeam/.github/blob/main/profile/README.md
11. Wikipedia: OpenRouter (2026年11月6日 查阅)https://en.wikipedia.org/wiki/OpenRouter
12. codebasics on YouTube: What is OpenRouter (2026年11月6日 查阅)https://www.youtube.com/watch?v=fjd2hm6-qtM
13. The Coding Koala on YouTube: How to Use AI Models API for Free (2026年11月6日 查阅)https://www.youtube.com/watch?v=VvJvJ0uXiVQ
14. Coding Fab on YouTube: OpenRouter Explained (2026年11月6日 查阅)https://www.youtube.com/watch?v=5XMkwyQnyQs
15. MMX on YouTube: How to Use OpenRouter (Tutorial for Beginners) (2026年11月6日 查阅)https://www.youtube.com/watch?v=iZM2DcOhaaY