# 模型服務設置

而家呢個頁面只係做界面功能介紹，配置教程可以參考基礎教程入面嘅 [服務商配置](/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 %}


---

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