Hướng dẫn sử dụng FastScene

Cài trên macOS

1. Tải đúng bản macOSFastScene hỗ trợ Apple Silicon và Intel, yêu cầu macOS 14 trở lên.
2. Mở file DMGKéo FastScene vào Applications, sau đó mở ứng dụng như bình thường.

Cài trên Windows

1. Tải từ fastscene.appBấm Tải bản Windows trên trang chính. FastScene hỗ trợ Windows 10/11 64-bit.
2. Giữ file trong Microsoft EdgeVì bản Windows hiện chưa có chữ ký xác minh nhà phát hành, Edge có thể báo file không thường được tải. Mở dấu ba chấm cạnh file, chọn Keep/Giữ. Nếu hiện hộp xác nhận, mở mũi tên cạnh Delete/Xóa rồi chọn Keep anyway/Vẫn giữ.

   

   

3. Mở file cài đặtChạy FastScene.exe. Khi SmartScreen hiện Windows protected your PC, bấm More info/Thông tin thêm.

   

4. Chọn Run anywayKiểm tra tên app là FastScene và chỉ tiếp tục nếu file được tải trực tiếp từ fastscene.app, sau đó bấm Run anyway/Vẫn chạy.

   

5. Cài và tải engineHoàn tất trình cài đặt, mở FastScene rồi giữ mạng ổn định trong lần đầu để bộ cài nhẹ tải engine video phù hợp.

   

Đăng nhập và license

• Đăng nhập bằng đúng tài khoản Google đã dùng để mua hoặc gia hạn FastScene.
• Bản dùng thử có 5 lượt xuất video thành công; dự án vẫn nằm trên máy sau khi dùng hết lượt.
• License Pro dùng trên 1 thiết bị. Dự án tùy chỉnh là add-on mua một lần, tách khỏi gói Pro so sánh.
• Nếu mua hoặc gia hạn trên web khi app vẫn mở, license thường tự cập nhật trong khoảng 5 phút; không cần đăng xuất rồi đăng nhập lại.

Dự án so sánh

1. Đặt tên dự ánDùng tên ngắn, dễ nhận biết. FastScene tạo thư mục riêng và tự lưu thay đổi.
2. Dán kịch bảnMỗi dòng được xem là một nhịp đọc. Giữ câu ngắn, rõ và xuống dòng ở vị trí muốn chuyển nhịp.
3. Chọn nhân vậtDùng nhân vật có sẵn hoặc nhân vật riêng nếu tài khoản đã được mở khóa.
4. Tạo nội dungMỗi mục so sánh có nhãn, màu nhãn, ảnh/video hai bên và điểm bắt đầu trong kịch bản.

Dự án tùy chỉnh

1. Mở khóa add-onTài khoản cần quyền Dự án tùy chỉnh. Quyền này được mua một lần và dùng cùng tài khoản FastScene.
2. Làm theo từng slideMỗi slide có thể chứa tiêu đề, nhiều lớp chữ, ảnh hoặc video, hiệu ứng, âm thanh và nền riêng.
3. Tái sử dụng thiết lậpSlide mới kế thừa cấu hình phù hợp từ slide trước để bạn không phải chỉnh lại font, nhãn và hiệu ứng từ đầu.

Editor so sánh

• Nhập nhãn chính, nhãn phụ, màu và font cho từng cặp so sánh.
• Bấm Thay ảnh/video, hoặc dán ảnh bằng ⌘V trên macOS và Ctrl+V trên Windows.
• Dùng Zoom, Crop/xoay và Xóa nền để đặt chủ thể đúng khung 9:16.
• Bấm + Thêm so sánh để tạo một cặp mới; + Thêm ảnh đơn khi một cảnh chỉ cần một hình.
• Trong tab Pose & âm thanh, chọn dáng nhân vật và hiệu ứng âm thanh cho điểm nhấn của từng cảnh.

Editor dự án tùy chỉnh

• Kéo trực tiếp chữ, ảnh và phụ đề trên preview để đặt đúng vị trí.
• Một slide có thể có nhiều lớp chữ; dùng + Thêm chữ để bổ sung chú thích.
• Chọn hiệu ứng và âm thanh ngay dưới từng box nội dung; dùng + Thêm slide để mở rộng video.
• Nền video có thể là màu, ảnh hoặc video tùy theo bố cục bạn đang làm.

Tải file voiceover có sẵn

