Troubleshooting & errors

Agnes Video Generator runs on Linux, macOS, and Windows. It requires Node.js 18+ and a modern web browser. Since all AI processing happens via cloud APIs, you don't need a high-end GPU — your local machine's hardware specs are not a bottleneck.

Only the Agnes AI API key. Sign up at agnes-ai.com to get one for free. It covers text, image, video generation, and voice synthesis — all powered by Agnes AI's free models. No additional configuration needed.

Yes. The Manuscript Video mode is designed for batch processing — it takes a long text, splits it into segments, and generates videos for each segment sequentially with unified narration and subtitles.

Agnes Video Generator has a checkpoint resume feature. If a generation task is interrupted (network issue, system restart, etc.), it automatically resumes from the last successful checkpoint when restarted, so you don't lose progress. Most failures are caused by transient factors such as model service fluctuations, network timeouts, or rate limiting — click Retry Task in the failure panel first, and the task resumes from the failed step (checkpoint-based), usually recovering on its own.

Most failures are caused by transient factors such as model service fluctuations, network timeouts, or rate limiting. In the in-app failure panel, click Retry Task first — the task resumes from the failed step, and most cases recover on their own without resubmitting. If it still fails after several retries (≥ 2), the feedback area auto-expands, letting you copy the diagnostic info in one click and jump to a pre-filled GitHub Issue without describing your environment manually.

Agnes runs a shared free inference queue for video models such as Video 2.5 Flash, and it can stay saturated for 10+ minutes during peak hours. When it is full, every submission is rejected with HTTP 503 · video_queue_full and the raw message "video queue is full, please retry later (request id: …)". No task is created, nothing is consumed, and nothing is lost — this is Agnes-side capacity, not a problem with your prompt or setup. Since v7.0 the app no longer counts a queue-full rejection against the normal retry budget: it moves to a dedicated retry track (up to 15 attempts by default, tunable via AGNES_VIDEO_BUSY_RETRY_ATTEMPTS), the first retry fires immediately and later ones are spaced 30–60s apart. Since v7.1 the failure panel and the create-task toast also suggest the off-peak windows when upstream is historically smoother, shown in your own local time. To avoid Agnes 503 errors: retry during off-peak hours, switch to another video model (Video 2.0 uses a separate queue and often still accepts jobs), or add more API keys — each key has its own quota. One more note from the provider: the Agnes China site enforces real-name verification from 2026-10-26 12:00 (UTC+8) — unverified accounts get a lower API call rate — and upstream expects 503 / queue is full busy errors to improve significantly after that point.

A 401 Unauthorized or "invalid token" response usually means the API Key does not match the domain it is being sent to — for example, a key issued on the global site being used against the China-domestic endpoint api.agnes-ai.cn (or the reverse). Keys issued for different sites are rejected when sent to the wrong domain. As of v6.4.2, each key can be bound to its own access domain, and a one-click Auto-detect domains button probes each key across com / cn / cn_bak and fills in the matching domain automatically. In the API Key panel, pick the domain that matches your key, or just run auto-detect. Global-site keys should use apihub.agnes-ai.com, or the cn_bak fallback domain (apihub.agnes-ai.cn, which accepts both domestic and global keys).

Feedback is available both in-app and on GitHub. When a task fails in the app, the failure panel offers Copy Diagnostic Info and Open a GitHub Issue buttons, automatically attaching the app version, task type, failed step, error message, and retry count to help maintainers pinpoint the problem. You can also visit the GitHub Issues page (github.com/lcy362/agnes-video-generator/issues) to check existing reports or open a new one.