Solución de problemas
Error tras ejecutar una acción automatizada
Sección titulada «Error tras ejecutar una acción automatizada»Despliega el panel de tareas global para ver el error completo.
Las tareas con errores se pueden reintentar normalmente. Si una tarea sigue en ejecución o en cola sin avanzar durante mucho tiempo, usa Forzar reintento.
Lee el mensaje de error concreto y luego revisa las secciones de solución de problemas que aparecen a continuación.
Si no consigues resolver el problema, ponte en contacto con los desarrolladores.
Tiempo de espera agotado
Sección titulada «Tiempo de espera agotado»Normalmente indica que la red es inestable o que el servicio del proveedor no está disponible temporalmente. Prueba a:
- comprobar si la conexión de red es estable;
- volver a intentarlo más tarde;
Error 401
Sección titulada «Error 401»El error puede tener este aspecto:
API returned status 401: {"error":{"message":"Authentication Fails, Your api key: ****u2sd is invalid","type":"authentication_error","param":null,"code":"invalid_request_error"}}Significa que la clave de API no es válida. Comprueba que:
- La clave de API se copió completa y no tiene espacios de más.
- El proveedor y la URL de la API coinciden.
Error 429
Sección titulada «Error 429»Normalmente indica que el proveedor está limitando las solicitudes o que la concurrencia es excesiva. Prueba a:
- reintentar manualmente los elementos que faltan;
- ajustar la configuración del límite de frecuencia (consulta la documentación del proveedor);
- reducir la concurrencia;
- aumentar el intervalo entre solicitudes.
No selecciones de inmediato todos los elementos para volver a procesarlos. Podrías empeorar la situación al provocar más limitaciones por parte del proveedor.
Error 400
Sección titulada «Error 400»Significa que la solicitud a la API no es válida. Puede tener muchas causas, así que examina el contenido del error.
Si el error tiene este aspecto:
API returned status 400: {"error":{"message":"The supported API model names are deepseek-v4-pro or deepseek-v4-flash, but you passed deepseek-v4-pro1111.","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}El identificador del modelo no es válido. Comprueba que:
- El identificador no se escribió mal. Usa el identificador que proporciona el proveedor, no el nombre visible del modelo.
- Es posible que el proveedor haya retirado el modelo por obsoleto. En ese caso, prueba con otro modelo.
Si el error tiene este aspecto:
API returned status 400: {"error":{"message":"Failed to deserialize the JSON body into the target type: messages[0]: unknown variant `image_url`, expected `text` at line 1 column 3061412","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}Es posible que al modelo se le asignara una capacidad incorrecta al configurar el servicio. Por ejemplo:
- a un modelo sin visión se le asignó una tarea relacionada con la visión.
«Expected X translations but got Y»
Sección titulada ««Expected X translations but got Y»»Por ejemplo:
Expected 6 translations but got 7. The AI likely returned malformed content, pleasetry again.Significa que el modelo no devolvió una traducción por cada elemento, como exige el prompt del sistema. Puedes:
- editar la configuración del modelo y aumentar el esfuerzo de razonamiento;
- cambiar a otro modelo;
- volver a intentarlo más tarde con el mismo modelo.
Si esto ocurre con frecuencia, es posible que el modelo no sea adecuado para esta tarea porque no sigue las instrucciones de forma fiable.
La página de selección de proveedor no carga
Sección titulada «La página de selección de proveedor no carga»Es posible que no tengas conexión a la red. Comprueba si el dispositivo puede conectarse al sitio principal de Neko Translator.
Si no puedes resolver el problema de red, usa Añadir manualmente para configurar el proveedor que quieras usar.
No se detectan los bloques de texto o no se extrae el texto original
Sección titulada «No se detectan los bloques de texto o no se extrae el texto original»- Confirma que el idioma de origen esté bien configurado.
- Comprueba que la imagen sea nítida y que el texto no sea demasiado pequeño, no esté inclinado ni tapado y no se confunda con el fondo.
- Prueba con otro servicio de detección.
- La escritura a mano, las onomatopeyas y las fuentes decorativas pueden ser difíciles de reconocer. Añade un bloque de texto manualmente y escribe tú mismo el texto original.
La acción Traducir está desactivada
Sección titulada «La acción Traducir está desactivada»Traducir necesita al menos un bloque de texto con texto original y un modelo configurado con la capacidad Traducir.
Si el texto original está vacío, ejecuta primero Extraer texto o introduce el texto manualmente.
Cómo solucionar un error de traducción
Sección titulada «Cómo solucionar un error de traducción»Comprueba lo siguiente en este orden:
- Comprueba que el bloque de texto cubra la región correcta.
- Comprueba si el texto original extraído es correcto. Si no lo es, vuelve a ejecutar el reconocimiento con un modelo de visión más capaz o introduce el texto original manualmente.
- Prueba a eliminar el resumen de imagen y a traducir de nuevo. Un resumen incorrecto puede confundir al modelo de traducción.
- Prueba con un modelo más capaz.
Nombres de archivo ilegibles al importar un ZIP
Sección titulada «Nombres de archivo ilegibles al importar un ZIP»Si la app te pide que elijas una codificación para los nombres de archivo, selecciona una y comprueba la vista previa de los nombres. Continúa solo cuando los nombres se muestren correctamente y no haya errores de decodificación ni nombres duplicados.
No se puede abrir el espacio de trabajo
Sección titulada «No se puede abrir el espacio de trabajo»Si un espacio de trabajo no se abre, sigue los pasos de solución de problemas que aparecen en la interfaz. Si el problema persiste, contacta con los desarrolladores para obtener ayuda.
Falló la descarga o la importación de un modelo local
Sección titulada «Falló la descarga o la importación de un modelo local»- Comprueba el espacio en disco y el acceso a la red.
- Si falla la importación de un ZIP o la verificación del hash, normalmente significa que el archivo comprimido está incompleto o ha sido manipulado.