> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/question-contact/questions.md).

# 常見問題

## 常見錯誤代碼

* **4xx（客戶端錯誤狀態碼）**：一般係請求語法錯誤、鑑權失敗或者認證失敗等，令請求無法完成。
* **5xx（伺服器錯誤狀態碼）**：一般係服務端錯誤，例如伺服器當機、請求處理超時等。

| 錯誤代碼    | 可能情況                                                    | 解決方法                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **400** | 請求體格式錯誤等                                                | <p>睇對話返回嘅錯誤內容或者 <a href="#kong-zhi-tai-bao-cuo-cha-kan-fang-fa">控制台\</a 睇報錯內容，跟住提示操作。</a></p><p><a href="#kong-zhi-tai-bao-cuo-cha-kan-fang-fa"><mark style="color:purple;">【常見情況1】</mark>：如果係gemini模型，可能需要綁卡；<br><mark style="color:purple;">【常見情況2】</mark>：數據體積超限，常見於視覺模型，圖片體積超過上游單個請求流量上限會返回呢個錯誤碼；<br><mark style="color:purple;">【常見情況3】</mark>：加咗唔支援嘅參數或者參數填寫錯誤。試下新建一個純淨嘅助手測試下正唔正常；<br><mark style="color:purple;">【常見情況4】：</mark>上下文超過限制，清除上下文或者新建對話或者減少上下文條數。</a></p> |
| **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 客戶端視窗後撳快捷鍵 <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>I</kbd>（Mac端：<kbd>Command</kbd> + <kbd>Option</kbd> + <kbd>I</kbd>）

{% hint style="info" %}

* 而家活動視窗必須係 Cherry Studio 嘅客戶端視窗先至可以叫出控制台；
* 要先打開控制台，再撳測試或者發起對話等請求先可以收集到請求資訊。
  {% endhint %}

- 喺彈出嘅控制台視窗入面撳 <mark style="color:藍色;">`Network`</mark> → 撳睇②處最後一個標有紅色 <mark style="color:red;">`×`</mark> 嘅 <mark style="color:red;">`completions`</mark>*（對話類、翻譯、模型連通性檢查等遇到錯誤時）* 或者 <mark style="color:red;">`generations`</mark>*（繪畫遇到錯誤時）* → 撳<mark style="color:藍色;">`Response`</mark>睇完整返嚟嘅內容（圖中④嘅區域）。

> 如果你判斷唔到呢個錯誤嘅原因，請將呢個界面截圖發送到 [官方交流群](https://t.me/CherryStudioAI) 入面尋求幫助。

<figure><img src="/files/c8259144de578a20354d37fe0f5eeabaf6475781" alt="" width="563"><figcaption></figcaption></figure>

呢個檢查方法唔止喺對話時可以攞到錯誤信息，喺模型測試、添加知識庫、繪畫等時都可以用。無論邊種情況都要先打開調試視窗，再進行請求操作去攞請求資訊。·

{% hint style="info" %}
喺唔同場景下 Name（上圖②處）欄入面嘅名稱會有唔同

對話、翻譯、模型檢查：<mark style="color:red;">`completions`</mark>

繪畫：<mark style="color:red;">`generations`</mark>

知識庫建立：<mark style="color:red;">`embeddings`</mark>
{% endhint %}

***

## 公式冇被渲染／公式渲染錯誤

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

> **定界符用法**
>
> *行內公式*
>
> * 用單個美元符號： `$formula$`
> * 或者用`\(` 同 `\)`，例如：`\(formula\)`
>
> *獨立公式塊*
>
> * 用雙個美元符號： `$$formula$$`
> * 或者用 `\[formula\]`
> * 示例： `$$\sum_{i=1}^n x_i$$`\
>   $$\sum\_{i=1}^n x\_i$$

* 公式渲染錯誤／亂碼，常見於公式入面包含中文內容時，試下將公式引擎切換做 KateX。

***

## 無法建立知識庫／提示獲取嵌入維度失敗

1. 模型狀態不可用

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

2.使用咗非嵌入模型

***

## 模型唔可以識圖／無法上載或選擇圖片

首先要確認模型係咪支援識圖，熱門模型 Cherry Studio 會對其分類，模型名稱後面帶小眼睛圖示嘅就係支援識圖。

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/question-contact/questions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.