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

# 模型服務設定

呢一頁只係做界面功能介紹，配置教學可以參考基礎教學入面嘅 [服務商配置](/docs/zhong-wen-fan-ti/pre-basic/providers.md) 教學。

{% hint style="info" %}

* 使用內置服務商時只需要填寫對應嘅密鑰就得。
* 唔同服務商對密鑰嘅叫法可能唔同，密鑰、Key、API Key、令牌等都係指同一樣嘢。
  {% endhint %}

### API 密鑰

喺 Cherry Studio 入面，單個服務商支援多 Key 輪詢使用，輪詢方式係由前到後列表循環。

* 多 Key 用英文逗號隔開添加。例如以下示例：

<pre><code><strong>sk-xxxx1,sk-xxxx2,sk-xxxx3,sk-xxxx4
</strong></code></pre>

{% hint style="warning" %}
必須使用 **英文** 逗號。
{% endhint %}

### API 地址

使用內置服務商時一般唔需要填寫 API 地址，如果需要修改請嚴格按照對應官方文檔提供嘅地址填寫。

> 如果服務商提供嘅地址係 <mark style="background-color:red;"><https://xxx.xxx.com></mark><mark style="background-color:green;">/v1/chat/completions</mark> 呢種格式，只需要填寫根地址部分（<mark style="background-color:red;"><https://xxx.xxx.com></mark>）就得。
>
> Cherry Studio 會自動拼接剩餘嘅路徑（<mark style="background-color:green;">/v1/chat/completions</mark>），未按要求填寫可能會導致無法正常使用。

{% hint style="info" %}
說明：大多數服務商嘅大語言模型路由都係統一嘅，一般情況下唔需要做以下操作。如果服務商請求路由唔係常規嘅 <mark style="background-color:green;">/v1/chat/completions</mark> 時，可以喺 API 地址欄手動輸入 **完整嘅 API 地址**，並以 `#`結尾。

即係：

* API 地址使用 `#` 結尾時唔會執行拼接操作，只會使用填入嘅地址。 <img src="/files/fd644f58b5d47e828c96d9989a18ff527e5fa48a" alt="" data-size="original">
  {% endhint %}

### 添加模型

一般情況下點擊服務商配置頁面最左下角嘅 `管理` 按鈕會自動獲取該服務商所有支援調用嘅模型，喺獲取列表中點擊 `+` 號加到模型列表就得。

{% hint style="info" %}
點擊管理按鈕時，彈窗列表入面嘅模型唔會全部加入，需要點擊模型右側嘅 `+` ，加到服務商配置頁面嘅模型列表先可以喺模型選擇列表入面出現。
{% endhint %}

### 連通性檢查

點擊 API 密鑰輸入框後面嘅檢查按鈕就可以測試係咪成功配置。

{% hint style="info" %}
模型檢查時預設使用模型列表已添加模型入面最後一個對話模型，如果檢查時有失敗情況，請檢查模型列表係咪有錯誤或者唔支援嘅模型。
{% endhint %}

{% 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/settings/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.