# Часто задаваемые вопросы ## Распространённые коды ошибок * **4xx (коды ошибок клиента)**: обычно это ошибки синтаксиса запроса, сбой авторизации или аутентификации и т. п., из-за которых запрос не может быть выполнен. * **5xx (коды ошибок сервера)**: обычно это ошибка на стороне сервера, сбой сервера, тайм-аут обработки запроса и т. п. | Код ошибки | Возможная ситуация | Способ решения | | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **400** | Ошибочный формат тела запроса и т. п. |

Посмотрите текст ошибки, возвращённый диалогом, или консоль\

【Случай 1】: если это модель gemini, может потребоваться привязка карты;
【Случай 2】: превышен объём данных; часто встречается у визуальных моделей, когда размер изображения превышает верхний предел трафика одного запроса на стороне upstream, возвращается этот код ошибки;
【Случай 3】: добавлен неподдерживаемый параметр или параметр заполнен неверно. Попробуйте создать нового «чистого» ассистента, чтобы проверить, всё ли работает;
【Случай 4】:контекст превысил ограничение; очистите контекст, создайте новый диалог или уменьшите число сообщений в контексте.

| | **401** | Сбой аутентификации: модель не поддерживается или аккаунт на стороне сервера заблокирован и т. п. | Свяжитесь с соответствующим провайдером или проверьте статус его аккаунта | | **403** | Нет прав на выполнение запроса | Согласно сообщению об ошибке, возвращённому диалогом, или[консоль](#kong-zhi-tai-bao-cuo-cha-kan-fang-fa)выполните соответствующие действия согласно подсказке об ошибке | | **404** | Не удаётся найти запрошенный ресурс | Проверьте путь запроса и т. п. | | **422** | Формат запроса корректен, но семантически неверен | Такие ошибки сервер может разобрать, но не может обработать. Часто встречается при семантических ошибках JSON (например: null; когда требуется строка, но вместо неё указано число или boolean и т. п.). | | **429** | Превышена допустимая скорость запросов | Скорость запросов (TPM или RPM) достигла предела, подождите немного и попробуйте снова | | **500** | Внутренняя ошибка сервера, не удалось выполнить запрос | Если это повторяется, свяжитесь с upstream-провайдером | | **501** | Сервер не поддерживает запрошенную функцию, не удалось выполнить запрос | | | **502** | Сервер, работающий как шлюз или прокси, получил недействительный ответ от удалённого сервера при попытке выполнить запрос | | | **503** | Из-за перегрузки или технического обслуживания сервер временно не может обработать запрос клиента. Длительность задержки может быть указана в заголовке Retry-After сервера | | | **504** | Сервер, выступающий в роли шлюза или прокси, не получил запрос вовремя от удалённого сервера | | *** ## Способ просмотра ошибок в консоли * Нажмите на окно клиента Cherry Studio, затем нажмите сочетание клавиш на Ctrl + на Shift + I(на Mac:Command + Option + I） {% hint style="info" %} * Чтобы открыть консоль, активным должно быть окно клиента Cherry Studio; * Сначала нужно открыть консоль, а затем нажать тест или инициировать запрос, например начать диалог, чтобы собрать информацию о запросе. {% endhint %} - В открывшемся окне консоли нажмите `Network` → нажмите, чтобы посмотреть последний элемент с красным `×` в пункте ② `completions`*(когда возникает ошибка в диалогах, переводе, проверке связности модели и т. п.)* или `generations`*(когда возникает ошибка при рисовании)* → нажми`Response`посмотреть полное содержимое ответа (область ④ на рисунке). > Если вы не можете определить причину ошибки, сделайте скриншот этого экрана и отправьте его в [официальную группу](https://t.me/CherryStudioAI) за помощью.
Этот способ проверки позволяет получать информацию об ошибках не только в диалоге, но и при тестировании модели, добавлении базы знаний, рисовании и т. д. В любой ситуации сначала нужно открыть окно отладки, а затем выполнить запрос, чтобы получить информацию о запросе.· {% hint style="info" %} Название в поле Name (пункт ② на изображении выше) может различаться в разных сценариях Диалог, перевод, проверка модели:`completions` Рисование:`generations` Создание базы знаний:`embeddings` {% endhint %} *** ## Формула не отрендерилась / ошибка рендеринга формулы * Если формула не была отрендерена, а вместо этого показывается её код, проверьте, есть ли у формулы ограничители > **Использование ограничителей** > > *Встроенная формула* > > * Используйте один символ доллара: `$formula$` > * или используйте`\(` и `\)`, например:`\(formula\)` > > *Отдельный блок формулы* > > * Используйте двойной символ доллара: `$$formula$$` > * или используйте `\[formula\]` > * Пример: `$$\sum_{i=1}^n x_i$$`\ > $$\sum\_{i=1}^n x\_i$$ * Ошибка рендеринга формулы / кракозябры. Часто возникает, когда в формуле есть китайский текст; попробуйте переключить движок формул на KateX. *** ## Не удаётся создать базу знаний / сообщение о том, что не удалось получить размерность эмбеддинга 1. Статус модели недоступен > Убедитесь, поддерживает ли провайдер эту модель, или проверьте, нормально ли работает сервис этой модели у провайдера. 2\. Используется не эмбеддинг-модель *** ## Модель не умеет распознавать изображения / не удаётся загрузить или выбрать изображение Сначала нужно проверить, поддерживает ли модель распознавание изображений; в Cherry Studio популярные модели классифицируются, и модели со значком маленького глаза после названия поддерживают распознавание изображений. Модели с распознаванием изображений поддерживают загрузку графических файлов. Если функция модели сопоставлена неверно, найдите эту модель в списке моделей соответствующего провайдера, нажмите кнопку настроек после её названия и отметьте опцию изображения. Подробную информацию о модели можно посмотреть у соответствующего провайдера. Как и в случае с embedding-моделями, для моделей без поддержки зрения не нужно принудительно включать функцию изображения; даже если отметить опцию изображения, это не даст эффекта. --- # 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/docs/russian/question-contact/questions.md?ask= ``` 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.