模型服務設定

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

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

API 密鑰

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

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

用逗號分隔多個密鑰時，必須使用 英文 逗號。

API 地址

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

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

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

新增模型

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

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

連通性檢查

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

API 設定（進階）

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

配置好之後，務必打開服務商右上角嘅 啟用開關，否則該服務商仍然未啟用，佢嘅模型唔會出現喺模型選擇列表入面。

---

攞幫助同提交意見

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改善建議，請參考 反饋與建議 入面提供嘅官方渠道。