Pemecahan masalah & kesalahan

Mendukung Linux, macOS dan Windows, butuh Node.js 18+ dan browser modern. Semua pemrosesan AI selesai lewat API cloud, jadi konfigurasi mesin lokal sepolos apa pun tidak jadi masalah, GPU kelas atas sama sekali tidak terpakai.

Cukup satu API Key Agnes AI. Daftar di situs resmi Agnes AI (agnes-ai.com) langsung dapat gratis, generasi teks, gambar, video dan sintesis suara semuanya memakainya. Semua kemampuan datang dari model gratis Agnes AI, tidak perlu konfigurasi tambahan.

Bisa. Mode Video Naskah memang dirancang untuk pemrosesan batch: masukkan satu artikel panjang, otomatis dipecah jadi beberapa bagian, hasilkan video tiap bagian, lalu tambahkan narasi dan subtitle secara seragam.

Ada fitur resume dari titik putus. Kalau tugas generasi terganggu (putus jaringan, restart dan sejenisnya), restart akan lanjut otomatis dari checkpoint berhasil terakhir, progres tidak hilang. Sebagian besar kegagalan disebabkan faktor sementara seperti gangguan layanan model, timeout jaringan, atau pembatasan laju. Klik "Coba Ulang Tugas" di panel kegagalan terlebih dahulu — tugas akan lanjut dari langkah yang gagal (berbasis checkpoint) dan biasanya pulih dengan sendirinya.

Sebagian besar kegagalan disebabkan faktor sementara seperti gangguan layanan model, timeout jaringan, atau pembatasan laju. Klik "Coba Ulang Tugas" di panel kegagalan dalam aplikasi terlebih dahulu — tugas akan lanjut dari langkah yang gagal dan biasanya pulih dengan sendirinya tanpa perlu dikirim ulang. Jika masih gagal setelah beberapa kali percobaan (≥ 2), area masukan terbuka otomatis, memungkinkan Anda menyalin info diagnostik sekali klik dan melompat ke GitHub Issue yang sudah terisi sebelumnya tanpa menjelaskan lingkungan secara manual.

Agnes menjalankan antrean inferensi gratis bersama untuk model video seperti Video 2.5 Flash, dan antrean itu bisa penuh lebih dari 10 menit pada jam sibuk. Saat penuh, setiap pengiriman ditolak dengan HTTP 503 · video_queue_full dan pesan asli "video queue is full, please retry later (request id: …)". Tidak ada tugas yang dibuat, tidak ada kuota yang terpakai, dan tidak ada yang hilang — ini masalah kapasitas di sisi Agnes, bukan kesalahan prompt atau pengaturan Anda. Sejak v7.0, penolakan karena antrean penuh tidak lagi dihitung terhadap anggaran percobaan ulang biasa: ia berpindah ke jalur percobaan ulang khusus (default hingga 15 percobaan, dapat diatur lewat AGNES_VIDEO_BUSY_RETRY_ATTEMPTS), percobaan pertama langsung dijalankan dan berikutnya berjarak 30–60 detik. Sejak v7.1, panel kegagalan dan notifikasi pembuatan tugas juga menyarankan jendela jam sepi saat hulu biasanya lebih lancar, ditampilkan dalam waktu lokal Anda. Untuk menghindari error Agnes 503: coba lagi pada jam sepi, ganti ke model video lain (Video 2.0 memakai antrean terpisah dan biasanya masih menerima tugas), atau tambahkan lebih banyak API key — setiap key punya kuota sendiri. Satu catatan lagi dari penyedia: situs Agnes China mulai mewajibkan verifikasi identitas pada 2026-10-26 12:00 (waktu Beijing) — akun yang belum terverifikasi mendapat laju panggilan API lebih rendah — dan pihak upstream memperkirakan error kesibukan seperti 503 dan "queue is full" akan jauh berkurang setelah itu.

Respons 401 Unauthorized atau "token tidak valid" biasanya berarti Kunci API tidak cocok dengan domain yang dituju — misalnya, kunci yang diterbitkan di situs global digunakan pada endpoint domestik Tiongkok api.agnes-ai.cn (atau sebaliknya). Kunci yang diterbitkan untuk situs berbeda akan ditolak saat dikirim ke domain yang salah. Sejak v6.4.2, setiap kunci dapat diikat ke domain aksesnya sendiri, dan tombol "Deteksi domain otomatis" sekali klik menguji setiap kunci terhadap com / cn / cn_bak dan mengisi domain yang cocok secara otomatis. Di panel Kunci API, pilih domain yang cocok dengan kunci Anda, atau jalankan deteksi otomatis. Kunci situs global sebaiknya menggunakan apihub.agnes-ai.com, atau domain cadangan cn_bak (apihub.agnes-ai.cn, yang menerima kunci domestik maupun global).

Masukan tersedia di dalam aplikasi maupun di GitHub. Saat tugas gagal di aplikasi, panel kegagalan menawarkan tombol Salin Info Diagnostik dan Buka Issue GitHub, otomatis menyertakan versi aplikasi, jenis tugas, langkah yang gagal, pesan kesalahan, dan jumlah percobaan ulang agar pengelola dapat menemukan masalah dengan cepat. Anda juga dapat mengunjungi halaman GitHub Issues (github.com/lcy362/agnes-video-generator/issues) untuk melihat laporan yang ada atau membuka laporan baru.