# OpenRouter

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

## 拎 API Key

* 去 [OpenRouter](https://openrouter.ai/) 註冊帳號
* `Settings → Keys` → `建立金鑰`，複製 `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 等）

## 同 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: 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:

```
GET https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/pre-basic/providers/openrouter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.