Preguntas frecuentes

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

Preguntas frecuentes

Códigos de error comunes

• 4xx (códigos de estado de error del cliente): Generalmente son solicitudes imposibles de completar debido a errores de sintaxis, fallos de autenticación o autorización.

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

Código de error	Posibles escenarios	Solución
400	Cuerpo de solicitud con formato incorrecto	Consulte el contenido del error devuelto por el diálogo o revise la información en la consola, y actúe según las indicaciones. 【Escenario común 1】: Para modelos Gemini, puede ser necesario vincular una tarjeta de crédito; 【Escenario común 2】: Volumen de datos excedido, común en modelos de visión cuando las imágenes superan el límite de tráfico por solicitud; 【Escenario común 3】: Parámetros no compatibles o mal configurados. Intente crear un nuevo asistente limpio para verificar; 【Escenario común 4】: Contexto excede el límite, borre el contexto, inicie un nuevo diálogo o reduzca el número de mensajes contextuales.
401	Error de autenticación: modelo no compatible o cuenta suspendida	Contacte al proveedor de servicios o verifique el estado de la cuenta
403	Sin permisos para realizar la operación	Siga las indicaciones del mensaje de error o consulte errores en la consola
404	Recurso solicitado no encontrado	Verifique la ruta de solicitud
422	Formato correcto pero error semántico	Errores comunes en valores JSON (ej: valor nulo; se esperaba texto pero se ingresó número/booleano)
429	Límite de solicitudes alcanzado	Tasa de solicitudes (TPM/RPM) excedida, espere antes de reintentar
500	Error interno del servidor	Contacte al proveedor si persiste
501	Función no implementada por el servidor
502	Respuesta inválida desde servidor remoto al actuar como proxy
503	Servicio no disponible temporalmente por sobrecarga o mantenimiento	El tiempo de espera puede especificarse en la cabecera Retry-After
504	Tiempo de espera excedido al obtener respuesta desde servidor remoto

---

Método para ver errores en consola

• Presione Ctrl + Shift + I (Mac: Command + Option + I) con Cherry Studio activo

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

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

• En la consola: Click en Network → Seleccione el último completions (errores en diálogos/traducciones) o generations (errores en imágenes) marcado con × rojo → Ver contenido completo en Response.

Si no puede determinar la causa, capture esta pantalla y envíela al grupo oficial.

Este método funciona también en pruebas de modelos, creación de bases de conocimiento, generación de imágenes, etc. Siempre debe abrirse la consola primero.

Nombres comunes en diferentes escenarios:

Diálogos/Traducciones/Pruebas: completions Generación de imágenes: generations Creación de bases de conocimiento: embeddings

---

Fórmulas no renderizadas/errores en fórmulas

• Si se muestra código sin renderizar, verifique los delimitadores:

Uso de delimitadores Fórmulas en línea

• Un signo de dólar: $formula$

• O \(formula\)

Bloques de fórmulas

• Doble signo de dólar: $$formula$$

• O \[formula\]

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

• Errores/desorden al contener chino: Cambie el motor de renderizado a KaTeX.

---

No se puede crear base de conocimiento/error dimensiones embedding

1. Modelo no disponible

Verifique compatibilidad y estado con el proveedor.

1. Uso de modelo no embedding

---

Modelo no reconoce imágenes/no permite subir imágenes

Primero verifique si el modelo admite reconocimiento visual: Los modelos compatibles tienen ícono de ojo 🔍 junto al nombre.

Si la función no está habilitada:

• En la lista de modelos del proveedor, haga clic en ⚙️ junto al modelo

• Marque la opción "Imagen"

Los modelos sin capacidad visual no procesarán imágenes aunque esté marcada la opción. Consulte información técnica específica del modelo con su proveedor.