常見問題

常見錯誤代碼

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

識圖模型會支持圖像文件嘅上傳，如果模型功能未被正確匹配可喺對應服務商嘅模型列表入面搵到該模型，點擊其名稱後面嘅設置按鈕並勾選圖像選項。

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