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

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

• 4xx (коды ошибок клиента): обычно это ошибки синтаксиса запроса, сбой авторизации или аутентификации и т. п., из-за которых запрос не может быть выполнен.

• 5xx (коды ошибок сервера): обычно это ошибка на стороне сервера, сбой сервера, тайм-аут обработки запроса и т. п.

Код ошибки	Возможная ситуация	Способ решения
400	Ошибочный формат тела запроса и т. п.	Посмотрите текст ошибки, возвращённый диалогом, или консоль</a, чтобы увидеть сообщение об ошибке, и действуйте согласно подсказке. 【Случай 1】: если это модель gemini, может потребоваться привязка карты; 【Случай 2】: превышен объём данных; часто встречается у визуальных моделей, когда размер изображения превышает верхний предел трафика одного запроса на стороне upstream, возвращается этот код ошибки; 【Случай 3】: добавлен неподдерживаемый параметр или параметр заполнен неверно. Попробуйте создать нового «чистого» ассистента, чтобы проверить, всё ли работает; 【Случай 4】:контекст превысил ограничение; очистите контекст, создайте новый диалог или уменьшите число сообщений в контексте.
401	Сбой аутентификации: модель не поддерживается или аккаунт на стороне сервера заблокирован и т. п.	Свяжитесь с соответствующим провайдером или проверьте статус его аккаунта
403	Нет прав на выполнение запроса	Согласно сообщению об ошибке, возвращённому диалогом, иликонсольвыполните соответствующие действия согласно подсказке об ошибке
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）

• Чтобы открыть консоль, активным должно быть окно клиента Cherry Studio;

• Сначала нужно открыть консоль, а затем нажать тест или инициировать запрос, например начать диалог, чтобы собрать информацию о запросе.

• В открывшемся окне консоли нажмите 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. Используется не эмбеддинг-модель

---

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

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

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

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