Agnes Video Generator

Perguntas frequentes do fluxo Jimeng (incluindo como tratar Agnes 503 / queue is full)

O que fazer quando o Agnes devolve HTTP 503 ou video queue is full? Vale esperar? Dá para pegar outro caminho? E as perguntas mais comuns ao usar o fluxo Jimeng.

Esta página responde primeiro à etapa em que a maioria realmente trava — a fila do provedor — e depois aos detalhes do próprio fluxo Jimeng. Cada item é uma ação que você pode aplicar na hora.

A ordem de ação diante de um 503 / queue is full

Tente nesta ordem: na grande maioria dos casos você terá um vídeo em três passos:

  1. 1

    Identifique que tipo de rejeição é

    O painel deve mostrar uma causa clara: video_queue_full (fila cheia), um 503 cru (provedor sobrecarregado) ou model_not_found (sem canal disponível para aquele modelo). Os dois primeiros se resolvem esperando; o último exige trocar de modelo.

  2. 2

    Tente de novo fora do pico

    A fila gratuita fica mais cheia nos horários de pico. Deixe o app repetir na fila (cerca de 15 minutos por padrão) ou faça outra coisa e clique em «Repetir tarefa» num horário livre para continuar da etapa que falhou.

  3. 3

    Reduza a carga de cada execução

    Menos cenas, trechos mais curtos e resolução menor reduzem a ocupação e a espera; rode uma tarefa por vez para que várias não disputem a cota de envio.

  4. 4

    Troque o modelo de vídeo

    As filas são separadas por modelo, então mudar para outro modelo gratuito muitas vezes garante vaga na hora; atenção: modelos antigos removidos pelo gateway devolvem sempre model_not_found.

  5. 5

    Pegue outro caminho: o fluxo Jimeng

    Se não quiser esperar, deixe o Jimeng gerar a imagem e este projeto fazer só o storyboard, as legendas e a montagem. Veja o guia do fluxo Jimeng vinculado nesta página.

Ler o guia do fluxo Jimeng →

Primeiro a conclusão: o 503 não é culpa sua

Por que aparece HTTP 503 ou «video queue is full» (fila cheia) ao gerar um vídeo?
A fila gratuita de vídeo do Agnes está saturada (as filas são separadas por modelo) e o gateway rejeita a solicitação antes de entrar na fila. **Não** é problema do seu prompt, configurações ou Key. Quando é rejeitada, nenhuma tarefa é criada e nenhuma cota é consumida, então pode tentar de novo sem preocupação. Nos horários de pico isso dura dez minutos ou mais — por isso se repete. Uma nota do provedor: o site Agnes China passa a exigir verificação de identidade em 2026-10-26 12:00 (UTC+8) — contas não verificadas terão uma taxa menor de chamadas à API — e o upstream espera que erros de sobrecarga como 503 e "queue is full" melhorem bastante após essa data.
O Agnes devolve 503 sem parar: o app tenta de novo automaticamente, e por quanto tempo?
Sim. Todo 503 (inclusive um 503 «cru» sem código de erro) é normalizado como sinal de «ocupado» e repetido numa trilha separada: a primeira tentativa é imediata e depois ele volta à fila em intervalos fixos, por padrão até 15 vezes (ajustável pela variável de ambiente AGNES_VIDEO_BUSY_RETRY_ATTEMPTS). O painel de progresso mostra em tempo real «Fila de vídeo do Agnes cheia (HTTP 503 · video_queue_full), aguardando nova tentativa (tentativa N / X minutos esperados)» e mantém o erro original do provedor.
Mesmo tentando de novo não consigo vaga — preciso esperar para sempre?
Não. Fila saturada é questão de horário, então tente fora do pico ou mais tarde; no mesmo momento você pode reduzir a carga (menos cenas, durações menores) ou trocar de modelo de vídeo (as filas são separadas por modelo). Se só quer um vídeo agora, mude para o fluxo Jimeng: o Jimeng gera imagem e áudio, e este projeto cuida do storyboard, das legendas e da montagem.
Se uma tentativa falhar ou for interrompida, tudo se perde?
Não. «Repetir tarefa» continua a partir da etapa que falhou: storyboards e imagens de referência já gerados são mantidos, não são reenviados nem consumidos de novo. No modo de material externo os clipes já importados também são mantidos, então basta completar os trechos que faltam.
503 e 401 são o mesmo tipo de problema?
Não. O 503 é problema de capacidade do provedor: espere ou pegue outro caminho. O 401 significa que a Key não corresponde ao domínio conectado (a solicitação leva Key, mas aquele site não aceita): é preciso outra Key ou vincular o domínio de novo. Cada um tem sua própria documentação, não os investigue juntos.
O fluxo Jimeng tem custo extra?
O próprio Jimeng distribui créditos diários, então use primeiro os gratuitos; se quiser recarregar quando acabarem, a decisão é sua. Este projeto continua sendo open source sob MIT e gratuito para auto-hospedar, e mudar para o Jimeng só troca a origem da etapa «geração de vídeo», sem acrescentar custo a este projeto.
Por que o fluxo Jimeng pede para colar duas vezes? Qual é a relação entre os prompts de «storyboard» e de «clipes de vídeo»?
O prompt do ponto de verificação do storyboard é uma «instrução criativa»: diz ao Jimeng (ou a qualquer LLM) como refinar o storyboard com restrições de imagem + áudio + duração; já o prompt do ponto de verificação dos clipes de vídeo é o próprio roteiro de storyboard já fechado deste projeto, numerado por trecho como [Cena i/N · duração], pronto para copiar e colar. O primeiro serve para lapidar, o segundo para executar.
Por que não vejo a opção «Material externo» no Studio web?
Certo. O modo de material externo hoje só existe na versão desktop auto-hospedada (v7.6+); o Studio web e a Demo online continuam no modo automático. Se quiser que a versão web também aceite material externo, vote nisso em um Issue.

