Errori e risoluzione dei problemi

Supporta Linux, macOS e Windows, richiede Node.js 18+ e un browser moderno. Tutta l'elaborazione dell'intelligenza artificiale viene completata tramite l'API cloud, quindi non importa quanto sia ordinaria la configurazione della macchina locale, non sarà ostacolata e le schede grafiche ad alte prestazioni sono completamente inutilizzabili.

Basta una chiave API di Agnes AI. Registrati sul sito ufficiale di Agnes AI (agnes-ai.com) e puoi ottenerlo gratuitamente. Puoi utilizzarlo per la generazione di testo, immagini, video e sintesi vocale. Tutte le capacità provengono dal modello gratuito Agnes AI, senza configurazione aggiuntiva.

Supporto. La modalità video lungo del manoscritto è progettata per l'elaborazione batch: inserisci un articolo lungo, dividi automaticamente in più paragrafi, genera video paragrafo per paragrafo e poi aggiungi narrazione e sottotitoli in modo uniforme.

Ci sono punti di interruzione per continuare. Se l'attività di generazione viene interrotta (disconnessione, riavvio, ecc.), il riavvio verrà eseguito automaticamente dall'ultimo punto di controllo riuscito e i progressi non verranno persi. La maggior parte dei guasti è causata da fattori temporanei come fluttuazioni del servizio del modello, timeout di rete o limitazione della frequenza. Fai prima clic su "Riprova attività" nel pannello dei guasti: l'attività riprende dal passo fallito (basato su checkpoint) e di solito si riprende da sola.

La maggior parte dei guasti è causata da fattori temporanei come fluttuazioni del servizio del modello, timeout di rete o limitazione della frequenza. Fai prima clic su "Riprova attività" nel pannello dei guasti dell'app: l'attività riprende dal passo fallito e di solito si riprende da sola, senza inviare di nuovo. Se fallisce ancora dopo diversi tentativi (≥ 2), l'area di feedback si apre automaticamente: copia le informazioni diagnostiche con un clic e vai a una Issue GitHub precompilata, senza descrivere manualmente l'ambiente.

Agnes gestisce una coda di inferenza gratuita condivisa per modelli video come Video 2.5 Flash, e nelle ore di punta può restare satura per oltre 10 minuti. Quando è piena, ogni invio viene rifiutato con HTTP 503 · video_queue_full e il messaggio originale "video queue is full, please retry later (request id: …)". Nessuna attività viene creata, nessuna quota viene consumata e non si perde nulla: è una questione di capacità lato Agnes, non un problema del tuo prompt o della tua configurazione. Dalla v7.0 un rifiuto per coda piena non pesa più sul budget normale di tentativi: passa a una corsia di tentativi dedicata (fino a 15 tentativi per impostazione predefinita, regolabile con AGNES_VIDEO_BUSY_RETRY_ATTEMPTS), il primo tentativo parte subito e i successivi sono distanziati di 30–60 s. Dalla v7.1 il pannello degli errori e l'avviso di creazione dell'attività suggeriscono anche le fasce di minore affluenza in cui l'upstream è storicamente più fluido, mostrate nel tuo orario locale. Per evitare gli errori Agnes 503: riprova nelle ore di minore affluenza, passa a un altro modello video (Video 2.0 usa una coda separata e spesso accetta ancora le attività) o aggiungi più chiavi API: ogni chiave ha la propria quota. Un'ulteriore nota del provider: il sito Agnes Cina richiede la verifica dell'identità dal 2026-10-26 12:00 (UTC+8) — gli account non verificati avranno una frequenza di chiamate API ridotta — e l'upstream prevede che gli errori di sovraccarico come 503 e "queue is full" migliorino sensibilmente dopo quella data.

Una risposta 401 Unauthorized o "token non valido" di solito significa che la chiave API non corrisponde al dominio a cui viene inviata — ad esempio, una chiave emessa sul sito globale usata contro l'endpoint nazionale cinese api.agnes-ai.cn (o viceversa). Le chiavi emesse per siti diversi vengono rifiutate se inviate al dominio sbagliato. Dalla v6.4.2, ogni chiave può essere associata al proprio dominio di accesso, e il pulsante con un clic "Rilevamento automatico domini" verifica ogni chiave su com / cn / cn_bak e compila automaticamente il dominio corrispondente. Nel pannello delle chiavi API, scegli il dominio corrispondente alla tua chiave, oppure esegui semplicemente il rilevamento automatico. Le chiavi del sito globale devono usare apihub.agnes-ai.com, oppure il dominio di fallback cn_bak (apihub.agnes-ai.cn, che accetta sia chiavi nazionali sia globali).

Il feedback è disponibile sia nell'app sia su GitHub. Quando un'attività fallisce nell'app, il pannello dei guasti offre i pulsanti "Copia info diagnostiche" e "Apri una Issue su GitHub", allegando automaticamente versione dell'app, tipo di attività, passo fallito, messaggio d'errore e numero di tentativi, per aiutare i manutentori a individuare rapidamente il problema. Puoi anche visitare la pagina GitHub Issues (github.com/lcy362/agnes-video-generator/issues) per consultare le segnalazioni esistenti o aprirne una nuova.