常見問題

常見錯誤代碼

• 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 會對其分類，模型名稱後面帶小眼睛圖示嘅就係支援識圖。

識圖模型會支援圖像檔案上載，如果模型功能未被正確匹配，可以喺對應服務商嘅模型列表入面搵到呢個模型，撳佢名稱後面嘅設定按鈕，再勾選圖像選項。

模型具體資訊可以去對應服務商搵返佢嘅資訊查閱。同嵌入模型一樣，唔支援視覺嘅模型唔需要強制開啟圖像功能，勾咗圖像選項都冇作用。