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

# 模型服務設定

本頁介紹 `設定 → 模型服務` 呢個頁面介紹單一服務商配置頁嘅各項功能。配置某一家服務商嘅完整流程，見「服務商配置」。

{% hint style="info" %}

* 內置服務商通常只需要填對應嘅 **API 密鑰**。
* 唔同服務商對密鑰嘅叫法唔同：密鑰、Key、API Key、令牌，指嘅都係同一樣嘢。
  {% endhint %}

### API 密鑰

填入服務商嘅 API 密鑰就得。Cherry Studio 支援 **一個服務商設定多個密鑰、輪流使用**（按列表由前到後循環）。有兩種管理方式：

* **快速新增**：多個密鑰用 **英文逗號** 隔開直接填入，例如 `sk-xxx1,sk-xxx2,sk-xxx3`。
* **API 密鑰管理**：撳 API 密鑰輸入框右邊嘅 **鎖匙圖標按鈕**（懸停顯示「API 密鑰管理」）就可以入去——每個密鑰都係一個獨立條目，可以分別 **編輯標籤**、**啟用 / 停用**、**複製**、**刪除**。

{% hint style="warning" %}
用逗號分隔多個密鑰時，必須使用 **英文** 逗號。
{% endhint %}

### API 地址

內置服務商一般唔使填 API 地址（用預設就得）。如要修改，請按服務商官方文件填寫。

> 如果服務商提供嘅係 `https://xxx.com/v1/chat/completions` 呢種完整地址，通常只填 **根地址** `https://xxx.com` 就得，Cherry Studio 會自動補上 `/v1/chat/completions`。

{% hint style="info" %}
如果服務商嘅請求路徑唔係常規嘅 `/v1/chat/completions`，可喺 API 地址欄填 **完整地址並以 `#` 結尾**——以 `#` 結尾時就唔會再自動拼接版本路徑，只用你填嘅地址。
{% endhint %}

### 新增模型

撳服務商配置頁嘅「**獲取模型列表**」按鈕，會拉取該服務商支援嘅模型；喺彈出嘅「模型管理」列表入面撳模型右邊嘅 `+` 將佢加入你嘅模型列表。**只有加入列表嘅模型** 先會出現喺各處嘅模型選擇器入面。

模型名稱下方會顯示服務商返回嘅 **實際 API 模型 ID**。日期版、供應商前綴版等名稱相近嘅模型唔會再被合併；新增或選擇模型前，先核對呢行 ID，避免揀到同名嘅另一版本。

### 連通性檢查

撳「**檢測**」按鈕，揀一個模型就可以測試係咪配置成功（設定多個密鑰時，仲可以選擇用邊個密鑰檢測）。如果檢測失敗，請檢查模型列表入面係咪有填錯或者唔支援嘅模型。

### API 設定（進階）

部分服務商可以喺「**API 設定**」入面開啟特定能力，例如：支援陣列格式嘅 message content、Developer Message、`enable_thinking`（控制 Qwen3 等模型嘅思考）、`service_tier`（僅 OpenAI）等。一般唔需要改動。

{% hint style="danger" %}
配置好之後，務必打開服務商右上角嘅 **啟用開關**，否則該服務商仍然未啟用，佢嘅模型唔會出現喺模型選擇列表入面。
{% 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/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.