Hướng dẫn sử dụng Semi-Reup Studio

Công cụ chạy trên máy tính của bạn: lấy ý tưởng từ một video YouTube → AI viết thành kịch bản mới → lồng tiếng AI → tự động ghép hình ảnh, phụ đề và xuất video MP4 hoàn chỉnh.

1. Giới thiệu

Mỗi dự án tương ứng với 1 video gốc và cho ra 1 video mới. Quy trình gồm 5 bước. Bạn có thể bấm Chạy toàn bộ để tool tự làm hết, hoặc chạy và chỉnh sửa từng bước.

• Không cần database: mọi dữ liệu lưu thành file trong thư mục data, có thể copy để sao lưu.
• Chạy hoàn toàn trên máy bạn tại địa chỉ http://localhost:3210. API key chỉ lưu trên máy bạn.
• Dùng được miễn phí: giọng đọc Microsoft Edge và ảnh Openverse không cần key. Chỉ bước AI viết lại cần 1 API key (Gemini và Groq đều có gói miễn phí).

2. Cài đặt lần đầu

Yêu cầu

• Windows 10/11 (macOS và Linux cũng chạy được bằng lệnh npm start).
• RAM 4GB trở lên, còn trống khoảng 2GB ổ cứng. Mạng internet ổn định.

1. Cài Node.js: vào nodejs.org, tải bản LTS và cài như phần mềm thông thường (cứ bấm Next).
2. Giải nén thư mục tool ra một vị trí cố định, ví dụ D:\Semi-Reup-Studio. Nên chọn đường dẫn không có dấu tiếng Việt.
3. Nháy đúp file start.bat. Ở lần chạy đầu, file này sẽ tự động:
   • cài FFmpeg (phần mềm dựng video) qua winget nếu máy chưa có;
   • cài các thư viện cần thiết (khoảng 1 phút);
   • mở trình duyệt tới http://localhost:3210.
4. Ở những lần sau, chỉ cần nháy đúp start.bat. Giữ cửa sổ đen mở trong lúc dùng tool. Đóng cửa sổ đó là tắt tool.

Để kiểm tra, vào Cài đặt & API key → mục Trạng thái hệ thống. Node.js, FFmpeg và yt-dlp đều phải có dấu ✅. Riêng yt-dlp (công cụ lấy dữ liệu YouTube) sẽ tự tải ở lần dùng đầu tiên.

3. Lấy API key

Vào menu Cài đặt & API key, dán key vào ô tương ứng, rồi bấm Lưu cài đặt. Chỉ cần 1 key AI là đủ chạy. Các key khác dùng để có thêm lựa chọn.

4. Tạo dự án

Trang Dự án hiển thị toàn bộ video bạn đã làm. Thanh 5 vạch màu dưới mỗi thẻ cho biết tiến độ: xanh lá là đã xong, tím là đang chạy, đỏ là bị lỗi.

Bấm Tạo dự án → dán link YouTube (hỗ trợ youtube.com/watch, youtu.be, Shorts) → bấm Tạo dự án. Nếu tích Tự động chạy toàn bộ 5 bước, tool sẽ làm hết, bạn chỉ việc chờ lấy video.

5. Bước 1 – Lấy kịch bản

Tool đọc thông tin video và lấy toàn bộ lời thoại:

• Video có phụ đề (chính thức hoặc tự động): lấy ngay trong vài giây, miễn phí.
• Video không có phụ đề: tool tải phần âm thanh về rồi chuyển giọng nói thành văn bản bằng dịch vụ bạn chọn (Groq Whisper, OpenAI Whisper hoặc Gemini). Bước này cần API key của dịch vụ đó.

6. Bước 2 – AI viết lại kịch bản

Chọn nhà cung cấp AI, ngôn ngữ đầu ra, phong cách và độ dài, rồi bấm AI viết lại. AI sẽ viết một kịch bản mới hoàn toàn: đổi cấu trúc, viết câu mở đầu mới, dùng từ ngữ riêng, thêm góc nhìn và chia thành từng cảnh. Mỗi cảnh kèm từ khoá tiếng Anh để bước 4 tìm hình minh hoạ.

Sau khi AI viết xong, bạn nên đọc lại và chỉnh sửa ngay trên giao diện: sửa lời từng cảnh, thêm hoặc xoá cảnh, đổi từ khoá tìm hình. Xong thì bấm Lưu kịch bản. Cảnh nào bị sửa lời sẽ được tạo lại giọng đọc ở bước 3.

7. Bước 3 – Giọng đọc AI

8. Bước 4 – Hình ảnh & video minh hoạ

Tool tự tìm hình ảnh hoặc video theo từ khoá của từng cảnh, chỉ lấy từ các nguồn miễn phí bản quyền:

• Pexels / Pixabay: video stock HD đẹp nhất. Cần key miễn phí.
• Openverse: ảnh public domain (CC0), không cần key. Ảnh tĩnh sẽ được thêm hiệu ứng zoom/lia máy chậm (Ken Burns) cho sinh động.
• Tự tải lên: bấm ⬆ Thay ở từng cảnh để dùng hình hoặc video của chính bạn. Media tự tải lên sẽ được giữ nguyên khi chạy lại bước này.

9. Bước 5 – Dựng video

Chọn khung hình (16:9 cho YouTube, 9:16 cho Shorts/TikTok/Reels), chất lượng, kiểu phụ đề, nhạc nền và logo kênh, rồi bấm Dựng video.

Kết quả nhận được

