#5422 videotrans.configure.excepts.VideoTransError: Dubbing failed不存在参考音频，无法克隆:role='NamMinh(Male/VN)',wavfile='C:/Users/admin

The error indicates that the role 'NamMinh(Male/VN)' requires a reference audio file for voice cloning, but the software cannot find the file at the expected path.

Root cause:
You selected a voice-cloning role (likely from a TTS channel that supports cloning, e.g., Qwen-TTS, F5-TTS). For such roles, you must manually provide a reference audio file placed in the f5-tts folder and register it in the TTS settings. The software looks for a file named exactly NamMinh(Male/VN) (without .wav extension) inside the f5-tts directory, but it does not exist.

Solution steps:

1. Prepare a reference audio file

   • Create a clean WAV file (5–10 seconds long) with clear, single-speaker voice, no background noise.
   • Name it exactly NamMinh(Male/VN).wav (case-sensitive).
   • Copy it to the f5-tts folder inside the pyVideoTrans installation directory:
     C:/Users/admin/Documents/win-pyvideotrans-v4.03-0622/f5-tts/

2. Configure the reference audio in the software

   • Go to Menu → TTS Settings → Set reference audio.
   • Add a new line in the text area with the format:
     NamMinh(Male/VN).wav#The spoken text in this audio file
   • Click Save.

3. Select the role again

   • Back in the main interface, in the Voice role dropdown, choose NamMinh(Male/VN).wav (or the role name you just registered).
4. Re-run the task.

Alternative (if you don't need voice cloning):

• Choose a different role that does not require reference audio, e.g., a standard Edge-TTS or Azure TTS voice.

Please refer to the documentation:

• Voice cloning / multi-role dubbing
• How to use local reference audio

viết tiếgn việt

Lỗi này xảy ra khi bạn chọn một giọng đọc yêu cầu file âm thanh tham chiếu để clone giọng nói (ví dụ: NamMinh(Male/VN)), nhưng phần mềm không tìm thấy file đó trong thư mục f5-tts.

Nguyên nhân chính:
File âm thanh tham chiếu (định dạng .wav, dài 5-10 giây, giọng nói rõ ràng) chưa được đặt vào đúng thư mục hoặc chưa được đăng ký trong cài đặt.

Cách khắc phục:

1. Chuẩn bị file âm thanh tham chiếu

   • Tạo một file WAV chất lượng tốt, chỉ có một người nói, không tạp âm, độ dài 5-10 giây.
   • Đặt tên file chính xác (phân biệt hoa/thường): NamMinh(Male/VN).wav
   • Sao chép file vào thư mục:
     C:\Users\admin\Documents\win-pyvideotrans-v4.03-0622\f5-tts\

2. Đăng ký file tham chiếu trong phần mềm

   • Vào menu Công cụ → Cài đặt TTS → Thiết lập âm thanh tham chiếu

   • Thêm một dòng mới với cú pháp:

     NamMinh(Male/VN).wav#Nội dung lời nói trong file này

   • Nhấn Lưu.

3. Chọn lại giọng đọc

   • Quay lại giao diện chính, trong danh sách giọng đọc, chọn NamMinh(Male/VN).wav (hoặc tên bạn vừa đăng ký).
   • Chạy lại tác vụ.

Nếu bạn không cần clone giọng nói:
Hãy chọn một giọng đọc khác không yêu cầu file tham chiếu, ví dụ từ kênh Edge-TTS hoặc Azure TTS.

Tài liệu tham khảo:

• Hướng dẫn clone giọng nói / nhiều vai
• Cách sử dụng âm thanh tham chiếu cục bộ