> 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.md).

# 模型服務

Cherry Studio 內置 60+ 間 Provider（模型服務商）嘅連接模板，覆蓋國內外大部分主流模型同本地推理框架。本節為每間 Provider 提供獨立配置指南。

### Provider 類型

Cherry Studio 按協議將 Provider 分為以下幾類，行為略有差異：

| 類型               | 兼容協議                      | 典型代表                                            |
| ---------------- | ------------------------- | ----------------------------------------------- |
| **OpenAI 相容**    | `/v1/chat/completions`    | OpenAI、DeepSeek、硅基流動、OpenRouter、絕大多數三方網關        |
| **Anthropic 兼容** | `/v1/messages`            | Anthropic、CherryIN、部分網關。**Cherry Agent 需要呢種類型** |
| **Gemini**       | Google AI Studio / Vertex | Google Gemini、Vertex AI                         |
| **Bedrock**      | AWS Bedrock SDK           | AWS Bedrock                                     |
| **Azure OpenAI** | Azure OpenAI Service      | Azure OpenAI                                    |
| **本地推理**         | 本地 HTTP 服務                | Ollama、LM Studio、GPUStack、OpenVINO Model Server |
| **特殊網關**         | 廠商私有協議                    | NewAPI、OneAPI、AiHubMix、DMXAPI 等                 |

### 添加一個 Provider 嘅通用步驟

1. 打開 `設定 → 模型服務`
2. 喺內置 Provider 列表中搵到目標 Provider，撳入詳情頁
3. 填寫 **API 密鑰**（必填），按需要修改 **API 地址**（預設係 Provider 官方地址）
4. 撳 **獲取模型列表**，按需要加入你常用嘅對話/嵌入/視覺模型
5. （可選）撳 **檢測**，用任何一個對話模型驗證連接係咪成功

### Provider 配置詳解

#### 通用/網關類

* [CherryAI（免費）](/docs/zhong-wen-fan-ti/pre-basic/providers/cherryai.md)
* [CherryIN](/docs/zhong-wen-fan-ti/pre-basic/providers/cherryin-1.md) — 雙端點（OpenAI + Anthropic），Cherry Agent 推薦
* [NewAPI](/docs/zhong-wen-fan-ti/pre-basic/providers/newapi.md) / [OneAPI](/docs/zhong-wen-fan-ti/pre-basic/providers/oneapi.md) — 自建/三方網關

#### 海外廠商

* [OpenAI](/docs/zhong-wen-fan-ti/pre-basic/providers/openai.md)
* [Google Gemini](/docs/zhong-wen-fan-ti/pre-basic/providers/google-gemini.md)
* [Vertex AI](/docs/zhong-wen-fan-ti/pre-basic/providers/vertex-ai.md)
* [GitHub Copilot](/docs/zhong-wen-fan-ti/pre-basic/providers/github-copilot.md)
* [MiniMax Coding Plan](/docs/zhong-wen-fan-ti/pre-basic/providers/minimax-coding-plan.md)

#### 國內廠商

* [阿里云百炼](/docs/zhong-wen-fan-ti/pre-basic/providers/a-li-yun-bai-lian.md)
* [硅基流動](/docs/zhong-wen-fan-ti/pre-basic/providers/siliconcloud.md)
* [火山引擎（豆包）](/docs/zhong-wen-fan-ti/pre-basic/providers/doubao.md)
* [華為雲](/docs/zhong-wen-fan-ti/pre-basic/providers/huawei.md)
* [無問芯穹](/docs/zhong-wen-fan-ti/pre-basic/providers/wu-wen-xin-qiong.md)
* [PPIO 派歐雲](/docs/zhong-wen-fan-ti/pre-basic/providers/ppio.md)
* [ModelScope（魔搭）](/docs/zhong-wen-fan-ti/pre-basic/providers/modelscope.md)

#### 本地推理

* [Ollama](/docs/zhong-wen-fan-ti/pre-basic/providers/ollama.md)

#### 自定義服務商

* [自定義服務商](/docs/zhong-wen-fan-ti/pre-basic/providers/zi-ding-yi-fu-wu-shang.md) — 任何 OpenAI / Anthropic / Gemini 兼容端點

{% hint style="info" %}
**搵唔到你用嘅 Provider 點算？**

Cherry Studio 內置 60+ Provider 模板，但**遠多過本節文檔已收錄**嘅數量。如果你用嘅係 Anthropic（Claude）、Azure OpenAI、DeepSeek 官方、Grok、Groq、LM Studio、OpenRouter、Mistral、Perplexity、Together 等，**佢哋都喺 Provider 列表入面**，直接加密鑰就得。本節文檔會分批補齊呢啲 Provider 嘅專題頁。
{% endhint %}

### API 密鑰同 API 地址

詳見 [模型服務設定](/docs/zhong-wen-fan-ti/pre-basic/settings/providers.md)（包括多 Key 輪詢、`#` 結尾固定路徑等高級用法）。

***

### 💡 獲取幫助同提交反饋

如果您喺配置或使用過程中遇到任何疑問、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.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.