Preguntas frecuentes

Este documento ha sido traducido del chino por IA y aún no ha sido revisado.

Códigos de Error Comunes

• 4xx (Códigos de estado de error del cliente): Generalmente indican errores de sintaxis en la solicitud, fallos de autenticación o autorización que impiden completar la petición.

• 5xx (Códigos de estado de error del servidor): Generalmente indican errores del servidor, como caídas del sistema o tiempos de espera agotados.

Código de Error	Posibles Causas	Solución
400	Formato incorrecto del cuerpo de la solicitud, etc.	Verifique el contenido del error en la respuesta del diálogo o consulte la consola para ver los detalles del error y siga las indicaciones. [Caso común 1]: Para modelos Gemini, puede requerir vinculación de tarjeta; [Caso común 2]: Volumen de datos excedido, común en modelos visuales cuando las imágenes superan el límite de tamaño por solicitud; [Caso común 3]: Parámetros no soportados o incorrectos. Pruebe crear un asistente nuevo para verificar; [Caso común 4]: Contexto excedido. Limpie el historial, inicie nuevo diálogo o reduzca la cantidad de mensajes contextuales.
401	Autenticación fallida: modelo no soportado o cuenta del proveedor suspendida, etc.	Contacte al proveedor o verifique el estado de la cuenta
403	Sin permisos para la operación solicitada	Siga las indicaciones del error en la respuesta del diálogo o en los errores de la consola
404	Recurso solicitado no encontrado	Verifique la ruta de la solicitud, etc.
422	Sintaxis correcta pero error semántico	El servidor puede analizar pero no procesar la solicitud. Común en errores semánticos JSON (ej: valores nulos; se esperaba texto pero se ingresó número/booleano).
429	Límite de tasa de solicitudes alcanzado	Tasa de solicitudes (TPM o RPM) excedida. Espere un momento antes de reintentar
500	Error interno del servidor, no se pudo completar la solicitud	Contacte al proveedor si el error persiste
501	Función no implementada en el servidor
502	Respuesta inválida recibida desde servidor remoto al actuar como puerta de enlace
503	Servidor sobrecargado o en mantenimiento (el retraso puede indicarse en Retry-After)
504	Tiempo de espera agotado al obtener respuesta desde servidor remoto

---

Método para Ver Errores en la Consola

• Presione Ctrl + Shift + I (Mac: Command + Option + I) con la ventana de Cherry Studio activa.

• La ventana activa debe ser el cliente de Cherry Studio para abrir la consola;

• Debe abrirse la consola antes de iniciar pruebas o diálogos para capturar la información.

• En la consola, haga clic en Network → Seleccione la última solicitud marcada con × llamada completions_ (errores en diálogos/traducciones) _ o generations_ (errores en generación de imágenes) _ → Haga clic en Response para ver el contenido completo (área ④ en la imagen).

Si no puede determinar la causa del error, envíe una captura de pantalla de esta interfaz al grupo oficial.

Este método funciona para diálogos, pruebas de modelos, creación de bases de conocimiento y generación de imágenes. Siempre abra la consola antes de realizar la solicitud.

Los nombres en la columna Name (② arriba) varían según el escenario:

Diálogos/Traducciones/Pruebas: completions

Generación de imágenes: generations

Creación de base de conocimiento: embeddings

---

Fórmulas no Renderizadas/Errores de Renderizado

• Si se muestra código en lugar de fórmulas, verifique los delimitadores:

Uso de delimitadores

Fórmulas en línea

• Un símbolo de dólar: $fórmula$

• O \( y \): \(fórmula\)

Bloques de fórmulas

• Doble símbolo de dólar: $$fórmula$$

• O \[fórmula\]

• Ejemplo: $$\sum_{i=1}^n x_i$$ $\sum_{i=1}^n x_i$

• Errores de renderizado/caracteres incorrectos: comunes con texto en chino. Cambie el motor de renderizado a KateX.

---

Error al Crear Base de Conocimiento/Fallo al Obtener Dimensión de Embedding

1. Modelo no disponible

Verifique si el proveedor soporta el modelo o su estado operativo.

1. Uso de modelo no apto para embeddings

---

Modelo no Reconoce Imágenes/Error al Subir o Seleccionar Imágenes

Primero confirme si el modelo soporta visión. Cherry Studio identifica modelos con visión con un icono de ojo junto al nombre.

Los modelos con visión permiten subir imágenes. Si la funcionalidad no está habilitada, busque el modelo en el proveedor, haga clic en ⚙ y active la opción de imágenes.

Consulte la información del modelo en el proveedor. Modelos sin capacidad visual no funcionarán aunque se active la opción.