常見問題

此文件由 AI 從中文翻譯而來，尚未經過審閱。

常見錯誤代碼

• 4xx（客戶端錯誤狀態碼）：一般為請求語法錯誤、鑒權失敗或認證失敗等無法完成請求。

• 5xx（伺服器錯誤狀態碼）：一般為服務端錯誤，伺服器宕機、請求處理超時等。

錯誤碼	可能的情況	解決方法
400	請求體格式錯誤等	查看對話返回的錯誤內容或 控制台 查看報錯內容，根據提示操作。 【常見情況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 會對其分類，模型名稱後帶小眼睛圖標的即支援識圖。

識圖模型會支援圖像文件的上傳，如果模型功能未被正確匹配可在對應服務商的模型列表當中找到該模型，點擊其名稱後的設置按鈕並勾選圖像選項。

模型具體的信息可以到對應服務商找到其信息查閱。同嵌入模型一樣，不支援視覺的模型不需要強制開啟圖像功能，勾選了圖像的選項也沒有作用。