> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/pre-basic/providers/openrouter.md).

# OpenRouter

OpenRouter 係一個 **統一閘道**，用一把 key 接入 200+ 家廠商嘅對話模型（GPT、Claude、Gemini、Llama、DeepSeek 等），按 token 轉計費，適合多模型對比 / 冇法一一註冊各家帳號嘅用戶。

## 取得 API Key

* 前往 [OpenRouter](https://openrouter.ai/) 註冊帳號
* `Settings → Keys` → `Create Key`，複製 `sk-or-...` 密鑰
* 充值任意金額（最低 $1）

## 喺 Cherry Studio 配置

* 打開 `設定 → 模型服務`，搵到 **OpenRouter** Provider 入去詳情頁
* **API 密鑰** 填入 `sk-or-...`
* **API 地址** 預設 `https://openrouter.ai/api`，唔使改
* 撳 **獲取模型列表**，OpenRouter 會回傳幾百個可用模型

## 推薦用法

OpenRouter 嘅模型 ID 形式係 `<vendor>/<model>`：

| 模型 ID 示例                            | 實際對應邊個                    |
| ----------------------------------- | ------------------------- |
| `openai/gpt-4o`                     | OpenAI GPT-4o             |
| `anthropic/claude-sonnet-4`         | Anthropic Claude Sonnet 4 |
| `google/gemini-2.0-flash`           | Google Gemini Flash       |
| `meta-llama/llama-3.3-70b-instruct` | Meta Llama 3.3 70B        |
| `deepseek/deepseek-chat`            | DeepSeek V3               |
| `x-ai/grok-4`                       | xAI Grok                  |

## 適用場景

* **多模型 A/B 比較**：喺同一 Cherry Studio Provider 底下隨意轉模型，唔使轉 Provider
* **避免逐個註冊**：一個 key 一個發票就可以用 200+ 模型
* **冷門模型**：好多細廠商淨係喺 OpenRouter 上提供（例如 Cohere、Reka 等）

## 原生連網同網址讀取

OpenRouter 嘅對話模型可以使用原生網絡搜尋同 URL 內容讀取。揀模型嗰陣留意名旁邊嘅 🌐 圖標，並喺對話輸入欄開啟 🌐。

如果【設置】→【網絡搜尋】入面嘅【優先使用已配置嘅搜尋服務】保持開啟，Cherry Studio 會優先使用外部搜尋服務；關閉呢個選項之後，先會優先使用 OpenRouter 嘅模型原生能力。服務商可能會對聯網請求另外收費，實際費用以 OpenRouter 賬單為準。

## 同 Anthropic 協議嘅關係

OpenRouter 預設用 OpenAI 協議格式包裝所有上游模型。呢代表：

* ✅ 普通對話、知識庫、快捷助手都可用
* ⚠️ [Cherry Agent](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md) **建議直接用** Anthropic / CherryIN，唔好經 OpenRouter（Agent 需要 Anthropic 原生協議）

{% hint style="info" %}

* OpenRouter 喺原廠價格基礎上會加少少價（通常 5-10%），換嚟「一個帳號通用」
* 部分模型可以用 "free" 版本（免費但有限速），篩選時留意帶 `(free)` 後綴嘅條目
* 詳細價錢表見 [OpenRouter Models](https://openrouter.ai/models)
  {% endhint %}

***

### 攞幫助同提交意見

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改善建議，請參考 [反饋與建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/pre-basic/providers/openrouter.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.