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

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

• 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.

---

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

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

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

2. Используется неэмбеддинговая модель

---

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

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

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

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