1. Tạo một file đầy đủAudio phải đọc toàn bộ kịch bản theo đúng thứ tự dòng.
2. Chọn Voice File/API → Tải fileBấm Chọn file và đưa MP3, WAV hoặc định dạng âm thanh được app hỗ trợ vào.
3. Kiểm tra phụ đềKaraoke khớp từng từ cần ElevenLabs API key với 3 quyền Access ở ô nổi bật phía trên.

ElevenLabs thủ công

1. Mở Text to SpeechĐăng nhập ElevenLabs và mở công cụ Text to Speech.
2. Dán toàn bộ kịch bảnChọn giọng Việt phù hợp, nghe thử, chọn model rồi Generate.
3. Tải fileTải MP3 về và dùng chế độ Tải file trong FastScene.

ElevenLabs API

1. Tạo API keyLàm theo ô nổi bật ở đầu phần này: Developers → API Keys, bật 3 quyền Access đầu tiên.
2. Lấy Voice IDTrong Voice Library, mở menu của giọng muốn dùng rồi chọn Copy voice ID.
3. Lưu trong FastSceneMở Quản lý API key, thêm key ElevenLabs, dán Voice ID rồi chọn ElevenLabs API trước khi render.

Gemini API

1. Tạo key trong Google AI StudioMở API Keys, chọn Create API key rồi sao chép key mới. Không đăng key công khai hoặc gửi cho người khác.

   

2. Thêm key vào appTrên Dashboard chọn Quản lý API key → Gemini → Thêm key. FastScene cho phép lưu nhiều key và luân chuyển khi gặp lỗi quyền hoặc hết quota.
3. Chỉnh giọng đọcChọn giọng Gemini, phong cách đọc, nhịp, accent và độ ngẫu hứng trong Cài đặt nâng cao.
4. RenderChọn Gemini API rồi Bắt đầu render. Việc tạo voiceover xảy ra trước bước dựng hình và ghép video. Karaoke khớp từng từ vẫn cần ElevenLabs key như ô nổi bật phía trên.

Vbee API và Edge TTS

• Vbee: tạo App ID + Token trong Vbee Studio, nhập mã giọng, tốc độ và chọn Batch hoặc Realtime. Batch xử lý cả kịch bản; Realtime tạo theo đoạn rồi ghép lại.
• Edge TTS: không cần nhập API key. Chọn giọng và tốc độ rồi render; máy vẫn cần kết nối mạng để dịch vụ tạo giọng hoạt động.
• Tùy chọn Tạo lại audio cache chỉ nên bật khi bạn muốn bỏ file giọng cũ và tạo lại từ đầu.

Render một dự án

1. Chọn dự ánBấm vào dự án trên Dashboard để đưa nó vào Bộ máy render.
2. Chọn nguồn âm thanhChọn đúng Tải file, Gemini, ElevenLabs, Vbee hoặc Edge TTS và kiểm tra cấu hình nâng cao.
3. Bắt đầu renderTheo dõi phần trăm và log. Không đóng app trong khi job đang chạy.
4. Mở kết quảKhi hoàn tất, bấm File hoặc Mở. Video cuối nằm trong thư mục output với tên final_video.mp4.

Render hàng loạt

• Đánh dấu nhiều dự án hoặc Chọn tất cả, sau đó chạy hàng đợi render.
• Render hàng loạt không dùng chế độ tải file audio thủ công; hãy lưu Gemini, ElevenLabs API, Vbee hoặc Edge TTS cho dự án trước.
• Nếu một job lỗi, đọc dòng lỗi cuối cùng để biết đang vướng API giọng đọc, ảnh/video nguồn hay bước dựng video.

Chuẩn bị nội dung đăng

• Dòng đầu của caption được dùng làm tiêu đề YouTube.
• Toàn bộ caption được dùng cho Facebook và mô tả YouTube; bạn có thể sửa riêng trước khi đăng.
• Link nguồn Facebook nằm ở ô Comment nguồn, không chèn thẳng vào caption Reel.
• Chọn Publish now/Public để đăng ngay, hoặc chọn lịch đăng cho từng nền tảng.

Đăng đồng thời

1. Kết nối cả hai nền tảngThêm ít nhất một Facebook Page và một YouTube channel.
2. Kiểm tra trạng tháiNút đăng chỉ sáng khi dự án có video và tài khoản nền tảng đã sẵn sàng.
3. Upload Facebook + YouTubeApp đăng Facebook trước, sau đó YouTube. Giữ app mở cho tới khi cả hai hoàn tất.

1. Tạo Meta app

1. Mở My AppsĐăng nhập Meta for Developers → My Apps → Create App.
2. Chọn use case quản lý PageLọc Content management rồi chọn Manage everything on your Page. Đây là use case để đăng nội dung và video lên Page.

   

