Erreurs & dépannage

Prend en charge Linux, macOS et Windows, nécessite Node.js 18+ et un navigateur moderne. Tout le traitement de l'IA est effectué dans l'API cloud, de sorte que peu importe à quel point la configuration de la machine locale est ordinaire, elle ne sera pas retardée et les cartes graphiques hautes performances sont complètement inutilisables.

Juste une clé API d'Agnes AI. Vous pouvez l'obtenir gratuitement en vous inscrivant sur le site officiel d'Agnes AI (agnes-ai.com). Vous pouvez l'utiliser pour la génération de texte, d'images, de vidéos et de synthèse vocale. Toutes les capacités proviennent du modèle gratuit Agnes AI, sans configuration supplémentaire.

soutien. Le mode vidéo longue du manuscrit est conçu pour le traitement par lots: jetez un long article, divisez-le automatiquement en plusieurs paragraphes, générez une vidéo paragraphe par paragraphe, puis ajoutez une narration et des sous-titres de manière uniforme.

Il y a un point d'interruption pour reprendre. Si la tâche générée est interrompue (déconnexion du réseau, redémarrage, etc.), le redémarrage continuera automatiquement à partir du dernier point de contrôle réussi et les progrès ne seront pas perdus. La plupart des échecs proviennent de facteurs passagers : fluctuations du service de modèle, dépassements de délai réseau ou limitation de débit. Cliquez d'abord sur « Réessayer la tâche » dans le panneau d'échec — la tâche reprend à l'étape en échec (avec points de contrôle) et se rétablit généralement d'elle-même.

La plupart des échecs proviennent de facteurs passagers : fluctuations du service de modèle, dépassements de délai réseau ou limitation de débit. Cliquez d'abord sur « Réessayer la tâche » dans le panneau d'échec de l'application — la tâche reprend à l'étape en échec et se rétablit généralement d'elle-même, sans nouvel envoi. Si l'échec persiste après plusieurs tentatives (≥ 2), la zone de retour d'expérience s'ouvre automatiquement : copiez les informations de diagnostic en un clic et accédez à un Issue GitHub pré-rempli, sans décrire votre environnement manuellement.

Agnes gère une file d'inférence gratuite partagée pour les modèles vidéo comme Video 2.5 Flash, et cette file peut rester saturée plus de 10 minutes aux heures de pointe. Lorsqu'elle est pleine, chaque soumission est rejetée avec HTTP 503 · video_queue_full et le message brut « video queue is full, please retry later (request id: …) ». Aucune tâche n'est créée, aucun quota n'est consommé et rien n'est perdu — c'est une question de capacité côté Agnes, pas un problème lié à votre prompt ou à votre configuration. Depuis la v7.0, un rejet pour file pleine ne pèse plus sur le budget de nouvelle tentative normal : il bascule vers une file de nouvelle tentative dédiée (jusqu'à 15 tentatives par défaut, réglable via AGNES_VIDEO_BUSY_RETRY_ATTEMPTS), la première tentative se déclenche immédiatement et les suivantes sont espacées de 30 à 60 s. Depuis la v7.1, le panneau d'échec et la notification de création de tâche suggèrent aussi les créneaux hors pointe où l'amont est historiquement plus fluide, affichés dans votre heure locale. Pour éviter les erreurs Agnes 503 : réessayez aux heures creuses, passez à un autre modèle vidéo (Video 2.0 utilise une file distincte et accepte souvent encore les tâches) ou ajoutez davantage de clés API — chaque clé dispose de son propre quota. Une précision de l’amont : le site Agnes Chine impose une vérification d’identité à partir du 2026-10-26 12:00 (UTC+8) — les comptes non vérifiés voient leur débit d’appels API réduit — et l’amont s’attend à une nette amélioration des erreurs de saturation telles que 503 et « queue is full » après cette date.

Une réponse 401 Unauthorized ou « jeton invalide » signifie généralement que la clé API ne correspond pas au domaine auquel elle est envoyée — par exemple, une clé émise sur le site mondial utilisée contre l'endpoint national chinois api.agnes-ai.cn (ou l'inverse). Les clés émises pour des sites différents sont rejetées si elles sont envoyées au mauvais domaine. Depuis la v6.4.2, chaque clé peut être liée à son propre domaine d'accès, et le bouton « Détection automatique des domaines » en un clic teste chaque clé sur com / cn / cn_bak et renseigne automatiquement le domaine correspondant. Dans le panneau des clés API, choisissez le domaine correspondant à votre clé, ou lancez simplement la détection automatique. Les clés du site mondial doivent utiliser apihub.agnes-ai.com, ou le domaine de secours cn_bak (apihub.agnes-ai.cn, qui accepte les clés nationales et mondiales).

Le retour d'expérience est disponible dans l'application et sur GitHub. Lorsqu'une tâche échoue dans l'application, le panneau d'échec propose les boutons « Copier les informations de diagnostic » et « Ouvrir un Issue GitHub », en joignant automatiquement la version de l'application, le type de tâche, l'étape en échec, le message d'erreur et le nombre de tentatives pour aider les mainteneurs à cerner rapidement le problème. Vous pouvez aussi consulter la page GitHub Issues (github.com/lcy362/agnes-video-generator/issues) pour voir les signalements existants ou en ouvrir un nouveau.