U9 AI · DOCUMENTATION
Cherry Studio 串接指南
Cherry Studio 設定入口、位址填寫、模型選擇、驗收步驟與 MD 下載。
下載 MD 文件 ↓適用範圍與前提#
本頁提供 Cherry Studio 串接本站的設定說明。需要啟用的本站金鑰、可用餘額及協定相符的實際模型。2026-10-24 已核對官方資料，不代表每個客戶端版本與上游模型都已完成全流程測試。
設定步驟#
- 進入 Settings → Model Provider，新增自訂供應商，名稱設為 U9 AI。
- 選擇 OpenAI 相容類型，填寫 API Key 與 API Host。
- 同步模型或手動新增本站模型 ID，僅勾選已確認的能力。
- 執行模型檢測，再於新對話選擇 U9 AI 模型。
設定值對照#
| 設定項目 | 填寫內容 |
|---|---|
| API Host | https://u9ai.ai |
| API Key | YOUR_U9AI_API_KEY · 本站 API 金鑰 |
| Model | YOUR_CHAT_MODEL_ID · 實際可用模型 ID |
| 最終文字請求端點 | https://u9ai.ai/v1/chat/completions |
此工具的注意事項#
確認最終請求路徑為 /v1/chat/completions，避免重複 /v1。本頁設定一般聊天；Cherry Agent 的協定需求不同，聊天連通不代表 Agent 已相容。
驗收與交接#
先依快速開始執行唯讀 GET /v1/models，確認驗證與目錄。再分別驗收短文字非串流、串流及所需的完整工具呼叫往返。生成測試可能扣款，請保存請求編號並核對消費分析。失敗時在工單提供版本、模型 ID、端點、狀態碼及已遮蔽敏感資訊的錯誤；請勿盲目重送逾時任務。
可將本 MD 交給開發者或 Agent，要求保留原設定、僅替換可用模型並明確回報未驗證項。真實金鑰請勿寫入共享 MD。
官方參考#
會自動補全 /v1/chat/completions 的 API Host 請填根位址 https://u9ai.ai。若版本要求協定專屬版本基底網址，以頁面路徑預覽為準。以 / 結尾只追加 chat/completions；以 # 結尾固定完整請求位址。最終預覽須為 https://u9ai.ai/v1/chat/completions。保存後請啟用供應商開關。
← 使用文件