3. Chọn Business portfolioChọn portfolio đang quản lý Page. Nếu chưa cần gắn, chọn tùy chọn không kết nối rồi tiếp tục tạo app.

   

4. Tạo app rồi CustomizeHoàn tất tên app, email liên hệ, tạo app. Trên dashboard app, mở Customize/Add use cases nếu Meta hỏi thêm.

   

2. Thêm quyền Page

1. Add đúng nhóm quyềnTrong Use cases/App Review, thêm pages_show_list, pages_read_engagement, pages_read_user_content, pages_manage_posts, pages_manage_metadata và pages_manage_engagement. public_profile thường đi kèm đăng nhập Meta.

   

3. Lấy Page access token

1. Mở Graph API ExplorerVào Graph API Explorer, chọn đúng Meta app ở đầu trang.

   

2. Get User Access TokenBấm Get User Access Token, đánh dấu các quyền Page rồi Generate Access Token.

   

3. Chọn đúng PageTrong cửa sổ cấp quyền, chọn đúng Page muốn kết nối, cho phép các quyền và hoàn tất.

   

4. Đổi sang Page tokenQuay lại Graph API Explorer, ở mục User or Page hãy chọn Page rồi Generate Access Token lần nữa.

   

5. Kiểm tra đủ quyềnDanh sách permission trên Explorer phải hiện đủ nhóm quyền Page. Hiện đủ là dùng được.

   

6. Extend tokenCopy token → Access Token Debugger → dán → Debug → kéo xuống Extend Access Token. Copy lại token đã extend. Báo hết hạn khoảng 3 tháng là bình thường; hết hạn thì extend tiếp.

   

4. Lưu Page trong FastScene

1. Lưu Page ID và tokenTrong Upload Center, bấm Thêm Page, dán Page ID + Page access token đã extend rồi bấm Lưu Page. Token chỉ lưu trên máy và không hiện lại.
2. Chọn trạng tháiChọn Draft, Publish now hoặc lịch đăng. FastScene dùng PUBLISHED khi đăng ngay và SCHEDULED khi lên lịch.
3. Caption và nguồnFacebook Reel dùng caption, không có title riêng. Link nguồn nằm ở ô Comment nguồn và chỉ gửi sau khi Reel đã publish.
4. Thêm Page khácLặp lại với Page ID/token tương ứng. Mỗi nhân vật có thể ghi nhớ Page đã chọn.

5. Đưa app sang Live

App còn Development/Testing thì thường chỉ admin, developer hoặc tester đăng được. Muốn FastScene đăng Reels cho Page thật, app phải Live. Có thể xem video trước, rồi làm theo từng bước bên dưới.

1. Tạo URL chính sách quyền riêng tưMeta bắt buộc có Privacy Policy URL. Có thể tạo trang miễn phí (ví dụ freeprivacypolicy.com như trong video), copy link hosted, rồi dán vào Meta.

   

2. Dán URL vào màn ĐăngMở Đăng (Go Live). Dán URL chính sách quyền riêng tư. Kiểm tra use case Quản lý mọi thứ trên Trang đang có trên app.

   

3. Bấm Đăng khi app còn UnpublishedSidebar Đăng đang hiện Đã hủy đăng. Bấm Đăng, hoàn tất các mục Meta còn thiếu, rồi public app.

   

4. Kiểm tra Đã đăngKhi xong, mục Đăng đổi thành Đã đăng. Từ đây app Live có thể đăng Reels cho Page ngoài tài khoản tester, tùy quyền Meta còn yêu cầu App Review hay không.

   

6. Lỗi thường gặp

• OAuthException hoặc invalid token: token hết hạn, sai Page hoặc thiếu quyền; tạo/extend lại Page token.
• Không publish được: kiểm tra tài khoản có quyền tạo nội dung trên Page, app đã Live và đã có đủ quyền.
• Comment nguồn lỗi: Reel có thể chưa xử lý xong; chờ Reel publish rồi bấm Comment nguồn lại.

1. Chuẩn bị Google Cloud project và API

1. Tạo projectMở Google Cloud Console, chọn tên project ở thanh trên cùng → New Project, đặt tên dễ nhận biết rồi Create. Bạn cũng có thể dùng một project đang có.

   

2. Mở API LibraryTrong project vừa chọn, vào APIs & Services → Library.

   

3. Tìm YouTube Data API v3Tìm đúng YouTube Data API v3, mở Product details rồi bấm Enable.

   

