Lỗi & xử lý sự cố

Hỗ trợ Linux, macOS và Windows, yêu cầu Node.js 18+ và trình duyệt hiện đại. Tất cả quá trình xử lý AI đều được thực hiện trên API đám mây, vì vậy dù cấu hình máy cục bộ có bình thường đến đâu cũng sẽ không bị trì hoãn và card đồ họa hiệu suất cao hoàn toàn không cần thiết.

Chỉ cần một khóa API của Agnes AI. Bạn có thể nhận được miễn phí bằng cách đăng ký trên trang web chính thức của Agnes AI (agnes-ai.com) và sử dụng nó để tạo văn bản, hình ảnh, video và tổng hợp giọng nói. Tất cả các khả năng đến từ mô hình miễn phí Agnes AI, không cần cấu hình bổ sung.

Hỗ trợ. Chế độ video dài bản thảo được thiết kế để xử lý hàng loạt: ném một bài viết dài vào, tự động chia thành nhiều đoạn, tạo video từng đoạn một, sau đó thêm tường thuật và phụ đề một cách thống nhất.

Có một điểm phá vỡ để tiếp tục. Nếu tác vụ tạo bị gián đoạn (ngắt mạng, khởi động lại, v.v.), việc khởi động lại sẽ tự động chạy từ điểm kiểm tra thành công trước đó và tiến độ sẽ không bị mất. Phần lớn lỗi do các yếu tố tạm thời như dịch vụ mô hình chập chờn, mạng chậm hoặc giới hạn tần suất. Hãy nhấn "Thử lại tác vụ" trong bảng lỗi trước — tác vụ sẽ tiếp tục từ bước bị lỗi (theo điểm kiểm tra) và thường tự phục hồi.

Phần lớn lỗi do các yếu tố tạm thời như dịch vụ mô hình chập chờn, mạng chậm hoặc giới hạn tần suất. Hãy nhấn "Thử lại tác vụ" trong bảng lỗi của ứng dụng trước — tác vụ sẽ tiếp tục từ bước bị lỗi và thường tự phục hồi mà không cần gửi lại. Nếu vẫn thất bại sau vài lần thử (≥ 2), khu vực phản hồi tự động mở ra: sao chép thông tin chẩn đoán một chạm và chuyển đến GitHub Issue được điền sẵn, không cần mô tả thủ công môi trường của bạn.

Agnes vận hành một hàng đợi suy luận miễn phí dùng chung cho các mô hình video như Video 2.5 Flash, và hàng đợi này có thể kín trong hơn 10 phút vào giờ cao điểm. Khi hàng đợi đầy, mọi lần gửi đều bị từ chối với HTTP 503 · video_queue_full cùng thông báo gốc "video queue is full, please retry later (request id: …)". Không có tác vụ nào được tạo, không tiêu tốn hạn mức và không mất mát gì — đây là vấn đề năng lực phía Agnes, không phải do prompt hay cấu hình của bạn. Từ v7.0, việc bị từ chối vì hàng đợi đầy không còn tính vào ngân sách thử lại thông thường: nó chuyển sang một luồng thử lại riêng (mặc định tối đa 15 lần, điều chỉnh qua AGNES_VIDEO_BUSY_RETRY_ATTEMPTS), lần thử đầu chạy ngay lập tức và các lần sau cách nhau 30–60 giây. Từ v7.1, bảng lỗi và thông báo tạo tác vụ cũng gợi ý các khung giờ thấp điểm khi hệ thống thượng nguồn thường thông suốt hơn, hiển thị theo giờ địa phương của bạn. Để tránh lỗi Agnes 503: thử lại vào giờ thấp điểm, chuyển sang mô hình video khác (Video 2.0 dùng hàng đợi riêng và thường vẫn nhận tác vụ), hoặc thêm nhiều API key hơn — mỗi key có hạn mức riêng. Thêm một lưu ý từ nhà cung cấp: site Agnes Trung Quốc bắt buộc xác thực danh tính từ 2026-10-26 12:00 (giờ Bắc Kinh) — tài khoản chưa xác thực sẽ bị giảm tần suất gọi API — và phía upstream dự kiến các lỗi quá tải như 503 và "queue is full" sẽ giảm rõ rệt sau mốc này.

Phản hồi 401 Unauthorized hoặc "token không hợp lệ" thường có nghĩa là API key không khớp với tên miền mà yêu cầu được gửi tới — ví dụ, key phát hành trên trang toàn cầu lại dùng cho điểm cuối nội địa Trung Quốc api.agnes-ai.cn (hoặc ngược lại). Key phát hành cho các trang khác nhau sẽ bị từ chối khi gửi tới sai tên miền. Từ v6.4.2, mỗi key có thể gắn với tên miền truy cập riêng, và nút một chạm "Tự động dò tên miền" sẽ kiểm tra từng key trên com / cn / cn_bak rồi tự động điền tên miền khớp. Trong bảng khóa API, hãy chọn tên miền khớp với key của bạn, hoặc chạy luôn tính năng tự động dò. Key của trang toàn cầu nên dùng apihub.agnes-ai.com, hoặc tên miền dự phòng cn_bak (apihub.agnes-ai.cn, chấp nhận cả key nội địa lẫn toàn cầu).

Phản hồi được cung cấp cả trong ứng dụng lẫn trên GitHub. Khi một tác vụ thất bại trong ứng dụng, bảng lỗi sẽ cung cấp nút "Sao chép thông tin chẩn đoán" và "Mở GitHub Issue", tự động đính kèm phiên bản ứng dụng, loại tác vụ, bước bị lỗi, thông báo lỗi và số lần thử lại để người duy trì nhanh chóng xác định vấn đề. Bạn cũng có thể truy cập trang GitHub Issues (github.com/lcy362/agnes-video-generator/issues) để xem các báo cáo hiện có hoặc mở báo cáo mới.