• final.mp4: video hoàn chỉnh
• subtitles.srt: phụ đề, có thể tải lên YouTube làm CC
• youtube-info.txt: tiêu đề, mô tả, tags và danh sách nguồn hình ảnh

Bấm 📂 Thư mục để mở nhanh thư mục chứa các file trên.

Nhạc nền & logo

Tải lên ở Cài đặt → Nhạc nền & logo. Nhạc nền tự lặp lại, nhỏ dần ở cuối video. Logo nên là file PNG nền trong suốt.

10. Tạo hàng loạt

Vào Tạo dự án → Hàng loạt, dán nhiều link (mỗi dòng 1 link) rồi bấm Tạo & chạy hàng loạt. Mỗi link thành 1 dự án và được xử lý lần lượt theo hàng đợi, dùng thiết lập mặc định. Trong lúc chờ, bạn vẫn thao tác bình thường. Ô ở góc dưới bên trái cho biết số dự án đang xử lý.

11. Dữ liệu & sao lưu

Tool không dùng database. Mọi thứ nằm trong thư mục data:

data/
├── settings.json              ← API key + thiết lập mặc định
├── assets/                    ← nhạc nền, logo đã tải lên
└── projects/
    └── 20261006-55af68/       ← mỗi dự án 1 thư mục
        ├── project.json       ← kịch bản, trạng thái, nhật ký
        ├── audio/             ← giọng đọc từng cảnh
        ├── media/             ← hình/video từng cảnh
        └── output/            ← final.mp4, subtitles.srt, youtube-info.txt

• Sao lưu: copy cả thư mục data sang nơi khác.
• Chuyển sang máy khác: copy thư mục data vào tool trên máy mới.
• Dọn ổ cứng: xoá dự án cũ ngay trên giao diện (nút 🗑), hoặc xoá thư mục dự án trong data/projects.
• Có thể mở settings.json và project.json bằng Notepad để xem hoặc sửa. Nhớ tắt tool trước khi sửa tay.

12. Lưu ý chính sách YouTube

YouTube xét duyệt bật kiếm tiền (YPP) rất kỹ ở mục “Nội dung dùng lại” (Reused content). Tool đã đi theo hướng an toàn: không dùng lại hình ảnh hay âm thanh của video gốc, mà chỉ lấy ý tưởng rồi tạo nội dung mới. Để kênh phát triển bền vững, bạn nên:

• Thêm giá trị riêng: đọc lại kịch bản AI, thêm nhận định, ví dụ, trải nghiệm của bạn. Video không nên chỉ là bản tóm tắt.
• Tổng hợp nhiều nguồn: kết hợp ý từ nhiều video hoặc bài viết thay vì bám theo một video duy nhất.
• Kiểm tra lại thông tin: AI đôi khi viết sai số liệu. Hãy kiểm tra các chi tiết quan trọng.
• Dùng hình ảnh đúng bản quyền: nguồn stock trong tool đều miễn phí bản quyền. Danh sách nguồn có sẵn trong youtube-info.txt nếu bạn muốn ghi credit.
• Nhạc nền: chỉ dùng nhạc bạn có quyền sử dụng, ví dụ Thư viện âm thanh YouTube.
• Nội dung do AI tạo: khi đăng video có giọng đọc AI, hãy bật mục khai báo nội dung tổng hợp/chỉnh sửa trong YouTube Studio nếu YouTube yêu cầu.

13. Xử lý lỗi thường gặp

Khi có lỗi, dự án hiện khung đỏ kèm nội dung lỗi, và phần Nhật ký xử lý ở cuối trang ghi chi tiết. Sửa xong, bấm chạy lại đúng bước bị lỗi, không cần làm lại từ đầu.

14. Cấu trúc thư mục (dành cho người muốn tuỳ biến)

Semi-Reup-Studio/
├── start.bat                 ← nháy đúp để chạy
├── package.json
├── bin/                      ← yt-dlp.exe (tự tải), có thể đặt ffmpeg.exe ở đây
├── data/                     ← dữ liệu của bạn (xem mục 11)
├── docs/                     ← file hướng dẫn này
├── public/                   ← giao diện (HTML/CSS/JS thuần, không cần build)
└── src/
    ├── server.js             ← máy chủ web + API
    ├── config.js             ← cổng, đường dẫn, thiết lập mặc định
    ├── storage.js            ← đọc/ghi file JSON thay database
    ├── job-runner.js         ← hàng đợi xử lý nền
    ├── modules/
    │   ├── extract.js        ← Bước 1: phụ đề / chuyển giọng nói
    │   ├── ai-providers.js   ← kết nối các AI (thêm nhà cung cấp mới ở đây)
    │   ├── rewrite.js        ← Bước 2: prompt & phong cách viết
    │   ├── tts.js            ← Bước 3: giọng đọc
    │   ├── visuals.js        ← Bước 4: tìm hình ảnh stock
    │   └── render.js         ← Bước 5: dựng video bằng FFmpeg
    └── utils/                ← phụ đề, chạy FFmpeg/yt-dlp, client Edge TTS

• Đổi prompt hoặc thêm phong cách viết: sửa STYLES và SYSTEM_PROMPT trong src/modules/rewrite.js.
• Thêm model AI vào danh sách gợi ý: sửa LLM_PROVIDERS trong src/modules/ai-providers.js. Bạn cũng có thể gõ thẳng tên model bất kỳ vào ô Model trên giao diện.
• Đổi thiết lập mặc định ban đầu: sửa DEFAULT_SETTINGS trong src/config.js.

Semi-Reup Studio · Phiên bản 1.0