2. Cấu hình OAuth consent screen

1. Bắt đầu cấu hìnhVào APIs & Services → OAuth consent screen → Get Started.

   

2. Điền thông tin appNhập App name, User support email và Developer contact email.
3. Chọn AudienceChọn External nếu kết nối bằng tài khoản Google thông thường hoặc tài khoản ngoài tổ chức.
4. Thêm tài khoản thửKhi Publishing status còn là Testing, vào Audience → Test users và thêm chính xác email Google sẽ kết nối YouTube.
5. Chuyển In productionKhi cấu hình đã hoạt động, chuyển Publishing status sang In production. App External còn ở Testing thường có refresh token chỉ dùng khoảng 7 ngày.

3. Tạo OAuth Client ID

1. Mở ClientsTrong Google Auth Platform, vào Clients → Create Client.
2. Chọn Web applicationĐặt tên client, sau đó chọn Application type là Web application.
3. Thêm callbackTrong Authorized redirect URIs, dán nguyên địa chỉ bên dưới rồi Create.
4. Lưu khóaSao chép Client ID và Client Secret. Đây là thông tin riêng, không đăng công khai hoặc gửi cho người lạ.

http://localhost:8765/api/social/youtube/callback

4. Kết nối channel trong FastScene

1. Chọn dự án đã renderMở Upload Center và chọn dự án đã có output/final_video.mp4.
2. Nhập OAuth keyBấm Thêm channel hoặc OAuth key, dán Client ID + Client Secret, kiểm tra callback rồi bấm Lưu và kết nối.
3. Cho phép quyền YouTubeTrình duyệt sẽ mở Google OAuth. Đăng nhập đúng tài khoản có quyền upload lên channel và chấp nhận quyền được yêu cầu.
4. Thiết lập videoChọn channel, kiểm tra title, description, quyền riêng tư public/unlisted/private hoặc giờ đăng rồi bấm Upload YouTube.

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

• redirect_uri_mismatch: URI trong Google Cloud phải giống tuyệt đối callback localhost:8765 hiển thị trong FastScene.
• Google không trả refresh_token: vào Google Account → Security → Third-party access, gỡ quyền app cũ rồi Thêm channel lại. FastScene đã dùng access_type=offline và prompt=consent.
• invalid_grant hoặc Token expired/revoked: kết nối lại channel. Nếu lỗi lặp lại sau khoảng 7 ngày, kiểm tra consent screen còn ở Testing hay chưa.
• Tài khoản khác không đăng nhập được: thêm email đó vào Test users hoặc chuyển app sang In production; Google có thể yêu cầu verification tùy phạm vi sử dụng.
• Upload xong chưa public: kiểm tra tùy chọn private/unlisted và mở link YouTube Studio FastScene trả về để review.

Âm thanh và API

• Gemini báo 401/403/429: kiểm tra key, quota (~10 lượt TTS/ngày với free), billing và quyền; có thể thêm key khác trong Quản lý API key.
• Karaoke lệch khi dùng audio ngoài/Gemini/Vbee: thêm ElevenLabs key với 3 quyền Access đầu tiên (Text to Speech, Forced Alignment, Voice Generation) và giữ kịch bản khớp với lời đọc.
• Vbee không chạy: kiểm tra App ID, Token, mã giọng, chế độ Batch/Realtime và độ dài kịch bản.

YouTube và Facebook

• YouTube redirect_uri_mismatch: sao chép lại đúng callback localhost:8765 từ FastScene vào Google Cloud.
• YouTube invalid_grant: token đã hết hạn hoặc bị thu hồi; gỡ quyền cũ trong Google Account rồi Thêm channel lại.
• Facebook lỗi quyền: token có thể sai Page, thiếu pages_manage_posts hoặc app chưa được phép dùng ngoài tester/admin.
• Facebook token hết hạn: extend hoặc tạo Page token mới, sau đó mở Thêm Page và lưu lại.

App, license và dự án

• Mua/gia hạn trên web nhưng chưa thấy Pro: đảm bảo web và app dùng cùng Google account, giữ app mở tối đa khoảng 5 phút rồi bấm Làm mới.
• Không mở được Upload Center: dự án cần final_video.mp4 và tài khoản Pro còn hiệu lực.
• Preview chưa đổi: chờ trạng thái tự lưu, sau đó chuyển câu hoặc bấm Làm mới; tránh đóng app ngay khi vừa sửa.
• Không tìm thấy video: bấm File/Mở ở dòng dự án và kiểm tra thư mục output.