FAQs

This document was translated from Chinese by AI and has not yet been reviewed.

Frequently Asked Questions

Common Error Codes

• 4xx (Client Error Status Codes): Generally indicate requests that cannot be completed due to syntax errors, authentication/authorization failures, etc.

• 5xx (Server Error Status Codes): Generally indicate server-side errors like server downtime, request timeouts, etc.

Error Code	Possible Scenarios	Solution
400	Request body format error, etc.	Check error message in chat response or use the console to view error details, then follow prompts. 【Common Case 1】 For Gemini models, card binding may be required; 【Common Case 2】 Data size exceeds limit, common with vision models where image size exceeds provider's request limit; 【Common Case 3】 Added unsupported parameters or incorrect parameter values. Try testing with a clean assistant; 【Common Case 4】 Context exceeds limit - clear context, start new conversation, or reduce context messages.
401	Authentication failure: Unsupported model or provider account suspension	Contact service provider or check account status
403	No permission for requested operation	Follow instructions based on error message in chat response or console
404	Requested resource not found	Check request paths, etc.
422	Semantically invalid request despite correct format	Common with JSON semantic errors (e.g., null values; numbers/booleans passed where strings required)
429	Request rate limit reached	Request rate (TPM/RPM) capped, try again later
500	Internal server error	Contact service provider if persistent
501	Server doesn't support requested functionality
502	Bad Gateway: Invalid response from upstream server
503	Service Unavailable: Server overloaded/maintenance
504	Gateway Timeout: Proxy server didn't receive timely response from upstream

---

Console Error Viewing Method

• Press Ctrl + Shift + I when focused on Cherry Studio client window (Mac: Command + Option + I)

• Cherry Studio client window must be active to open console

• Console must be opened before making requests (test/dialogue) to collect request info

• In console window, click Network → locate last entry marked with red × labeled completions(for dialogue/translation/model check errors) or generations(for image generation errors) → click Response to view full error message (area ④ in image).

If unable to diagnose error, screenshot this interface and share in official community

This method works for dialogue, model testing, knowledge base creation, image generation, etc. Always open console before making requests.

Name (area ② in image) varies by scenario:

Dialogue/Translation/Model Check: completions Image Generation: generations Knowledge Base Creation: embeddings

---

Formula Not Rendering/Formula Rendering Error

• If formula code displays instead of rendering, check delimiters:

Delimiter Usage Inline Formulas

• Single dollar sign: $formula$

• Or \(formula\)

Formula Blocks

• Double dollar sign: $$formula$$

• Or \[formula\]

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

• For rendering errors/garbled text (common with Chinese in formulas), try switching rendering engine to KateX.

---

Unable to Create Knowledge Base/"Failed to Get Embedding Dimensions"

1. Model unavailable

Verify provider supports the model and check service status.

1. Used non-embedding model

---

Model Cannot Recognize Images/Unable to Upload/Select Images

First confirm if the model supports image recognition. Hot models in Cherry Studio are categorized - models with an eye icon after the name support image recognition.

Image-capable models support file uploads. If model features aren't matched correctly:

• Go to provider's model list

• Click settings icon next to model name

• Enable image option

Check model details on provider's page. Vision-incompatible models won't benefit from enabling image options.