常见问题

常见错误代码

• 4xx（客户端错误状态码）：一般为请求语法错误、鉴权失败或认证失败等无法完成请求。

• 5xx（服务器错误状态码）：一般为服务端错误，服务器宕机、请求处理超时等。

错误码	可能的情况	解决方法
400	请求体格式错误等	查看对话返回的错误内容或控制台查看报错内容，根据提示操作。 【常见情况1】：如果是gemini模型，可能需要进行绑卡操作； 【常见情况2】：数据体积超限，常见于视觉模型，图片体积超过上游单个请求流量上限会返回该错误码； 【常见情况3】：加了不支持的参数或参数填写错误。尝试新建一个纯净的助手测试是否正常。
401	认证失败：模型不被支持或服务端账户被封禁等	联系或查看对应服务商账户状态
403	请求操作无权限	根据对话返回的错误信息或控制台错误信息提示进行相应操作
404	无法找到请求资源	检查请求路径等
429	请求速率达到上限	请求速率（TPM 或 RPM）达到上限，冷静一会再用
500	服务器内部错误，无法完成请求	持续出现的话联系上游服务商
501	服务器不支持请求的功能，无法完成请求
502	作为网关或者代理工作的服务器尝试执行请求时，从远程服务器接收到了一个无效的响应
503	由于超载或系统维护，服务器暂时的无法处理客户端的请求。延时的长度可包含在服务器的Retry-After头信息中
504	充当网关或代理的服务器，未及时从远端服务器获取请求

---

控制台报错查看方法

• 点击CherryStudio客户端窗口后按下快捷键Ctrl+Shift+I（Mac端：Command+Option+I）

• 当前活动窗口必须为CherryStudio的客户端窗口才能调出控制台;

• 需要先打开控制台，再点击测试或者发起对话等请求才能收集到请求信息。

• 在弹出的控制台窗口中点击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.使用了非嵌入模型

注意：

1. 嵌入类模型、对话类模型、绘画类模型等各自有各自的功能，其请求方式跟返回内容、结构都有所不同，请勿强行将其他类别的模型作为嵌入模型使用；

2. 嵌入类模型CherryStudio会自动分类显示在嵌入模型列表中（如上图），如果确认为嵌入模型但未被正确分类，可到模型列表中点击对应模型后方的设置按钮勾选嵌入选项；

3. 如果无法确认哪些模型是嵌入模型可到对应服务商查询模型信息。

---

模型不能识图/无法上传或选择图片

首先需要确认模型是否支持识图，热门模型CherryStudio会对其分类，模型名称后带小眼睛图标的即支持识图。

识图模型会支持图像文件的上传，如果模型功能未被正确匹配可在对应服务商的模型列表当中找到该模型，点击其名称后的设置按钮并勾选图像选项。

模型具体的信息可以到对应服务商找到其信息查阅。同嵌入模型一样，不支持视觉的模型不需要强制开启图像功能，勾选了图像的选项也没有作用。