Hatalar ve sorun giderme

Linux, macOS ve Windows desteği, Node.js 18+ ve modern bir tarayıcı gerektirir. Tüm yapay zeka işlemleri bulut API'sinde tamamlanır, dolayısıyla yerel makine konfigürasyonu ne kadar sıradan olursa olsun onu engellemez ve yüksek performanslı grafik kartları tamamen kullanılamaz.

Sadece Agnes AI için bir API anahtarı. Agnes AI resmi web sitesine (agnes-ai.com) kaydolarak onu ücretsiz olarak alabilirsiniz. Metin, resim, video oluşturma ve konuşma sentezi için kullanın. Tüm yetenekler, ek yapılandırma gerektirmeyen Agnes AI ücretsiz modelinden gelir.

Destek. Uzun el yazması video modu toplu işleme için tasarlanmıştır: uzun bir makale atın, onu otomatik olarak birden fazla bölüme ayırın, videoyu bölüm bölüm oluşturun ve ardından anlatım ve altyazıları eşit şekilde ekleyin.

Kırılma noktası devam ediyor. Oluşturma görevi kesintiye uğrarsa (ağın kesilmesi, yeniden başlatılması vb.), yeniden başlatma otomatik olarak önceki başarılı kontrol noktasından devam edecektir ve ilerleme kaybedilmeyecektir. Başarısızlıkların çoğu model hizmeti dalgalanmaları, ağ zaman aşımı veya hız sınırlandırma gibi geçici nedenlerden kaynaklanır. Önce hata panelindeki "Görevi Yeniden Dene" düğmesine tıklayın — görev başarısız adımdan (kontrol noktası tabanlı) devam eder ve çoğu durumda kendiliğinden düzelir.

Başarısızlıkların çoğu model hizmeti dalgalanmaları, ağ zaman aşımı veya hız sınırlandırma gibi geçici nedenlerden kaynaklanır. Önce uygulama içindeki hata panelinde "Görevi Yeniden Dene" düğmesine tıklayın — görev başarısız adımdan devam eder ve çoğu durumda yeniden göndermeden kendiliğinden düzelir. Birkaç denemeden (≥ 2) sonra hâlâ başarısız olursa geri bildirim alanı otomatik açılır: tanılama bilgilerini tek tıkla kopyalayıp önceden doldurulmuş bir GitHub Issue'ya geçebilirsiniz; ortamınızı elle anlatmanıza gerek yoktur.

Agnes, Video 2.5 Flash gibi video modelleri için ortak, ücretsiz bir çıkarım kuyruğu işletir ve bu kuyruk yoğun saatlerde 10 dakikadan fazla dolu kalabilir. Kuyruk dolduğunda her gönderim HTTP 503 · video_queue_full ve ham mesaj olan "video queue is full, please retry later (request id: …)" ile reddedilir. Hiçbir görev oluşturulmaz, hiçbir kota tüketilmez ve hiçbir şey kaybolmaz — bu Agnes tarafındaki kapasite meselesidir, promptunuz veya kurulumunuzla ilgili bir sorun değildir. v7.0'dan itibaren kuyruk dolu reddi normal yeniden deneme bütçesinden sayılmaz: özel bir yeniden deneme hattına geçer (varsayılan olarak en fazla 15 deneme, AGNES_VIDEO_BUSY_RETRY_ATTEMPTS ile ayarlanabilir), ilk deneme hemen başlar ve sonrakiler 30–60 sn aralıkla yapılır. v7.1'den itibaren hata paneli ve görev oluşturma bildirimi, üst kaynağın geçmişte daha rahat olduğu yoğun olmayan saat aralıklarını da önerir ve bunlar yerel saatinizde gösterilir. Agnes 503 hatalarından kaçınmak için: yoğun olmayan saatlerde yeniden deneyin, başka bir video modeline geçin (Video 2.0 ayrı bir kuyruk kullanır ve genellikle görevleri kabul etmeye devam eder) veya daha fazla API anahtarı ekleyin — her anahtarın kendi kotası vardır. Sağlayıcıdan bir not daha: Agnes Çin sitesi 2026-10-26 12:00 (Pekin saati) itibarıyla kimlik doğrulamasını zorunlu kılıyor — doğrulanmamış hesapların API çağrı hızı düşecek — ve upstream, bu tarihten sonra 503 ile "queue is full" gibi yoğunluk hatalarının belirgin şekilde azalmasını bekliyor.

401 Unauthorized veya "geçersiz jeton" yanıtı genellikle API anahtarının gönderildiği etki alanıyla eşleşmediği anlamına gelir — örneğin, küresel sitede verilen bir anahtarın Çin yerel uç noktası api.agnes-ai.cn için kullanılması (veya tersi). Farklı siteler için verilen anahtarlar yanlış etki alanına gönderildiğinde reddedilir. v6.4.2'den itibaren her anahtar kendi erişim etki alanına bağlanabilir; tek tıkla "Etki alanlarını otomatik algıla" düğmesi her anahtarı com / cn / cn_bak üzerinde sınar ve eşleşen etki alanını otomatik doldurur. API anahtarı panelinde anahtarınıza uyan etki alanını seçin veya otomatik algılamayı çalıştırın. Küresel site anahtarları apihub.agnes-ai.com veya cn_bak yedek etki alanını (apihub.agnes-ai.cn, hem yerel hem küresel anahtarları kabul eder) kullanmalıdır.

Geri bildirim hem uygulama içinde hem de GitHub'da sağlanır. Uygulamada bir görev başarısız olduğunda, hata paneli "Tanılama bilgilerini kopyala" ve "GitHub'da Issue aç" düğmelerini sunar; uygulama sürümü, görev türü, başarısız adım, hata mesajı ve yeniden deneme sayısı otomatik eklenir, böylece geliştiriciler sorunu hızla tespit edebilir. Mevcut raporları görmek veya yeni bir Issue açmak için GitHub Issues sayfasını (github.com/lcy362/agnes-video-generator/issues) da ziyaret edebilirsiniz.