As opções diante de um 503

Não há resposta única: escolha conforme o que você precisa naquele momento:

EtapaModo automático / manualModo de material externo (Jimeng)
Storyboard e promptsGerados por este projetoGerados por este projeto, e ainda um conjunto de prompts por cena que você cola direto no Jimeng
Imagem e áudioModelos de vídeo do Agnes (a API devolve 503 com frequência; só a narração vem do edge_tts deste projeto)Gerados pelo Jimeng (com áudio nativo); exportados como um mp4 por cena e importados em lote
LegendasAlinhadas aos carimbos de tempo por palavra da narração (mais precisas)Alinhamento estimado pela duração real de cada storyboard (pode deslocar, confira no ponto de verificação das legendas)
Montagem e vídeo finalQuem monta é este projetoEste projeto normaliza + monta mantendo a trilha de áudio original + grava as legendas

Existem outros canais gratuitos de geração de vídeo?

Não seria surpresa, e queremos integrá-los. A lista de ferramentas deste projeto é um registro extensível: adicionar uma ferramenta exige apenas um conjunto de modelos de prompt e instruções de reimportação, sem mexer no fluxo nem na camada de composição. Se o seu canal tiver áudio nativo, duração nativa controlável ou exportação de legendas, a integração fica ainda mais fácil. Abra um Issue no GitHub informando o nome da ferramenta, a cota gratuita, as faixas de duração e se suporta áudio, e vamos avaliar a integração.

GitHub Issues →

Páginas relacionadas

Guia do fluxo de trabalho do Jimeng (recurso experimental)

Apenas «imagem + áudio nativo» vai para o Jimeng; o storyboard, os diálogos, as legendas e a montagem continuam a cargo deste projeto — um caminho alternativo quando a API do Agnes devolve 503 com frequência.

Erros do Agnes Video Generator: HTTP 503, token 401 e novas tentativas

Como resolver erros do Agnes Video Generator: HTTP 503 «video queue is full», 401 token inválido, gerações falhadas ou interrompidas com retomada do checkpoint, requisitos do sistema e chave de API.

Guia do modo manual — Auto vs Manual: geração espontânea ou resultado preciso | Agnes Video

Como usar o modo manual no Agnes Video Generator: pausa nos pontos de verificação (storyboard, referências, clipes, narração, legendas, final) para revisar ou refinar cada artefato antes de continuar, opcionalmente com IA externa ou ferramentas mais fortes para um resultado preciso. O modo automático serve para gerar de forma espontânea a partir de uma ideia (vibe video generating); o manual para saídas claramente definidas com ajuste fino dos artefatos.

O Agnes Video Generator é gratuito? Cota gratuita e licença comercial

Por que o Agnes Video Generator é totalmente gratuito, como funciona a cota gratuita, se permite uso comercial e como se diferencia de Runway, Pika e outras ferramentas de vídeo IA gratuitas.

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.

Por que você pode confiar

Este artigo foi escrito por profissionais da linha de frente. Ao escrevê-lo, fontes de primeira mão, como artigos arXiv, relatórios técnicos de fabricantes e Stanford AI Index, foram verificadas e não baseadas em conclusões subjetivas.

S

SandGrid@lcy362

Autor do Agnes Video Generator · Desenvolvedor Full-Stack

Desenvolvedor independente e autor da ferramenta de geração de vídeo de IA de código aberto Agnes Video Generator. O projeto é baseado no modelo de vídeo totalmente gratuito da Agnes AI, com protocolo MIT de código aberto e ajudou mais de 1.000 criadores a produzir vídeos de IA a custo zero. Há muito tempo estou preocupado com a engenharia e popularização de modelos de geração de vídeo, e o conteúdo do artigo vem da prática de primeira linha e da pesquisa em primeira mão.

Ver no GitHub

Última atualização：2026-08-21

Pronto para começar?

“Deixe a IA de classe mundial pertencer a todos.” – Bruce Yang. Completamente grátis, sem cartão de crédito ou placa gráfica de alto desempenho, faça seu primeiro vídeo de IA a zero custo. Quer usar o modelo de vídeo gratuito da Agnes AI? Basta começar daqui.

Experimentar demo onlineComeçar grátis

Clone o repositório do GitHub e inicie em 2 minutos