Mga error at pag-troubleshoot

Sinusuportahan ang Linux, macOS at Windows, nangangailangan ng Node.js 18+ at modernong browser. Ang lahat ng pagpoproseso ng AI ay nakumpleto sa cloud API, kaya gaano man ordinaryo ang pagsasaayos ng lokal na makina, hindi ito hahadlang, at ang mga high-performance na graphics card ay ganap na hindi magagamit.

Isang API Key lang para sa Agnes AI. Maaari mong makuha ito nang libre sa pamamagitan ng pagpaparehistro sa opisyal na website ng Agnes AI (agnes-ai.com). Gamitin ito para sa text, mga larawan, pagbuo ng video at synthesis ng pagsasalita. Ang lahat ng mga kakayahan ay nagmumula sa libreng modelo ng Agnes AI nang walang karagdagang pagsasaayos.

Suporta. Ang long video mode ng manuskrito ay idinisenyo para sa pagproseso ng batch: maglagay ng mahabang artikulo, awtomatikong hatiin ito sa maraming talata, bumuo ng video nang paisa-isa, at pagkatapos ay magdagdag ng pagsasalaysay at mga subtitle nang pantay-pantay.

May mga breakpoint upang ipagpatuloy ang pagpasa. Kung ang gawain ng pagbuo ay naantala (pag-disconnect, pag-restart, atbp.), Ang pag-restart ay awtomatikong tatakbo mula sa nakaraang matagumpay na checkpoint, at ang pag-unlad ay hindi mawawala. Karamihan sa mga pagkabigo ay dulot ng pansamantalang salik tulad ng pagbabago-bago ng model service, network timeout, o rate limiting. I-click muna ang "Retry Task" sa failure panel — magpapatuloy ang gawain mula sa nabigong hakbang (batay sa checkpoint) at karaniwang kusang gagaling.

Karamihan sa mga pagkabigo ay dulot ng pansamantalang salik tulad ng pagbabago-bago ng model service, network timeout, o rate limiting. I-click muna ang "Retry Task" sa failure panel ng app — magpapatuloy ang gawain mula sa nabigong hakbang at karaniwang kusang gagaling nang hindi na kailangang muling isumite. Kung nabigo pa rin pagkatapos ng ilang pagsubok (≥ 2), awtomatikong bubuksan ang feedback area: kopyahin ang diagnostic info sa isang click at lumaktaw sa pre-filled na GitHub Issue nang hindi na kailangang ilarawan nang mano-mano ang iyong environment.

Ang Agnes ay may pinagsamang libreng inference queue para sa mga video model tulad ng Video 2.5 Flash, at maaari itong manatiling punô nang mahigit 10 minuto sa peak hours. Kapag punô ito, tinatanggihan ang bawat pagsusumite gamit ang HTTP 503 · video_queue_full at ang orihinal na mensaheng "video queue is full, please retry later (request id: …)". Walang task na nagagawa, walang quota na nauubos, at walang nawawala — isyu ito ng kapasidad sa panig ng Agnes, hindi problema sa iyong prompt o setup. Mula v7.0, ang pagtanggi dahil punô ang queue ay hindi na binibilang sa normal na retry budget: lumilipat ito sa isang dedikadong retry track (default na hanggang 15 pagtatangka, nababagay sa pamamagitan ng AGNES_VIDEO_BUSY_RETRY_ATTEMPTS), agad na tumatakbo ang unang pagtatangka at ang mga susunod ay may 30–60s na pagitan. Mula v7.1, ang failure panel at ang abiso sa paggawa ng task ay nagmumungkahi rin ng mga off-peak window kung kailan mas maayos ang upstream, na ipinapakita sa iyong lokal na oras. Para maiwasan ang Agnes 503 errors: subukan muli sa off-peak hours, lumipat sa ibang video model (gumagamit ang Video 2.0 ng hiwalay na queue at kadalasan ay tumatanggap pa rin ng task), o magdagdag ng mas maraming API key — may sariling quota ang bawat key. Isang paalala pa mula sa provider: ipapatupad ng Agnes China site ang real-name verification simula 2026-10-26 12:00 (oras sa Beijing) — bababa ang rate ng API calls para sa mga account na hindi pa verified — at inaasahan ng upstream na liliit nang malaki ang mga busy error tulad ng 503 at "queue is full" pagkatapos nito.

Ang 401 Unauthorized o "invalid token" na tugon ay karaniwang nangangahulugang hindi tugma ang API key sa domain kung saan ipinapadala ang kahilingan — halimbawa, ang key na inisyu sa global site ay ginagamit laban sa China-domestic endpoint na api.agnes-ai.cn (o kabaliktaran). Ang mga key na inisyu para sa ibang site ay tinatanggihan kapag ipinadala sa maling domain. Simula v6.4.2, maaari nang i-bind ang bawat key sa sarili nitong access domain, at ang one-click na "Auto-detect domains" button ay sumusubok sa bawat key laban sa com / cn / cn_bak at awtomatikong pinupunan ang katumbas na domain. Sa API key panel, piliin ang domain na katumbas ng iyong key, o patakbuhin lang ang auto-detect. Ang mga global-site key ay dapat gumamit ng apihub.agnes-ai.com, o ng cn_bak fallback domain (apihub.agnes-ai.cn, na tumatanggap ng parehong domestic at global keys).

Available ang feedback sa loob ng app at sa GitHub. Kapag nabigo ang isang gawain sa app, nag-aalok ang failure panel ng mga button na "Kopyahin ang diagnostic info" at "Magbukas ng GitHub Issue", awtomatikong naglalakip ng bersyon ng app, uri ng gawain, nabigong hakbang, error message, at bilang ng mga retry upang matulungan ang mga tagapag-alaga na mabilis matukoy ang problema. Maaari mo ring bisitahin ang GitHub Issues page (github.com/lcy362/agnes-video-generator/issues) para tingnan ang mga umiiral na report o magbukas ng bago.