SoulDub Video Translate Skill

Skill giúp Agent:

• Tải video .mp4 cục bộ lên SoulDub.
• Tạo tác vụ dịch video.
• Theo dõi tiến trình dịch có thời gian chạy dài.
• Tải video đã dịch và phụ đề xuống.

Sau khi chạy thành công, các tệp sau được lưu:

• result.mp4: video đã dịch
• translated.srt: phụ đề ngôn ngữ đích
• bilingual.srt: phụ đề song ngữ

Cài đặt từ kho GitHub công khai:

npx skills add jiabaogithub/souldub-skills --skill souldub-video-translate

Sau khi cài đặt, yêu cầu Agent chạy Skill với đường dẫn MP4 cục bộ và ngôn ngữ đích:

Use the souldub-video-translate skill to translate C:\path\to\video.mp4 into Japanese.

Skill cũng chấp nhận tên ngôn ngữ được hỗ trợ như Japanese, Chinese, tiếng Nhật, tiếng Trung và tiếng Quảng Đông.

Agent sẽ hỏi các thông tin còn thiếu, bắt đầu dịch, báo cáo tiến trình và trả về đường dẫn tệp đầu ra cục bộ khi tác vụ hoàn tất.

Skill yêu cầu một API key SoulDub.

Sau khi cài đặt, yêu cầu Agent kiểm tra trạng thái xác thực:

uv run scripts/video_translation.py auth status

Nếu chưa cấu hình API key, Skill sẽ tạo tệp cấu hình cấp người dùng sau:

~/.souldub/souldub.config.yaml

Đặt souldub_api_key trong tệp đó hoặc đặt biến môi trường SOULDUB_API_KEY.

• Python 3.11+
• uv
• Kết nối mạng tới SoulDub Agent API
• API key SoulDub
• Quyền đọc tệp MP4 nguồn
• Quyền ghi vào thư mục đầu ra

Các tệp Skill đã cài đặt được xử lý ở chế độ chỉ đọc.

Trạng thái chạy được lưu trong thư mục trạng thái của nền tảng người dùng. Kết quả dịch mặc định nằm trong thư mục souldub_outputs/ cạnh video nguồn.

Skill không lưu lâu dài API key, URL tải lên có chữ ký, URL cổng phương tiện hoặc tham số chữ ký tạm thời.

Cấu trúc kho:

skills/
└── souldub-video-translate/

Từ thư mục gốc của kho, hãy kiểm tra khả năng phát hiện cục bộ:

npx skills add . --list

Cài đặt bản sao làm việc cục bộ:

npx skills add . --skill souldub-video-translate

Chạy trực tiếp helper để gỡ lỗi cục bộ:

cd skills/souldub-video-translate
uv run scripts/video_translation.py auth status