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

Частые коды ошибок

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

• 5xx (коды состояния ошибок сервера)：Обычно связаны с ошибками на стороне сервера, например падение сервера, превышение времени обработки запроса и т.п.

Код ошибки	Возможная причина	Способ решения
400	Ошибки формата тела запроса и т.п.	Просмотрите содержимое ошибки в ответе на диалог или в консоли</a> посмотрите содержание ошибки и действуйте согласно подсказкам. 【Типичная ситуация 1】：Если это модель gemini, возможно потребуется привязка карты; 【Типичная ситуация 2】：Объём данных превышает допустимый предел, часто встречается в визуальных моделях — если размер изображения превышает верхний лимит трафика для одного запроса, вернётся этот код ошибки; 【Типичная ситуация 3】：Добавлены неподдерживаемые параметры или параметры заполнены неверно. Попробуйте создать чистого ассистента и проверить, работает ли он; 【Типичная ситуация 4】：Контекст превышает ограничение — очистите контекст, создайте новый диалог или уменьшите количество контекстных записей.
401	Ошибка аутентификации: модель не поддерживается или аккаунт на стороне сервера заблокирован и т.п.	Свяжитесь с поставщиком услуг или проверьте состояние аккаунта соответствующего сервиса
403	Нет прав на выполнение запрошенной операции	Действуйте в соответствии с информацией об ошибке, возвращённой в диалоге, иликонсольюи выполните соответствующие действия по подсказкам ошибки
404	Не удалось найти запрашиваемый ресурс	Проверьте путь запроса и т.п.
422	Формат запроса корректен, но есть семантическая ошибка	Такие ошибки сервер может разобрать, но обработать не может. Часто встречаются семантические ошибки JSON (например: пустые значения; ожидается строка, но указано число или булево значение и т.п.).
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.

---

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

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

Убедитесь, поддерживает ли поставщик эту модель или что служба модели у поставщика работает нормально.

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

---

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

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

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

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