常見問題

常見錯誤代碼

• 4xx（客戶端錯誤狀態碼）：一般係請求語法錯誤、驗證失敗或者授權失敗等，導致無法完成請求。

• 5xx（伺服器錯誤狀態碼）：一般係伺服器端出錯，例如伺服器當機、請求處理超時等。

錯誤碼	可能嘅情況	解決方法
400	請求體格式錯誤等	查看對話返回嘅錯誤內容或者 控制台</a 查看報錯內容，根據提示操作。 【常見情況1】：如果係 gemini 模型，可能需要綁卡操作； 【常見情況2】：數據體積超限，常見於視覺模型，圖片體積超過上游單個請求流量上限會返回該錯誤碼； 【常見情況3】：加咗唔支持嘅參數或者參數填寫錯誤。試下新建一個乾淨嘅助手測試吓係咪正常； 【常見情況4】：上下文超過限制，清除上下文或者新建對話或減少上下文條數。
401	認證失敗：模型唔被支持或者伺服器端賬戶被封禁等	聯繫或者查看對應服務商賬戶狀態
403	請求操作無權限	根據對話返回嘅錯誤信息或者控制台錯誤信息提示進行相應操作
404	無法搵到請求資源	檢查請求路徑等
422	請求格式正確，但語義錯誤	呢類錯誤伺服器可以解析，但無法處理。常見於 JSON 語義錯誤（例如：空值；要求值係字符串，但寫成咗數字或者布爾值等情況）。
429	請求速率達到上限	請求速率（TPM 或者 RPM）達到上限，冷靜一陣再用
500	伺服器內部錯誤，無法完成請求	如果持續出現就聯絡上游服務商
501	伺服器唔支持請求嘅功能，無法完成請求
502	作為閘道或者代理嘅伺服器嘗試執行請求時，從遠端伺服器接收到咗一個無效嘅回應
503	由於超載或者系統維護，伺服器暫時無法處理客戶端嘅請求。延遲嘅長短可能包含喺伺服器嘅 Retry-After 頭信息中
504	充當閘道或代理嘅伺服器，未及時從遠端伺服器獲取請求

---

控制台報錯查看方法

• 撳開 Cherry Studio 客戶端視窗之後按快捷鍵 Ctrl + Shift + I（Mac 端：Command + Option + I）

• 當前活動視窗必須係 Cherry Studio 嘅客戶端視窗先可以調出控制台；

• 需要先打開控制台，然後再點測試或者發起對話等請求先可以收集到請求信息。

• 喺彈出嘅控制台視窗中點擊 Network → 點擊查看②處最後一個標有紅色 × 嘅 completions（對話類、翻譯、模型連通性檢查等遇到錯誤時） 或者 generations（繪畫遇到錯誤時） → 點擊Response查看完整嘅返回內容（圖中④嘅區域）。

如果你無法判斷該錯誤嘅原因，請將呢個界面截圖發送到 官方交流群 入面尋求幫助。

呢個檢查方法唔單止喺對話時可以獲取錯誤信息，喺模型測試、添加知識庫、繪畫等等場景都可以用。無論邊種情況都需要先打開調試視窗，然後進行請求操作嚟獲取請求信息。

唔同場景下 Name（上圖②處）欄裏面嘅名稱會有唔同

對話、翻譯、模型檢查：completions

繪畫：generations

知識庫創建：embeddings

---

公式冇被渲染/公式渲染錯誤

• 如果公式冇被渲染而係直接顯示公式代碼，檢查公式有冇定界符

定界符用法

行內公式

• 使用單個美元符號： $formula$

• 或者使用\( 同 \)，例如：\(formula\)

獨立公式塊

• 使用雙美元符號： $$formula$$

• 或者使用 \[formula\]

• 示例： $$\sum_{i=1}^n x_i$$ $\sum_{i=1}^n x_i$

• 公式渲染錯誤/亂碼 常見喺公式內包含中文內容時，試下切換公式引擎去 KateX。

---

無法創建知識庫/提示獲取嵌入維度失敗

1. 模型狀態不可用

確認服務商係咪支持該模型，或者確認服務商嗰個模型服務狀態係咪正常。

2. 使用咗非嵌入模型

---

模型唔識圖/無法上傳或者選擇圖片

首先要確認模型係咪支持識圖，熱門模型 Cherry Studio 會對佢分類，模型名稱後面帶細眼睛圖標嘅就係支持識圖。

識圖模型會支持圖像文件上傳，如果模型功能冇被正確匹配可以喺對應服務商嘅模型列表入面搵到該模型，點佢名稱後面嘅設定掣並揀選圖像選項。

模型具體嘅信息可以去對應服務商度搵佢嘅信息查閱。好似嵌入模型一樣，唔支持視覺嘅模型唔需要強制開啟圖像功能，就算揀咗圖像選項都冇作用。