> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/russian/question-contact/questions.md).

# Часто задаваемые вопросы

## Распространённые коды ошибок

* **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>: превышен объём данных; часто встречается у визуальных моделей. Если размер изображения превышает верхний предел трафика для одного запроса на стороне upstream, возвращается этот код ошибки;<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 (например: null; требуется строка, но вместо неё указано число или логическое значение и т. п.).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **429**    | Превышен лимит частоты запросов                                                                                                                                                | Частота запросов (TPM или RPM) достигла лимита, подождите немного и попробуйте снова                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **500**    | Внутренняя ошибка сервера, запрос не может быть выполнен                                                                                                                       | Если ошибка повторяется, свяжитесь с upstream-провайдером                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **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:синий;">`Network`</mark> → нажмите, чтобы посмотреть последний элемент в пункте ②, помеченный красным <mark style="color:красный;">`×`</mark> из <mark style="color:красный;">`completions`</mark>*(при ошибках в диалогах, переводе, проверке связи с моделью и т. п.)* или <mark style="color:красный;">`generations`</mark>*(при ошибках в рисовании)* → нажмите<mark style="color:синий;">`Response`</mark>Просмотрите полный ответ (область ④ на рисунке).

> Если вы не можете определить причину ошибки, отправьте скриншот этого окна в [официальную группу поддержки](https://t.me/CherryStudioAI) и попросите помощи.

<figure><img src="/files/e1bfde10b4e8b1324ead7d3f4ae5b9afb7ce30c1" alt="" width="563"><figcaption></figcaption></figure>

Этот способ проверки позволяет получать информацию об ошибках не только в диалогах, но и при тестировании модели, добавлении базы знаний, рисовании и т. д. В любом случае сначала нужно открыть окно отладки, а затем выполнить запрос, чтобы получить информацию о нём.·

{% hint style="info" %}
В разных сценариях название в поле Name (пункт ② на изображении выше) будет отличаться

Диалог, перевод, проверка модели:<mark style="color:красный;">`completions`</mark>

Рисование:<mark style="color:красный;">`generations`</mark>

Создание базы знаний:<mark style="color:красный;">`embeddings`</mark>
{% endhint %}

***

## Формула не отрендерилась / ошибка рендеринга формулы

* Если формула не отрендерилась, а вместо неё прямо показывается код формулы, проверьте, есть ли у формулы ограничители

> **Использование ограничителей**
>
> *Встроенная формула*
>
> * Используйте один знак доллара: `$formula$`
> * или используйте`\(` и `\)`, например:`\(formula\)`
>
> *Отдельный блок формулы*
>
> * Используйте двойной знак доллара: `$$formula$$`
> * или используйте `\[formula\]`
> * Пример: `$$\sum_{i=1}^n x_i$$`\
>   $$\sum\_{i=1}^n x\_i$$

* Ошибка рендеринга формулы / нечитаемые символы. Часто возникает, когда в формуле есть китайский текст; попробуйте переключить движок формул на KateX.

***

## Не удаётся создать базу знаний / сообщение: не удалось получить размерность embeddings

1. Состояние модели недоступно

> Проверьте, поддерживает ли провайдер эту модель, или убедитесь, что сервис этой модели у провайдера работает нормально.

2\. Используется не-embedding модель

***

## Модель не может распознавать изображения / не удаётся загрузить или выбрать изображение

Сначала нужно убедиться, поддерживает ли модель распознавание изображений. Cherry Studio классифицирует популярные модели; если после названия модели стоит значок глаза, значит распознавание изображений поддерживается.

Модели с поддержкой изображений позволяют загружать графические файлы. Если функция модели определена неверно, найдите эту модель в списке моделей соответствующего провайдера, нажмите кнопку настроек после её названия и отметьте опцию изображения.

Подробную информацию о модели можно посмотреть у соответствующего провайдера. Как и в случае с embedding-моделями, для моделей без поддержки зрения не нужно принудительно включать функцию изображений — даже если отметить опцию изображения, это не даст эффекта.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/russian/question-contact/questions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
