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

Tải và cài

1. Lấy installerVào www.escbase.xyz → phần Tải app, chọn Mac hoặc Windows. macOS cần Apple Silicon hoặc Intel, macOS 14+. Windows cần bản 64-bit, Windows 10+.
2. Cài trên macOSMở DMG, kéo Escbase vào Applications, rồi mở từ Applications. Gatekeeper có thể hỏi cho phép phần mềm Developer ID một lần.
3. Cài trên WindowsChạy file setup EXE. Nếu SmartScreen báo Windows đã bảo vệ PC, chọn Thông tin thêm → Chạy anyway — bản Escbase phát hành đã được ký.
4. Lần mở đầu tải engineInstaller app rất nhẹ. Lần mở đầu Escbase tải engine render (Python, Chromium, FFmpeg) vào thư mục dữ liệu app. Giữ mạng đến khi xong; các bản cập nhật sau thường chỉ cập nhật app.

Đăng nhập Google

• Render lỗi, hủy hoặc chạy dở không mất lượt Trial.
• Sau khi mua trên web, để app mở vài phút hoặc bấm làm mới để thấy Pro.
• Khách Template 3 claim một lần 30 ngày Pro tại /vi/claim bằng đúng email Google lúc mua.

1. Đăng nhập trong appChọn Continue with Google, hoàn tất trên tab trình duyệt rồi quay lại Escbase. Mua Pro trên web cũng phải cùng tài khoản Google đó.
2. Trial và ProTrial không giới hạn ngày: 3 render thành công, 720p, có watermark + outro Escbase, không batch. Pro Tháng 30 ngày; Pro Năm 365 ngày. Thanh toán tiếng Việt qua PayOS (99.000đ / 499.000đ), tiếng Anh qua PayPal ($5 / $20). Gia hạn thủ công — không tự trừ tiền.

Project xuất hiện thế nào

• Giữ Escbase mở để API local lắng nghe 127.0.0.1:8775.
• Trong app mở Công cụ và Copy prompt, hoặc dán prompt bên dưới vào agent.
• Agent ghi project vào thư mục projects trên máy. Nếu chưa thấy, bấm Làm mới trong Escbase.
• Mỗi project là một thư mục có index.html, kịch bản, asset và sau này output/final_video.mp4.

Dùng API của app Escbase đang mở để tạo một dự án mới từ nội dung sau [link/kịch bản,...]

Agent cần gì

• GET /api/agent từ app đang mở cho agent biết đường dẫn kit và tooling.
• Không bắt buộc biết code — sau khi có project, Dashboard và Preview Editor là đủ.
• 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).

Edge TTS

Giọng Microsoft có sẵn. Phù hợp render Trial đầu tiên, không cần API key.

• Chọn Edge TTS trong khung giọng.
• Chọn giọng Việt hoặc Anh rồi tạo audio.
• Không mất phí Escbase và không cần tài khoản ngoài.

Giọng Gemini

Dùng key Google AI Studio khi muốn TTS Gemini.

• Tạo API key tại Google AI Studio.
• Lưu trong Cài đặt Escbase mục Gemini.
• Tạo voiceover giống các nhà cung cấp khác.

Tải file giọng có sẵn

• Nếu đã có MP3/WAV, chọn file trong khung giọng.
• Trên desktop Escbase dùng hộp thoại hệ thống giống Finder / Explorer.

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. Có thể thấy cửa sổ Chromium nhỏ khi quay slide — đó là hành vi bình thường.
3. Lấy fileKhi job xong, mở project → output → final_video.mp4, hoặc dùng Watch trong app.

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.

Checklist Google Cloud

1. Tạo project CloudTrong Google Cloud Console, tạo project và bật YouTube Data API v3.
2. Cấu hình OAuth consentThêm chính bạn làm test user khi app đang Testing, hoặc publish consent khi dùng thật.
3. Tạo OAuth credentialsTạo OAuth client. Copy Client ID và Client Secret vào Escbase → Upload Center → Khoá OAuth.
4. Thêm channelChọn Thêm channel, hoàn tất Google consent, rồi chọn channel để upload.

Checklist Meta

1. Tạo Meta appTrên developers.facebook.com, tạo app phù hợp để đăng lên Page.
2. QuyềnCấp các quyền Page Escbase yêu cầu (thường dạng pages_manage_posts / pages_read_engagement). Đưa app Live hoặc thêm bạn làm tester.
3. Thêm Page trong EscbaseUpload Center → Thêm Page, đăng nhập Facebook và chọn Page.

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, Voice ID và credit còn lại.
• Lỗi Gemini: kiểm tra key AI Studio và đã chọn đúng nhà cung cấp Gemini.
• 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.