Errores y solución de problemas

Soporta Linux, macOS y Windows, requiere Node.js 18+ y un navegador moderno. Todo el procesamiento de IA se realiza en la API de la nube, por lo que no importa cuán común sea la configuración de la máquina local, no se retrasará y las tarjetas gráficas de alto rendimiento son completamente inutilizables.

Solo una clave API de Agnes AI. Regístrate en el sitio web oficial de Agnes AI (agnes-ai.com) y puedes obtenerlo de forma gratuita. Puedes usarlo para la generación de texto, imágenes, videos y síntesis de voz. Todas las habilidades provienen del modelo gratuito de Agnes AI, sin configuración adicional.

Apoyo. El modo de video largo del manuscrito está diseñado para el procesamiento por lotes: ingrese un artículo largo, dividirlo automáticamente en varios párrafos, generar videos párrafo por párrafo y luego agregar narración y subtítulos de manera uniforme.

Hay un punto de interrupción para continuar. Si la tarea de generación se interrumpe (desconexión, reinicio, etc.), el reinicio se ejecutará automáticamente desde el punto de control exitoso anterior y el progreso no se perderá. La mayoría de los fallos se deben a factores transitorios como fluctuaciones del servicio del modelo, tiempos de espera de red o limitación de tasa. Haz clic primero en «Reintentar tarea» en el panel de fallos: la tarea se reanuda desde el paso fallido (con puntos de control) y normalmente se recupera sola.

La mayoría de los fallos se deben a factores transitorios como fluctuaciones del servicio del modelo, tiempos de espera de red o limitación de tasa. Haz clic primero en «Reintentar tarea» en el panel de fallos de la aplicación: la tarea se reanuda desde el paso fallido y normalmente se recupera sola, sin volver a enviarla. Si sigue fallando tras varios intentos (≥ 2), el área de comentarios se despliega automáticamente: copia la información de diagnóstico con un clic y salta a un Issue de GitHub pre-rellenado, sin describir tu entorno manualmente.

Agnes mantiene una cola de inferencia gratuita compartida para modelos de vídeo como Video 2.5 Flash, y puede permanecer saturada más de 10 minutos en horas punta. Cuando está llena, cada envío se rechaza con HTTP 503 · video_queue_full y el mensaje original «video queue is full, please retry later (request id: …)». No se crea ninguna tarea, no se consume cuota y no se pierde nada: es una cuestión de capacidad del lado de Agnes, no un problema con tu prompt o tu configuración. Desde la v7.0, un rechazo por cola llena ya no cuenta contra el presupuesto normal de reintentos: pasa a una vía de reintento dedicada (hasta 15 intentos por defecto, ajustable con AGNES_VIDEO_BUSY_RETRY_ATTEMPTS), el primer intento se lanza de inmediato y los siguientes se espacian 30–60 s. Desde la v7.1, el panel de fallos y el aviso de creación de tarea también sugieren las franjas de menor carga en las que el upstream suele ir más fluido, mostradas en tu hora local. Para evitar los errores Agnes 503: reintenta en horas de menor carga, cambia a otro modelo de vídeo (Video 2.0 usa una cola distinta y a menudo sigue aceptando tareas) o añade más claves API: cada clave tiene su propia cuota. Una nota más del proveedor: el sitio Agnes China exige verificación de identidad desde el 2026-10-26 12:00 (UTC+8) — las cuentas sin verificar tendrán una frecuencia de llamadas a la API menor — y el upstream espera que los errores de saturación como 503 y «queue is full» mejoren notablemente a partir de esa fecha.

Una respuesta 401 Unauthorized o «token no válido» normalmente significa que la clave API no coincide con el dominio al que se envía — por ejemplo, una clave emitida en el sitio global usada contra el endpoint nacional chino api.agnes-ai.cn (o al revés). Las claves emitidas para sitios diferentes se rechazan cuando se envían al dominio equivocado. Desde la v6.4.2, cada clave puede vincularse a su propio dominio de acceso, y el botón de un clic «Detectar dominios automáticamente» prueba cada clave contra com / cn / cn_bak y rellena automáticamente el dominio coincidente. En el panel de claves API, elige el dominio que coincida con tu clave, o simplemente ejecuta la detección automática. Las claves del sitio global deben usar apihub.agnes-ai.com, o el dominio de respaldo cn_bak (apihub.agnes-ai.cn, que acepta claves nacionales y globales).

Los comentarios están disponibles tanto en la aplicación como en GitHub. Cuando una tarea falla en la app, el panel de fallos ofrece los botones «Copiar información de diagnóstico» y «Abrir un Issue en GitHub», adjuntando automáticamente la versión de la aplicación, el tipo de tarea, el paso fallido, el mensaje de error y el número de reintentos para que los mantenedores localicen el problema rápidamente. También puedes visitar la página de GitHub Issues (github.com/lcy362/agnes-video-generator/issues) para consultar informes existentes o abrir uno nuevo.