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

Cài trên macOS

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

Cài trên Windows

1. Tải từ escbase.xyzBấm Tải bản Windows trên trang chính. Escbase 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 Escbase.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à Escbase và chỉ tiếp tục nếu file được tải trực tiếp từ escbase.xyz, 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ở Escbase 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 Escbase.
• Trial không giới hạn ngày: 3 render thành công, 720p, có watermark + outro Escbase, không batch. Render lỗi/hủy không mất lượt.
• Pro Tháng 30 ngày; Pro Năm 365 ngày. Tiếng Việt PayOS (49.000đ / 499.000đ), tiếng Anh PayPal ($5 / $20). Gia hạn thủ công — không tự trừ tiền.
• 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.
• Khách Template 3 claim một lần 30 ngày Pro ở mục Claim trên trang chủ bằng đúng email Google lúc mua.

Các bước

1. Giữ Escbase mởĐể app chạy trong lúc agent tạo dự án.
2. Mở Prompt tạo dự ánTrong Escbase vào Công cụ → Prompt tạo dự án.

   

3. Dán nội dungDán link bài hoặc kịch bản vào ô.
4. Copy prompt và gửi agentBấm Copy prompt, dán vào Cursor, Claude Code hoặc Codex rồi để agent chạy.
5. Xem dự án mớiKhi agent xong, quay lại Escbase. Nếu chưa thấy, bấm Làm mới.

Lưu ý

• Không cần biết code — agent tạo project giúp bạn.
• Sau khi có project, mở từ Tất cả dự án để xem trước và render.
• Project vẫn nằm trên máy khi hết lượt Trial hoặc hết hạn Pro.

Vòng preview thường gặp

1. Mở projectChọn trong Tất cả dự án trên dashboard.
2. Xem trước slideChạy thử caption và scene. Sửa chữ, timing hoặc asset lệch trước khi render.
3. Lưu tùy chọnNhà cung cấp giọng, tốc độ, tick outro/logo và kích thước render được nhớ cho lần sau (Trial vẫn khóa watermark và outro).

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ự.
2. Chọn Tải fileTrong khung giọng, chọn file MP3 hoặc WAV. Escbase mở hộp thoại hệ thống giống Finder / Explorer.
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 speech.
3. Tải fileTải MP3 về máy rồi dùng chế độ Tải file trong Escbase.

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 EscbaseDán API key và Voice ID trong Cài đặt / khung giọng, chọn ElevenLabs rồi tạo audio hoặc render.

Gemini API

1. Tạo key trong Google AI StudioMở API Keys, bấm 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 EscbaseMở Cài đặt / Quản lý API key → Gemini rồi dán key. Key chỉ lưu trên máy bạn.
3. Chọn giọng và tạo audioChọn Gemini trong khung giọng, chỉnh giọng/phong cách nếu cần, rồi tạo voiceover hoặc render.

Edge TTS

• Không cần API key. Chọn giọng Việt hoặc Anh rồi tạo audio.
• Máy vẫn cần mạng để Microsoft tạo giọng.
• Phù hợp render Trial đầu tiên, không mất phí Escbase.

Render một video

1. Giữ phiên đăng nhậpPhải đang đăng nhập Google. Nếu báo phiên Google không hợp lệ, đăng xuất rồi đăng nhập lại.
2. Bấm RenderKiểm tra giọng, kích thước và branding rồi bắt đầu render.
3. Xem video hoặc mở thư mụcKhi render xong và trạng thái Sẵn sàng, bấm Mở để xem video cuối, hoặc bấm File để mở thư mục chứa video.

   

Dừng khi chạy sai

• Dùng Dừng render nếu thấy lỗi — job hủy không mất lượt Trial.
• Tránh tắt cứng giữa chừng trừ khi app đóng băng; nên bấm Dừng để quyền export kết thúc sạch.

Trước khi upload

• Render thành công để có final_video.mp4.
• Xác nhận Pro đang active trên cùng tài khoản Google.
• Kết nối ít nhất một channel YouTube hoặc Page Facebook trong Upload Center.

Tài khoản

• YouTube: cấu hình một lần Client ID/Secret (Khoá OAuth), rồi Thêm channel.
• Facebook: Thêm Page và hoàn tất đăng nhập Meta.
• Có thể giữ nhiều channel/Page và Xoá từng dòng khi không dùng.

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 Escbase

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. Escbase 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 Escbase đă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 Escbase

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 Escbase.
• 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. Escbase đã 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 Escbase trả về để review.

App và phiên Google

• “Supabase không xác minh được phiên Google”: đăng xuất, đăng nhập lại rồi thử lại.
• Mua Pro trên web chưa thấy trong app: kiểm tra cùng tài khoản Google, đợi vài phút hoặc làm mới tài khoản.
• Lần mở đầu bị treo: kiểm tra mạng; cần HTTPS tới www.escbase.xyz để tải engine.

Âm thanh và render

• Lỗi ElevenLabs: kiểm tra quyền key (gồm Forced Alignment), Voice ID và credit còn lại.
• Lỗi Gemini: kiểm tra key AI Studio, đã chọn Gemini, và hạn free ~10 lượt TTS/ngày.
• Render kẹt 0%: phải đăng nhập và online để website cấp quyền export.

YouTube và Facebook

• redirect_uri_mismatch: dán đúng callback URI từ Escbase vào Google Cloud.
• YouTube invalid_grant: gỡ quyền Escbase cũ trong Google Account → Bảo mật rồi kết nối lại.
• Lỗi quyền Facebook: kiểm tra vai trò Page, trạng thái Live/tester và hạn token.