Ma Trận Sức Khỏe Dịch Vụ TTS Đang quét...
Kiểm tra liveness, độ trễ phản hồi và trạng thái hoạt động của các dịch vụ TTS đang mở.
Quản Lý Hồ Sơ Cá Nhân Hóa (Profiles)
Từng Kiosk Tanita, Phòng khám, Lễ tân hoặc Loa POS có cấu hình giọng, fallback và từ điển riêng biệt.
Kho Khóa API Đa Nhà Cung Cấp (Key Vault)
Nạp nhiều khóa miễn phí hoặc có phí. Bật/tắt dịch vụ linh hoạt và tự động xoay key khi gặp lỗi 429.
Cụm Động Cơ Miễn Phí 100% (Zero-Config) Zero-Key Node
Két Khóa API Key & Cookie Xác Thực Cloud & Custom Services
Phòng Thử Giọng & Kiểm Thử Tổng Hợp
Thử nghiệm văn bản trực tiếp với bất kỳ giọng nói hoặc profile nào, kiểm tra từ điển và độ trễ phản hồi.
Kết Quả Tổng Hợp
Giọng yêu cầu - không thể phát.
Nguyên nhân: -
Hệ thống kích hoạt cơ chế Fallback sang - để không làm gián đoạn Kiosk.
Quản Lý Bộ Đệm & Pre-Bake Cụm Phân Tán 0ms
Kiến trúc đệm 2 tầng đa tài khoản: L1 RAM (~0.1ms) và L2 Cloudflare R2 phân tán trên từng Worker con. Nạp sẵn câu Kiosk để đạt phản hồi 0ms.
Ma Trận Lưu Trữ & Hạn Mức Từng Trạm
Theo dõi tệp cache nhị phân trên Master và từng trạm Worker Cloudflare phụ độc lập.
| Mã Hash / Tệp Âm Thanh | Trạm Lưu Trữ | Dung Lượng | Ngày Lưu | Thao Tác |
|---|---|---|---|---|
| Đang tải danh sách tệp cache... | ||||
Công Cụ Nướng Sẵn Cache Hàng Loạt (Pre-Bake Batch TTS)
Nhập danh sách câu Kiosk cố định (mỗi câu một dòng). Hệ thống sẽ tổng hợp sẵn và đẩy vào bộ đệm trước khi mở máy để đảm bảo độ trễ 0ms tuyệt đối.
Trình Tạo Mã Nhúng Đa Nền Tảng Cho KTV
v2.5 Full Multi-PlatformTự động sinh cấu hình và mã nguồn nhúng cho 10 nền tảng: Android Tasker, cURL, HTML5 Audio, JS/Node, Python, C#, Home Assistant, ESP32, Flutter, PHP & Go.
Tùy Chỉnh Tham Số Sinh Mã Thời Gian Thực
Mã bên dưới sẽ tự động cập nhật ngay khi bạn thay đổi- Action: Net ➔ HTTP Request
- Method: POST
- URL: http://...
- Headers: Content-Type: application/json
- File Output: Download/tts_kiosk.mp3
- Action: Net ➔ HTTP Request
- Method: GET
- URL: http://...
- File Output: Download/tts_kiosk.mp3
- Sau đó thêm Action: Media ➔ Play Ringtone / Music
Bảng Tra Cứu Tham Số API & Mã Trạng Thái HTTP
| Tham Số | Vị Trí | Kiểu | Mặc Định | Mô Tả & Ví Dụ |
|---|---|---|---|---|
| text | Query / Body | String | Bắt buộc | Văn bản cần đọc (VD: Xin chào bạn). Hỗ trợ cả alias message_content.title. |
| profile | Query / Body | String | default | Định danh Profile điều phối giọng nói (VD: default, kiosk_hcm). |
| voice | Query / Body | String | Theo Profile | Chỉ định đích danh 1 giọng bất kỳ (VD: edge-hoaimy, vnpt-nu-nam, capcut-cogai). |
| gender | Query / Body | String | male | Giới tính người nghe: male (Nam) hoặc female (Nữ) để kích hoạt phân vai giọng nói thông minh. |
| rate | Query / Body | Float | 1.0 | Tốc độ phát âm (từ 0.5 đến 2.0). |
| pitch | Query / Body | Integer | 0 | Cao độ âm sắc (từ -50Hz đến +50Hz). |
HỆ THỐNG AN TOÀN — LIVE PRODUCTION
ONLINE 24/7Tất cả các dịch vụ TTS, bộ nhớ đệm Cache và Cụm Cloudflare Worker đang hoạt động bình thường.
Đóng Băng Khẩn Cấp
Khi trung tâm bị đứt cáp hoặc mạng chập chờn: Ép toàn bộ server chỉ phục vụ từ Cache và Fallback tĩnh (0ms), chặn 100% kết nối API ra ngoài.
Ép Chạy 1 Engine (Isolate)
Cô lập để kiểm tra lỗi xem 1 Engine cụ thể có gây trễ hoặc lỗi không. Bỏ qua cấu hình fallback và ép chạy duy nhất engine này.
Chế Độ Siêu Tốc (Fast-Track)
Bỏ qua các bước lọc SSML phức tạp và trích xuất phụ khi giờ cao điểm đông khách. Đảm bảo Kiosk luôn phản hồi âm thanh tức thì <100ms.
Trung Tâm Thao Tác Cứu Hộ Nhanh 1-Click
Thao tác phục hồi tức thì dành riêng cho KTV tại hiện trườngNhật Ký Sự Cố & Thao Tác Cứu Hộ Gần Nhất
Cẩm Nang 6 Sự Cố Thường Gặp Nhất Tại Hiện Trường Kiosk Tanita
1. Kiosk không phát tiếng, Tasker Timeout
Kiểm tra kết nối Wifi Kiosk tới IP Server. Đảm bảo Kiosk ping được cổng 3100. Nếu mạng chập chờn, bật "Đóng Băng Khẩn Cấp" để dùng cache tức thì 0ms.
2. Lỗi 429 Too Many Requests
Key Vault có Circuit-Breaker tự cách ly key 429 và failover qua Engine dự phòng. Để gỡ khóa ngay, nhấn nút "2. Gỡ Phong Tỏa Toàn Bộ Khóa".
3. Âm thanh bị bụp / click ở đầu câu
NextGen TTS đã tích hợp bộ lọc tách ID3v2 header tự động trong audio.js. Không ghép chuỗi âm thanh ngoài mà để server tự ghép luồng.
4. Kiosk đổi mạng / Mất IP LAN cũ
Xem IP LAN hiện tại ở Banner đầu trang hoặc gõ lệnh ipconfig. Cập nhật lại URL trong Tasker hoặc đổi sang tên miền Cloudflare.
5. Khách hàng Nam/Nữ bị đọc sai xưng hô
Vào tab Profiles ➔ Chỉnh sửa Kiosk ➔ Bật "Phân vai giới tính". Gán Nam nghe giọng Nữ và Nữ nghe giọng Nam, đồng thời gửi kèm gender=male|female.
6. Worker Node Cloudflare trả file 0.5 KB
Đã được chốt chặn triệt để bằng bộ lọc Sanity Gate: mọi phản hồi <1000 bytes hoặc dạng JSON text sẽ bị từ chối và tự động failover sang Master nội bộ an toàn.
Quản Lý Cụm Serverless Cloud Cluster (Multi-Account Workers)
Gắn kết nhiều tài khoản Cloudflare Free để nhân rộng hạn mức N x 100.000 req/ngày và N x 10GB R2 cho tên miền tts.thanhnguyen.group.
Danh Sách Các Worker Nodes Trong Cụm
Đang tải...Cẩm Nang 3 Bước Mở Trạm Con (Cộng Dồn +10GB R2 & +100.000 req/ngày)
Tận dụng triệt để gói miễn phí của từng tài khoản Cloudflare để nhân bội dung lượng Cache và hạn mức
Mở tab ẩn danh, đăng nhập tài khoản Cloudflare Free phụ. Vào R2 Storage ➔ Create bucket (vd: tts-cache-node2) để nhận 10GB R2 miễn phí. Sau đó vào Workers & Pages ➔ Create application ➔ Create Worker (vd: tts-node2) rồi Deploy.
Vào Worker vừa tạo ➔ Settings ➔ Bindings ➔ Add binding (R2 Bucket): Tên biến là TTS_R2, chọn bucket vừa tạo. Tiếp theo bấm "Edit code", xóa code cũ và dán toàn bộ mã từ nút xanh ở trên rồi bấm Save and Deploy.
Sao chép URL Worker vừa tạo (dạng: https://tts-node2.subdomain.workers.dev), quay lại bảng này bấm [+ Thêm Node Con Mới], dán URL vào và bấm [Kiểm Tra & Lưu]. Cụm sẽ tự động nhận thêm +10GB R2 và +100k req/ngày!
TTS_R2 trên tài khoản phụ, âm thanh do trạm con render sẽ được lưu trực tiếp vào R2 của tài khoản đó. 2 TK = 20GB, 3 TK = 30GB, 5 TK = 50GB hoàn toàn miễn phí!
https://ten-worker.subdomain.workers.dev. Nếu nhập thiếu subdomain (như tts-node2.workers.dev) trạm sẽ không thể kết nối và báo Offline!
Hướng Dẫn KTV: Tạo Cloudflare Scoped API Token Để Tự Động Deploy (30 Giây) DevOps Chuẩn
Giúp Master tự động đẩy code sang tài khoản con bằng 1 nút bấm, không cần copy dán thủ công.
- Đăng nhập Cloudflare phụ ➔ Bấm vào Avatar góc phải trên ➔ chọn My Profile.
- Chọn menu API Tokens (bên trái) ➔ Bấm Create Token.
- Cuộn xuống mục Custom Token ➔ Bấm Get started.
- Token name:
NextGen-TTS-Deployer - Permissions: Chọn
Account|Workers Scripts|Edit. - Account Resources: Chọn
Include - All accounts(hoặc chọn tài khoản của bạn). - Bấm Continue to summary ➔ Create Token ➔ Copy chuỗi mã Token này.
Về trang chủ Cloudflare ➔ Nhìn sang thanh bên phải (Right Sidebar) ➔ Copy 32 ký tự tại mục Account ID. Mở modal sửa Node trên Master, dán Account ID + Token vào ➔ Bấm [Lưu & Triển Khai Ngay]!