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

> OpenRouter 是一个网关，让你用一个接口、一个账号调用许多厂商的上百个 AI 模型。你按 OpenAI 的格式发请求，写上想用的模型名，OpenRouter 就把它转给能提供这个模型的服务商。某个服务商出问题时，它可以改走另一个，它也有带限额的免费模型。

Mindket 编辑部 · 发布于 2026-11-06 · 更新于 2026-11-06 · https://mindket.com/cn/learn/tools/openrouter

## 要点

- 一个 OpenRouter 密钥能用上百个模型，换模型只要改请求里的一个名字。
- 它接受 OpenAI 的请求格式，所以把 base URL 和密钥换掉，OpenAI 的 SDK 就能用。
- 免费模型不需要积分，但每分钟和每天都有上限，而改走付费模型的备用方案是要收费的。
- 给每个密钥设一个额度上限，也别把密钥放进要分享的代码里。
- 你的提示词会发给有自己数据政策的服务商，发私密内容之前先看一下它的政策。

## 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 吗？ | 或者试试 |
| --- | --- | --- |
| 用一个账号、一个密钥比较好几个模型 | 适合。这正是它的主要工作 | 各厂商自己的 API，比如 [OpenAI API 快速入门](https://mindket.com/cn/learn/openai-api/openai-api-quickstart) |
| 用 OpenAI 的 SDK 换个 base URL 调用模型 | 适合，文档就是这么写的 | 厂商自己的接口地址 |
| 只有某一家厂商的 API 才有的功能 | 先看模型页面，因为不同模型和服务商的支持情况不一样 | 厂商自己的 API |
| 让提示词只留在自己的电脑上 | 不适合。请求会发给托管的服务商 | [Ollama](https://mindket.com/cn/learn/tools/ollama) 或 [LM Studio](https://mindket.com/cn/learn/tools/lm-studio) |
| 不写代码，直接和助手聊天 | 它有聊天室，但助手类产品更适合做这件事 | [ChatGPT](https://mindket.com/cn/learn/tools/chatgpt)、[Claude](https://mindket.com/cn/learn/tools/claude) 或 [Gemini](https://mindket.com/cn/learn/tools/gemini) |
| 下载开源模型文件 | 不适合，它转发请求，不提供文件 | [Hugging Face](https://mindket.com/cn/learn/tools/hugging-face) |
| 围绕一个 AI 步骤搭工作流 | 单靠它不行，它提供的是模型，不是步骤 | [n8n](https://mindket.com/cn/learn/tools/n8n)、[Zapier](https://mindket.com/cn/learn/tools/zapier) 或 [Make](https://mindket.com/cn/learn/tools/make) |

## OpenRouter 怎么用，一步一步来

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

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

1. 打开 **Models**（模型）页面，把左栏里的 **Prompt pricing**（提示词价格）滑块设到 **FREE**（免费）。列表就只剩免费模型，正好拿来入门。
   ![示意图：OpenRouter 的 Models 页面，左栏里的 Prompt pricing 滑块被金色圆框圈出。](https://mindket.com/blog/screens/openrouter-1-prompt-pricing.webp?v=05cfaf2b9df3)
2. 要用付费模型，打开 **Credits**（积分）页面，点 **Add Credits**（充值积分）。免费模型不需要积分。
   ![示意图：OpenRouter 的 Credits 页面，Add Credits 按钮被金色圆框圈出。](https://mindket.com/blog/screens/openrouter-2-add-credits.webp?v=8ec0c747dfe8)
3. 打开 **Keys**（密钥）页面，点 **Create API Key**（创建 API 密钥）。填上名字，再填 **Credit limit (optional)**（额度上限，可不填），这样程序死循环时，花到这个数就会停。
   ![示意图：OpenRouter 的 Create a Key 对话框，Credit limit (optional) 输入框被金色圆框圈出。](https://mindket.com/blog/screens/openrouter-3-credit-limit.webp?v=2e9d00854bb6)
4. 发出第一个请求之后，点左侧菜单里的 **Activity**（用量记录）。它会列出每次请求用的模型、词元数和花费。
   ![示意图：OpenRouter 的 Activity 页面，左侧菜单里的 Activity 被金色圆框圈出。](https://mindket.com/blog/screens/openrouter-4-activity.webp?v=c14de7c92afe)

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

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

## 做一个例子试试

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

````bash
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`。两个后缀改变的都是服务商的排序方式。
- 在它上面搭东西之前，先读模型的页面。并不是每个模型都支持工具调用、图片和结构化输出。
- 处理敏感的文字时，打开[隐私设置](https://openrouter.ai/settings/privacy)，把路由限制在数据政策你能接受的服务商上。

## 限制和费用

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

## YouTube 教程

- [What is OpenRouter | All about OpenRouter in 10 minutes](https://www.youtube.com/watch?v=fjd2hm6-qtM) (codebasics)
- [How to Use AI Models API for Free | OpenRouter Tutorial](https://www.youtube.com/watch?v=VvJvJ0uXiVQ) (The Coding Koala)
- [OpenRouter Explained: One API Key for Every AI Model](https://www.youtube.com/watch?v=5XMkwyQnyQs) (Coding Fab)
- [How to Use OpenRouter (Tutorial for Beginners)](https://www.youtube.com/watch?v=iZM2DcOhaaY) (MMX)

## 深入学习 OpenRouter

- [OpenAI API 教程：用 Python 和 JavaScript 调用 Responses API](https://mindket.com/cn/learn/openai-api/openai-api-quickstart)
- [我的任务该用哪个 AI 模型？](https://mindket.com/cn/learn/ai-basics/choose-an-ai-model)

## 常见问题

### OpenRouter 免费吗？

部分免费。没有积分的账号可以在免费上限之内调用免费模型，文档给出的上限是每天 50 次请求，买过至少 10 个积分之后是 1,000 次。付费模型要花积分，购买积分时 OpenRouter 会收一笔费用。

### OpenRouter 到底做什么？

它夹在你的代码和运行 AI 模型的公司之间。你只向 OpenRouter 发一次请求，它挑一个能提供你指定模型的服务商，并负责计费和备用切换。它在 GitHub 上的主页列出了 400 多个模型和 90 多个服务商。

### OpenRouter 能配合 OpenAI 的 SDK 使用吗？

能。OpenRouter 的文档说，任何支持 OpenAI 的 SDK 也支持它，它在 GitHub 上的主页则说，把 base URL 和密钥换掉就行。它接受的请求格式是 Responses API 和 Chat Completions。

### OpenRouter 会看到我的提示词吗？

请求会经过它，但它的隐私页面说，除非你开启日志记录，或者内容被标记送去做滥用审查，否则它不会保存提示词和回复。它会保存词元数量和延迟这类元数据。模型的服务商有自己的政策。

### OpenRouter 是谁做的？

OpenRouter 是一家总部在纽约的公司。Wikipedia 说它由 Alex Atallah 和 Louis Vichy 在 2023 年创立。

### 能把 OpenRouter 和 Claude Code 或 Cursor 一起用吗？

它的文档里有 Claude Code、Codex CLI 和 Cursor 的指南。Claude Code 的指南提醒，这套设置只保证能配合 Anthropic 自己的服务商使用，所以请照[指南里关于服务商的建议](https://github.com/OpenRouterTeam/docs/blob/main/cookbook/coding-agents/claude-code-integration.mdx)来做。

## 资料来源

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

[开始这一课](https://mindket.com/cn/learn/openai-api/openai-api-quickstart)