Fouten & probleemoplossing

Ondersteunt Linux, macOS en Windows, vereist Node.js 18+ en een moderne browser. Alle AI-verwerking gebeurt via cloud-API's, dus hoe gewoon je lokale machine ook is, het vormt geen bottleneck; een krachtige GPU is helemaal niet nodig.

Alleen één Agnes AI API-sleutel. Registreer op de officiële Agnes AI-website (agnes-ai.com) en je krijgt hem gratis, voor tekst-, beeld-, videogeneratie en spraaksynthese. Alle mogelijkheden komen van het gratis Agnes AI-model, geen extra configuratie nodig.

Ja. De Manuscript Videomodus is speciaal ontworpen voor batchverwerking: voer een lang artikel in, het wordt automatisch opgesplitst in meerdere delen, genereer per deel een video, en voeg daarna op uniforme wijze voice-over en ondertitels toe.

Er is een hervat-functie na onderbreking. Als een generatietaak wordt onderbroken (netwerkuitval, herstart en dergelijke), hervat het automatisch vanaf het laatste succesvolle checkpoint, zonder verlies van voortgang. De meeste fouten komen door tijdelijke oorzaken zoals schommelingen in de modeldienst, netwerk-timeouts of snelheidsbeperking. Klik eerst op "Taak opnieuw proberen" in het foutpaneel — de taak hervat vanaf de mislukte stap (op basis van checkpoints) en herstelt meestal vanzelf.

De meeste fouten komen door tijdelijke oorzaken zoals schommelingen in de modeldienst, netwerk-timeouts of snelheidsbeperking. Klik eerst op "Taak opnieuw proberen" in het foutpaneel van de app — de taak hervat vanaf de mislukte stap en herstelt meestal vanzelf, zonder opnieuw in te dienen. Lukt het na meerdere pogingen (≥ 2) nog niet, dan klapt het feedbackgebied automatisch open: kopieer de diagnostische informatie met één klik en ga direct naar een vooraf ingevuld GitHub Issue, zonder je omgeving handmatig te beschrijven.

Agnes draait een gedeelde gratis inferentiewachtrij voor videomodellen zoals Video 2.5 Flash, en die kan tijdens piekuren meer dan 10 minuten vol zitten. Als de wachtrij vol is, wordt elke inzending geweigerd met HTTP 503 · video_queue_full en het oorspronkelijke bericht "video queue is full, please retry later (request id: …)". Er wordt geen taak aangemaakt, er wordt geen quotum verbruikt en er gaat niets verloren — dit is een capaciteitskwestie aan Agnes-zijde, geen probleem met je prompt of instellingen. Sinds v7.0 telt een weigering wegens een volle wachtrij niet meer mee voor het normale herprobeerbudget: deze gaat naar een apart herprobeerspoor (standaard maximaal 15 pogingen, instelbaar via AGNES_VIDEO_BUSY_RETRY_ATTEMPTS), de eerste poging start direct en latere pogingen volgen met 30–60 s ertussen. Sinds v7.1 tonen het foutpaneel en de melding bij het aanmaken van een taak ook de daluren waarin de upstream historisch soepeler is, weergegeven in je eigen lokale tijd. Om Agnes 503-fouten te vermijden: probeer het opnieuw tijdens daluren, schakel over naar een ander videomodel (Video 2.0 gebruikt een aparte wachtrij en accepteert meestal nog taken) of voeg meer API-sleutels toe — elke sleutel heeft zijn eigen quotum. Nog een mededeling van de aanbieder: de Agnes China-site verplicht vanaf 2026-10-26 12:00 (UTC+8) identiteitsverificatie — niet-geverifieerde accounts krijgen een lagere API-aanroepsnelheid — en de upstream verwacht dat druktefouten zoals 503 en "queue is full" daarna aanzienlijk afnemen.

Een 401 Unauthorized- of "ongeldig token"-antwoord betekent meestal dat de API-sleutel niet overeenkomt met het domein waarnaar deze wordt verzonden — bijvoorbeeld een sleutel die op de globale site is uitgegeven maar wordt gebruikt tegen het Chinese binnenlandse endpoint api.agnes-ai.cn (of omgekeerd). Sleutels die voor verschillende sites zijn uitgegeven, worden geweigerd als ze naar het verkeerde domein worden gestuurd. Sinds v6.4.2 kan elke sleutel aan zijn eigen toegangsdomein worden gebonden, en de one-click-knop "Domeinen automatisch detecteren" test elke sleutel tegen com / cn / cn_bak en vult automatisch het bijpassende domein in. Kies in het API-key-paneel het domein dat bij jouw sleutel past, of start gewoon de automatische detectie. Globale sleutels moeten apihub.agnes-ai.com of het cn_bak-fallbackdomein gebruiken (apihub.agnes-ai.cn, dat zowel binnenlandse als globale sleutels accepteert).

Feedback is zowel in de app als op GitHub beschikbaar. Als een taak in de app mislukt, biedt het foutpaneel de knoppen "Diagnostische informatie kopiëren" en "GitHub-issue openen", die automatisch de app-versie, het taaktype, de mislukte stap, de foutmelding en het aantal herpogingen bijvoegen zodat beheerders het probleem snel kunnen lokaliseren. Je kunt ook de GitHub Issues-pagina (github.com/lcy362/agnes-video-generator/issues) bezoeken om bestaande meldingen te bekijken of een nieuwe te openen.