Erros e solução de problemas

Suporta Linux, macOS e Windows, requer Node.js 18+ e um navegador moderno. Todo o processamento de IA é concluído na API da nuvem, portanto, não importa quão comum seja a configuração da máquina local, ela não será atrasada e as placas gráficas de alto desempenho são completamente inúteis.

Apenas uma chave API da Agnes AI. Registre-se no site oficial da Agnes AI (agnes-ai.com) e você pode obtê-lo gratuitamente. Use-o para geração de texto, imagens, vídeo e síntese de fala. Todas as habilidades vêm do modelo gratuito Agnes AI, sem configuração adicional.

Apoio. O modo de vídeo longo do manuscrito é projetado para processamento em lote: jogue um artigo longo, divida-o automaticamente em vários parágrafos, gere o vídeo parágrafo por parágrafo e adicione narração e legendas uniformemente.

Há um ponto de interrupção para continuar. Se a tarefa de geração for interrompida (desconexão, reinicialização, etc.), a reinicialização continuará automaticamente a partir do último ponto de verificação bem-sucedido e o progresso não será perdido. A maioria das falhas é causada por fatores transitórios, como flutuações do serviço do modelo, tempos limite de rede ou limitação de taxa. Clique primeiro em "Repetir tarefa" no painel de falhas — a tarefa retoma do passo que falhou (com pontos de retomada) e normalmente se recupera sozinha.

A maioria das falhas é causada por fatores transitórios, como flutuações do serviço do modelo, tempos limite de rede ou limitação de taxa. Clique primeiro em "Repetir tarefa" no painel de falhas do aplicativo — a tarefa retoma do passo que falhou e normalmente se recupera sozinha, sem reenvio. Se continuar falhando após várias tentativas (≥ 2), a área de feedback se abre automaticamente: copie as informações de diagnóstico com um clique e vá direto a uma issue do GitHub pré-preenchida, sem precisar descrever o ambiente manualmente.

A Agnes mantém uma fila de inferência gratuita compartilhada para modelos de vídeo como o Video 2.5 Flash, e ela pode ficar saturada por mais de 10 minutos nos horários de pico. Quando está cheia, cada envio é rejeitado com HTTP 503 · video_queue_full e a mensagem original "video queue is full, please retry later (request id: …)". Nenhuma tarefa é criada, nenhuma cota é consumida e nada se perde — é uma questão de capacidade do lado da Agnes, não um problema com seu prompt ou configuração. Desde a v7.0, uma rejeição por fila cheia não conta mais para o orçamento normal de tentativas: ela passa para uma via de retentativa dedicada (até 15 tentativas por padrão, ajustável via AGNES_VIDEO_BUSY_RETRY_ATTEMPTS), a primeira tentativa dispara imediatamente e as seguintes são espaçadas em 30–60 s. Desde a v7.1, o painel de falhas e o aviso de criação de tarefa também sugerem as janelas de horário fora de pico em que o upstream costuma ser mais fluido, exibidas no seu horário local. Para evitar erros Agnes 503: tente novamente em horários fora de pico, mude para outro modelo de vídeo (o Video 2.0 usa uma fila separada e normalmente ainda aceita tarefas) ou adicione mais chaves de API — cada chave tem sua própria cota. 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.

Uma resposta 401 Unauthorized ou "token inválido" geralmente significa que a chave de API não corresponde ao domínio para o qual está sendo enviada — por exemplo, uma chave emitida no site global sendo usada no endpoint doméstico chinês api.agnes-ai.cn (ou vice-versa). Chaves emitidas para sites diferentes são rejeitadas quando enviadas ao domínio errado. A partir da v6.4.2, cada chave pode ser vinculada ao seu próprio domínio de acesso, e o botão de um clique "Detectar domínios automaticamente" testa cada chave em com / cn / cn_bak e preenche automaticamente o domínio correspondente. No painel de chaves de API, escolha o domínio que corresponda à sua chave, ou simplesmente execute a detecção automática. Chaves do site global devem usar apihub.agnes-ai.com, ou o domínio de fallback cn_bak (apihub.agnes-ai.cn, que aceita chaves domésticas e globais).

O feedback está disponível tanto no aplicativo quanto no GitHub. Quando uma tarefa falha no app, o painel de falhas oferece os botões "Copiar informações de diagnóstico" e "Abrir issue no GitHub", anexando automaticamente a versão do aplicativo, o tipo de tarefa, o passo que falhou, a mensagem de erro e o número de tentativas, ajudando os mantenedores a localizar o problema rapidamente. Você também pode visitar a página de GitHub Issues (github.com/lcy362/agnes-video-generator/issues) para ver relatórios existentes ou abrir um novo.