# 常见问题

## 常见错误代码

* **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:blue;">`Network`</mark> → 点击查看②处最后一个标有红色 <mark style="color:red;">`×`</mark> 的 <mark style="color:red;">`completions`</mark>*（对话类、翻译、模型连通性检查等遇到错误时）* 或 <mark style="color:red;">`generations`</mark>*（绘画遇到错误时）* → 点击<mark style="color:blue;">`Response`</mark>查看完整的返回内容（图中④的区域）。

> 如果你无法判断该错误的原因,请将该界面截图发送到 [官方交流群](https://t.me/CherryStudioAI) 中寻求帮助。

<figure><img src="/files/pWD0SAcaO4TvK2lm2Tmz" 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: 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/question-contact/questions.md?ask=<question>
```

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.