Hỗ trợ
Khắc phục sự cố
Các lỗi thường gặp và cách sửa nhanh. Không thấy vấn đề của bạn? Báo lỗi từ Cài đặt → Giới thiệu.
Chung
Không có bản dịch, không hiện chữ
- macOS: kiểm tra đã bật quyền Screen & System Audio Recording chưa, rồi mở lại app.
- Kiểm tra API key của engine đang chọn trong Cài đặt → Engine dịch; bấm Test để xác nhận kết nối.
- Đảm bảo đang thực sự có âm thanh phát trên máy, và nguồn âm thanh (Hệ thống / Mic / Cả hai) đúng với thứ bạn muốn dịch.
Lỗi “No API key” hoặc “Invalid API key”
Vào Cài đặt → Engine dịch và dán key của engine đang chọn (cách lấy key). Với Soniox, key cần quyền Temporary API keys và nhận giọng thời gian thực; thiếu quyền, app hiện thông báo riêng.
Chi phí cao hơn dự tính
Kiểm tra engine đang dùng: OpenAI Realtime khoảng $4/giờ so với Soniox khoảng $0.12/giờ. Bật Cảnh báo phiên dài để app hỏi dừng khi im lặng lâu.
Lỗi “No microphone found”
Máy không có micro tích hợp (ví dụ Mac mini). Cắm micro ngoài: USB, tai nghe hoặc AirPods.
OpenAI Realtime
Lựa chọn engine bị mờ
Chưa nhập key OpenAI hoặc key sai định dạng (phải bắt đầu bằng sk-). Dán key mới rồi bấm Test.
Nút “Two-way” biến mất
Đây là hành vi đúng: OpenAI Realtime không hỗ trợ dịch hai chiều. Dùng Soniox (hoặc Local trên Mac Apple Silicon) nếu cần.
Qwen: lỗi WebSocket error
| Triệu chứng | Nguyên nhân thường gặp | Cách sửa |
|---|---|---|
Báo WebSocket error ngay khi bấm Bắt đầu | Key tạo ở vùng khác Singapore | Tạo lại key ở vùng Singapore (xem cách) |
| Báo lỗi sau khoảng 5–10 giây | Key đúng vùng nhưng chưa bật model Qwen Live | Model Studio → Model Square → bật qwen3-livetranslate-flash-realtime |
| Dịch được một câu rồi dừng | Ngôn ngữ nguồn để tự nhận diện | Chọn rõ ngôn ngữ nguồn trong Source (ví dụ Japanese) |
| Lỗi không ổn định | Mạng chặn dashscope-intl.aliyuncs.com (tường lửa công ty, VPN) | Thử mạng khác (4G/5G) hoặc tắt VPN |
Windows
SmartScreen chặn bộ cài
Bấm More info → Run anyway. Xem Cài đặt trên Windows.
Không bắt được âm thanh hệ thống
Đảm bảo đang phát âm thanh trên PC. Một số ứng dụng dùng chế độ âm thanh độc quyền (exclusive mode) — thử nguồn âm thanh khác.
Ứng dụng không mở
Đảm bảo đã cài WebView2 Runtime. Windows 10/11 thường có sẵn; bản cũ cần cài từ Microsoft.
Chụp màn hình để dịch báo thiếu gói OCR
Thông báo “Windows chưa có gói OCR cho ngôn ngữ này…” nghĩa là cần cài gói ngôn ngữ. Xem Gói ngôn ngữ OCR.
Dịch nhanh và OCR trên macOS
F2 dịch nội dung clipboard thay vì chữ đang bôi đen
MiuWave chưa có quyền Trợ năng. Bấm Mở cài đặt trong cửa sổ Dịch nhanh và bật MiuWave (xem cách).
F3 báo “Cần quyền Ghi màn hình…”
Bấm Mở cài đặt, bật MiuWave trong Ghi màn hình và âm thanh hệ thống, rồi mở lại app.
Giọng đọc (TTS)
- Không có tiếng? Kiểm tra nút Đọc bản dịch đã bật, âm lượng hệ thống và Thiết bị phát.
- Nút TTS bị mờ? Bạn đang dịch hai chiều, hoặc dùng OpenAI Realtime / Qwen.
- Edge TTS không chạy? Kiểm tra kết nối internet.
- Google TTS lỗi? Kiểm tra key đúng và đã bật Text-to-Speech API.
- Giọng đọc bị micro thu lại? Giảm âm lượng TTS, phát qua tai nghe, hoặc tạm dừng phiên khi đang đọc.
Local MLX
Sau một số bản cập nhật, app yêu cầu chạy lại cài đặt Local để thêm thành phần mới; model đã tải được dùng lại, không phải tải lại 5 GB. Local chỉ chạy trên Mac Apple Silicon — trên Windows hoặc Mac Intel, dùng SenseVoice để dịch offline.