Domande frequenti sul workflow Jimeng (incluso come gestire Agnes 503 / queue is full)

Cosa fare quando Agnes restituisce HTTP 503 o video queue is full? Conviene aspettare? Si può prendere un’altra strada? E le domande più frequenti durante l’uso del workflow Jimeng.

Questa pagina risponde prima allo step su cui la maggior parte delle persone si blocca davvero — la coda del provider — e poi ai dettagli del workflow Jimeng stesso. Ogni punto è un’azione applicabile subito.

L’ordine di azione davanti a un 503 / queue is full

Prova in questo ordine: nella grande maggioranza dei casi avrai un video in tre passi:

  1. 1

    Identifica che tipo di rifiuto è

    Il pannello dovrebbe mostrare una causa chiara: video_queue_full (coda piena), un 503 nudo (provider sovraccarico) o model_not_found (nessun canale disponibile per quel modello). I primi due si risolvono aspettando; l’ultimo richiede di cambiare modello.

  2. 2

    Riprova fuori punta

    La coda gratuita è più affollata nelle ore di punta. Lascia che l’app ritenti in coda (circa 15 minuti per impostazione predefinita) oppure fai altro e clicca «Riprova task» in un momento libero per riprendere dallo step fallito.

  3. 3

    Riduci il carico per esecuzione

    Meno scene, segmenti più brevi e risoluzione più bassa riducono occupazione e attesa; esegui un task alla volta per evitare che più task si contendano la quota di invio.

  4. 4

    Cambia modello video

    Le code sono separate per modello, quindi passare a un altro modello gratuito spesso dà subito un posto; attenzione: i modelli vecchi rimossi dal gateway restituiscono sempre model_not_found.

  5. 5

    Cambia strada: il workflow Jimeng

    Se non vuoi aspettare, fai generare l’immagine a Jimeng e lascia che questo progetto faccia solo storyboard, sottotitoli e montaggio. Vedi la guida al workflow Jimeng collegata in questa pagina.

Leggi la guida al workflow Jimeng →

Prima la conclusione: il 503 non è colpa tua

Perché compare HTTP 503 o «video queue is full» (coda piena) durante la generazione di un video?
La coda video gratuita di Agnes è satura (le code sono separate per modello) e il gateway rifiuta la richiesta prima che entri in coda. **Non** è un problema del tuo prompt, delle impostazioni o della Key. Se viene rifiutata non nasce nessun task e non viene consumata quota, quindi puoi riprovare tranquillamente. Nelle ore di punta dura dieci minuti e più, ed è per questo che si ripete. 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.
Agnes restituisce 503 di continuo: l’app ritenta da sola, e per quanto tempo?
Sì. Ogni 503 (anche un 503 «nudo» senza codice di errore) viene normalizzato in un segnale «occupato» e ritentato su una corsia separata: il primo tentativo è immediato, poi torna in coda a intervalli fissi, per un massimo di 15 volte per impostazione predefinita (regolabile con la variabile d’ambiente AGNES_VIDEO_BUSY_RETRY_ATTEMPTS). Il pannello di avanzamento mostra in tempo reale «Coda video Agnes piena (HTTP 503 · video_queue_full), in attesa di un nuovo tentativo (tentativo N / X minuti trascorsi)» e conserva l’errore originale del provider.
Anche ritentando non ottengo un posto: devo aspettare all’infinito?
No. Una coda satura è una questione di orari: riprova fuori punta o più tardi; nello stesso momento puoi ridurre il carico (meno scene, durate più brevi) o cambiare modello video (le code sono separate per modello). Se ti serve subito un video, passa al workflow Jimeng: Jimeng genera immagine e audio, mentre questo progetto si occupa di storyboard, sottotitoli e montaggio.
Se un tentativo fallisce o viene interrotto, si perde tutto?
No. «Riprova task» riprende dallo step fallito: gli storyboard e le immagini di riferimento già generati restano, non vengono reinviati né consumati due volte. Nella modalità materiali esterni restano anche le clip già importate, basta completare i segmenti mancanti.
503 e 401 sono lo stesso problema?
No. Il 503 è un problema di capacità del provider: aspetta o prendi un’altra strada. Il 401 significa che la Key non corrisponde al dominio a cui ti connetti (la richiesta porta una Key, ma quel sito non l’accetta): serve un’altra Key o va ricollegato il dominio. Entrambi hanno una propria documentazione, non trattarli insieme.
Il workflow Jimeng comporta costi aggiuntivi?
Jimeng stesso distribuisce crediti giornalieri, quindi usa prima quelli gratuiti; decidere se ricaricare quando finiscono spetta a te. Questo progetto resta open source con licenza MIT e gratuito in self-hosting, e passare a Jimeng cambia solo l’origine dello step «generazione video», senza aggiungere costi a questo progetto.
Perché il workflow Jimeng chiede di incollare due volte? Che relazione c’è tra i prompt «storyboard» e «clip video»?
Il prompt del checkpoint storyboard è una «consegna creativa»: dice a Jimeng (o a qualsiasi LLM) come rifinire lo storyboard con vincoli di immagine + audio + durata; il prompt del checkpoint clip video è invece lo script di storyboard già definitivo di questo progetto, numerato segmento per segmento come [Scena i/N · durata], pronto da copiare e incollare. Il primo serve a rifinire, il secondo a eseguire.
Perché nello Studio web non vedo l’opzione «Materiali esterni»?
Esatto. La modalità materiali esterni al momento è solo nella versione desktop self-hosted (v7.6+); lo Studio web e la Demo online usano ancora la modalità automatica. Se vuoi che anche la versione web supporti i materiali esterni, vota in una Issue.

