FAQ

Problems

Common Error Codes

• 4xx (client error status code): Generally indicate that the request cannot be completed because of request syntax error, authentication failure, or authentication failure.

• 5xx (server error status code): generally server-side errors, server downtime, request processing timeout, etc.

Error Status Code	Possible Scenarios	Solution
400	Wrong request format, etc.	Check the contents of the error returned by the dialog or the console to see what is reported as an error, and follow the prompts. [Common Case 1]: If it is a Gemini model, you may need bind a card; [Common Case 2]: Data volume exceeds the limit. Commonly in Visual Models, the image volume exceeds the upper limit of the upstream single request traffic will return the error code; [Common Case 3]: Add unsupported parameters or fill in the parameters incorrectly. Try to create a new pure assistant to test whether it is normal; [Common Scenario 4]: Context exceeds the limit, clear the context or create a new dialog or reduce the number of context entries.
401	Authentication failed: Model not supported or the server account is banned, etc.	Contact or check the status of the corresponding service provider's account
403	Operation not authorized	Act according to the error messages returned by the dialog or the console error message prompts.
404	Resource not found	Checking request paths, etc.
429	Request rate limit reached	Request rate (TPM or RPM) has reached the limit, please try again after a while.
500	Internal server error, unable to complete request	Contact upstream service provider if persistent
501	The server does not support the requested function and cannot complete the request
502	A server working as a gateway or proxy receives an invalid response from a remote server when it tries to execute a request
503	The server is temporarily unable to process client requests due to overload or system maintenance. The length of the delay can be included in the server's Retry-After header information
504	Servers acting as gateways or proxies that do not get requests from remote servers in a timely manner

---

How to View Console Errors

• Click on the CherryStudio client window and press the shortcut Ctrl+Shift+I (Mac: Command+Option+I).

• The currently active window must be a CherryStudio client window to bring up the console.

• You need to open the console and then click on a request such as test or initiate a dialog to collect the request information.

In the pop-up console window, click Network → Click to view the last "completions" (for errors encountered in dialogue, translation, model connectivity checks, etc.) or "generations" (for errors encountered in drawing) marked with a red × at ② → Click Response to view the complete return content (the area in ④ in the image).

If you can't determine the cause of the error, please send a screenshot of this screen to the Official Communication Group for help.

This checking method can be used to get error information not only during dialogs, but also during model testing, when adding knowledge bases, when painting, etc. In either case it is necessary to open the debugging window first and then perform the request operation to get the request information.

The name in the Name (② above) column will be different in different scenarios.

Dialog, translation, model checking: completions

Painting: generations

Knowledge base creation: embeddings

---

Formula Not Rendered / Formula Rendering Error

• Check if the formula has delimiters when the formula code is displayed directly instead of being rendered.

Usage of delimiter

Inline formula

• Use a single dollar sign: $formula$

• Or use \( and \): \(formula\)

Independent formula block

• Use double dollar symbols: $$formula$$

• Or use \[formula\]

• Example: $$\sum_{i=1}^n x_i$$, $\sum_{i=1}^n x_i$

Formula rendering error/gibberishni commonly when the formula contains Chinese(CJK) content, try to switch the formula engine to KateX.

---

Failed to Create Knowledge Base / Failed to Get Embedding Dimensions

1. Model state unavailable

2. Non-embedding model is used

Attention:

1. Embedding models, dialog models, drawing models, etc. have their own functions, and their request methods and return contents and structures are different, so please don't force other types of models to be used as embedded models;

2. CherryStudio will automatically categorize the embedding models in the embedding model list (as shown in the above figure). If the model is confirmed to be an embeding model but has not been categorized correctly, you can go to the model list and click on the Settings button at the back of the corresponding model to check the embedding option;

3. If you cannot confirm which models are embedding models, you can check the model information from the corresponding service provider.

---

Model Cannot Recognize Images / Unable to Upload or Select Images

First, you need to confirm whether the model supports image recognition. CherryStudio categorizes popular models, and those with a small eye icon after the model name support image recognition.

Image recognition models will support uploading image files. If the model function is not correctly matched, you can find the model in the model list of the corresponding service provider, click the settings button after its name, and check the image option.

You can find the specific information of the model from the corresponding service provider. Like embedding models, models that do not support vision do not need to enable the image function, and selecting the image option will have no effect.