|
| **401** | 認證失敗：模型唔被支援或者服務端帳戶被封禁等 | 聯絡或者查看對應服務商帳戶狀態 |
| **403** | 請求操作無權限 | 根據對話返回嘅錯誤信息或者[控制台](#kong-zhi-tai-bao-cuo-cha-kan-fang-fa)錯誤信息提示進行相應操作 |
| **404** | 搵唔到請求資源 | 檢查請求路徑等 |
| **422** | 請求格式正確，但語義錯誤 | 呢類錯誤服務端可以解析，但無法處理。常見於JSON語義錯誤（如：空值；要求值係字串，但寫成咗數字或者布爾值等情況）。 |
| **429** | 請求速率達到上限 | 請求速率（TPM 或 RPM）達到上限，等陣先再用 |
| **500** | 伺服器內部錯誤，無法完成請求 | 持續出現嘅話聯絡上游服務商 |
| **501** | 伺服器唔支援請求嘅功能，無法完成請求 | |
| **502** | 作為網關或者代理工作的伺服器嘗試執行請求時，從遠程伺服器接收到一個無效回應 | |
| **503** | 由於超載或者系統維護，伺服器暫時無法處理客戶端嘅請求。延時長度可包含喺伺服器嘅Retry-After頭信息入面 | |
| **504** | 充當網關或代理嘅伺服器，未及時從遠端伺服器獲取請求 | |
***
## 控制台報錯睇法
* 撳 Cherry Studio 客戶端視窗之後，再按快捷鍵 Ctrl + Shift + I（Mac端：Command + Option + I）
{% hint style="info" %}
* 目前活動視窗必須係 Cherry Studio 嘅客戶端視窗先可以叫出控制台;
* 要先打開控制台，再撳測試或者發起對話等請求，先可以收集到請求信息。
{% endhint %}
- 喺彈出嘅控制台視窗入面撳 `Network` → 撳查看②處最後一個標有紅色 `×` 嘅 `completions`*（對話類、翻譯、模型連通性檢查等遇到錯誤時）* 或者 `generations`*（繪畫遇到錯誤時）* → 點擊`Response`睇完整嘅返回內容（圖中④嘅範圍）。
> 如果你判斷唔到呢個錯誤嘅原因，請將呢個介面截圖發去 [官方交流群](https://t.me/CherryStudioAI) 入面搵幫助。
呢個檢查方法唔單止喺對話時可以攞到錯誤信息，喺模型測試時、添加知識庫時、繪畫時等都可以用。無論邊種情況都要先打開調試視窗，再進行請求操作先可以攞到請求信息。·
{% hint style="info" %}
唔同場景下Name（上圖②處）欄入面嘅名稱會有啲唔同
對話、翻譯、模型檢查：`completions`
繪畫：`generations`
知識庫創建：`embeddings`
{% endhint %}
***
## 公式冇被渲染/公式渲染錯誤
* 公式未被渲染而係直接顯示公式代碼時，檢查公式有冇定界符
> **定界符用法**
>
> *行內公式*
>
> * 使用單個美元符號： `$formula$`
> * 或者使用`\(` 同 `\)`，例如：`\(formula\)`
>
> *獨立公式塊*
>
> * 使用雙美元符號： `$$formula$$`
> * 或者使用 `\[formula\]`
> * 示例： `$$\sum_{i=1}^n x_i$$`\
> $$\sum\_{i=1}^n x\_i$$
* 公式渲染錯誤／亂碼 常見喺公式內包含中文內容時，試下切換公式引擎做 KateX。
***
## 無法創建知識庫／提示獲取嵌入維度失敗
1. 模型狀態不可用
> 確認服務商係咪支援呢個模型，或者確認服務商嗰個模型服務狀態係咪正常。
2.使用咗非嵌入模型
***
## 模型唔可以識圖／無法上載或揀選圖片
首先要確認模型係咪支援識圖，熱門模型 Cherry Studio 會對其分類，模型名稱後面帶小眼睛圖標嘅就係支援識圖。
識圖模型會支援圖像文件上載，如果模型功能未被正確匹配，可以喺對應服務商嘅模型列表入面搵到嗰個模型，撳佢名稱後面嘅設定按鈕，再勾選圖像選項。
模型具體信息可以去對應服務商嗰度搵返佢嘅信息查閱。同嵌入模型一樣，唔支援視覺嘅模型唔需要強制開啟圖像功能，就算勾咗圖像選項都冇作用。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/question-contact/questions.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.