Le opzioni davanti a un 503

Non esiste una sola risposta giusta: scegli in base a ciò che ti serve in quel momento:

FaseModalità automatica / manualeModalità materiali esterni (Jimeng)
Storyboard e promptLi genera questo progettoLi genera questo progetto, più un set di prompt per scena da incollare direttamente in Jimeng
Immagine e audioModelli video Agnes (l’API restituisce spesso 503; solo la voce fuori campo viene dall’edge_tts di questo progetto)Generati da Jimeng (con audio nativo), esportati in mp4 per scena e importati in blocco
SottotitoliAllineati ai timestamp a livello di parola della voce fuori campo (più precisi)Allineamento stimato dalla durata reale di ogni storyboard (può slittare, va verificato al checkpoint sottotitoli)
Montaggio e video finaleMonta questo progettoQuesto progetto normalizza + monta mantenendo la traccia audio originale + incide i sottotitoli

Esistono altri canali gratuiti di generazione video?

Non sarebbe strano, e siamo disposti a integrarli. L’elenco degli strumenti di questo progetto è un registro estensibile: aggiungere uno strumento richiede solo un set di modelli di prompt e indicazioni per la reimportazione, senza toccare il flusso né lo strato di compositing. Se il tuo canale ha audio nativo, durata nativa controllabile o esporta sottotitoli, l’integrazione è ancora più semplice. Apri una Issue su GitHub indicando nome dello strumento, quota gratuita, fasce di durata e se supporta l’audio, e valuteremo l’integrazione.

GitHub Issues →

Pagine correlate

Error & Retry Basis

This page's attribution of HTTP 503 / video queue is full, its retry strategy, and off-peak advice are based on the following upstream behaviour records and implementation source.

  1. Agnes AI Open API — 视频 / 图片生成接口Agnes AI · apihub.agnes-ai.com (2026)

    HTTP 503 and the body error codes (video_queue_full, etc.) are returned by the Agnes Open API gateway; rejection happens before queueing and consumes no render quota.

  2. agnes-video-generator — 开源 AI 视频生成项目lcy362 · GitHub (2026)

    Busy-track classification and attempt caps (all 503s treated as busy, 15 attempts by default, immediate first retry) plus resume logic live in core/api/retry_policy.py and core/api/agnes_video.py.

  3. 即梦 AI (Dreamina):AI 图片与视频创作平台ByteDance · 即梦官网 (2025)

    Jimeng (Dreamina) as the alternative path: its daily credits and video model tiers ground this page's judgement about switching tools.

Perché puoi fidarti

Questo articolo è stato scritto da professionisti in prima linea. Durante la scrittura, ha controllato fonti di prima mano come documenti arXiv, rapporti tecnici dei produttori e Stanford AI Index. Non si basa su conclusioni basate su impressioni soggettive.

S

SandGrid@lcy362

Autore di Agnes Video Generator · Sviluppatore Full-Stack

Sviluppatore indipendente e autore di Agnes Video Generator, uno strumento di generazione di Video AI open source. Il progetto si basa sul modello video completamente gratuito di Agnes AI, con il protocollo MIT open source e ha aiutato oltre 1.000 creatori a produrre video AI a costi zero. Da tempo presto attenzione all'ingegneria e alla divulgazione dei modelli di generazione video e il contenuto dell'articolo deriva dalla pratica in prima linea e dalla ricerca di prima mano.

Vedi su GitHub

Ultimo aggiornamento:2026-08-21

Pronto per iniziare?

“Lascia che l’IA di livello mondiale appartiene a tutti.” – Bruce Yang. Completamente gratuito, nessuna carta di credito o scheda grafica ad alte prestazioni, crea il tuo primo video AI a costi zero. Vuoi usare il modello video gratuito di Agnes AI? Inizia da qui.

Clona il repository GitHub e avvia in 2 minuti