FAQ & Xử lý lỗi
FFmpeg không tìm thấy
Triệu chứng: App báo lỗi “FFmpeg not found” khi xử lý video.
Cách khắc phục:
- Chạy
setup_ffmpeg.batvới quyền Administrator - Hoặc cài FFmpeg thủ công và thêm vào PATH
- Kiểm tra: mở cmd → gõ
ffmpeg -version
Lỗi “Thiếu video”
Triệu chứng: Job trong Sheet hiện ❌ Thiếu video.
Nguyên nhân: Giá trị VIDEO_ID trong Sheet không khớp tên file video.
Cách khắc phục:
VIDEO_IDphải khớp chính xác tên file (không cần đuôi.mp4)- Ví dụ: file
video_01.mp4→VIDEO_ID=video_01 - Kiểm tra chữ hoa/thường và khoảng trắng
Lỗi GPU encoding
Triệu chứng: Video render lỗi khi bật GPU.
Cách khắc phục:
- Tắt GPU trong Cài đặt → Nâng Cao → dùng CPU (libx264)
- GPU encoding (h264_nvenc) chỉ hoạt động với card NVIDIA có driver mới
- CPU encoding ổn định hơn trên mọi máy
Vbee TTS timeout
Triệu chứng: Tạo audio Vbee bị lỗi hoặc timeout.
Kiểm tra:
- Kết nối internet ổn định
- App ID và Token chính xác (trong Cài đặt → Vbee TTS)
- Script không quá dài — chia nhỏ nếu cần
- Vbee API poll tối đa 60 lần (2 phút) — script dài có thể vượt quá
Google Sheet “Không kết nối được”
Kiểm tra theo thứ tự:
- File JSON: Đường dẫn đến file Service Account
.jsonđúng - Sheet ID: Copy chính xác từ URL Sheet
- Quyền chia sẻ: Chia sẻ quyền Editor cho email trong file JSON
- Tên Sheet: Khớp chính xác tên tab (VD:
Sheet1, không phảisheet1)
Video output bị lỗi âm thanh
Nguyên nhân: Sai chế độ audio.
Cách khắc phục:
- Kiểm tra Priority Mode trong Cài đặt:
- Fit to Audio: Cắt video theo audio — audio mới thay thế hoàn toàn
- Keep Original: Giữ video gốc — chọn mode trộn audio phù hợp
Font không hiển thị đúng
Cách khắc phục:
- Đảm bảo file font nằm trong thư mục
assets/fonts/ - Font phải ở định dạng
.ttfhoặc.otf - Chọn lại font trong Cài đặt → Text 1 / Text 2
License hết hạn
- Kiểm tra ngày hết hạn: Cài đặt → Nâng Cao → License Info
- Liên hệ admin để gia hạn license
- App sẽ cảnh báo khi license còn ≤ 14 ngày
Đạt giới hạn hàng ngày
| Tier | Giới hạn |
|---|---|
| Free | 10 video/ngày |
| Pro | 50 video/ngày |
| Business | Không giới hạn |
Giới hạn reset mỗi ngày (UTC). Nâng cấp tier để xử lý nhiều hơn.
App bị crash khi xử lý nhiều video
Cách khắc phục:
- Giảm Max Concurrent xuống 1–2 trong Cài đặt → Nâng Cao
- Đóng các ứng dụng nặng khác
- Kiểm tra dung lượng ổ đĩa — output video cần nhiều dung lượng