🔊 Voice Engine API & Studio
Đang kiểm tra...
👤 admin
🎙 Test Studio
🔑 Quản lý Partner & API Key
📊 Hàng đợi Tasks (Queue)
📋 Nhật Ký API (Logs)
📖 Tài liệu API Client
Thử nghiệm sinh âm thanh (Trực tiếp)
Thêm Đối Tác (Partner) Mới
💡 API Key: Khóa cấp cho đối tác để xác thực khi gọi API VoiceServer. Thời gian lưu file: Số ngày file MP3 được lưu trên ổ cứng trước khi tự động dọn dẹp (nhập
0 = lưu vĩnh viễn). (Lưu ý: Callback Key không lưu ở đối tác mà do client truyền theo từng tác vụ ngầm).Danh Sách Đối Tác & Cấu Hình Lưu Trữ
Đang tải...
Hàng Đợi Xử Lý PostgreSQL (50 Task gần nhất)
💡 Worker ngầm tự động quét 10 task mỗi đợt, xử lý và bắn Webhook Callback báo kết quả.
Đang tải...
Nhật Ký Gọi API Của Client (Thành Công & Thất Bại)
💡 Hệ thống ghi nhận mọi cuộc gọi tới
/api/v1/* kèm IP client, trạng thái phản hồi, độ trễ và chi tiết lỗi nếu có.Đang tải...
Tài Liệu Tích Hợp API Dành Cho Client / Đối Tác
📥 Tải Tài Liệu File Text (.txt)Tất cả các API được bảo vệ bằng Header X-API-Key: vs_live_... và kiểm tra IP Whitelist.
1. Lấy danh sách giọng đọc nguồn
GET /api/v1/voices
curl -X GET "http://localhost:8000/api/v1/voices"
2. Tạo MP3 Đồng Bộ (Nhận link MP3 tức thì trong 1 - 2 giây)
POST /api/v1/tts/generate
curl -X POST "http://localhost:8000/api/v1/tts/generate" \
-H "Content-Type: application/json" \
-H "X-API-Key: vs_live_YOUR_KEY_HERE" \
-d '{
"text": "Xin chào đối tác, đây là âm thanh tạo đồng bộ.",
"voice_id": "edge_female"
}'
Trả về:
{"status": "success", "audio_url": "http://domain/audio/2026/10/xxx.mp3", "duration": 3.8}3. Tạo MP3 Bất Đồng Bộ (Hàng Đợi + Webhook Callback)
POST /api/v1/tts/generate-async
curl -X POST "http://localhost:8000/api/v1/tts/generate-async" \
-H "Content-Type: application/json" \
-H "X-API-Key: vs_live_YOUR_KEY_HERE" \
-d '{
"text": "Văn bản xử lý ngầm trong hàng đợi 10 task...",
"voice_id": "edge_male",
"callback_url": "https://your-domain.com/api/voice-callback",
"callback_key": "YOUR_CALLBACK_SECRET_TOKEN",
"custom_data": "order_id_9988"
}'
💡 Xác thực & Thử lại Webhook (Retry Policy): Khi VoiceServer gọi tới
callback_url, hệ thống tự động đính kèm 2 Headers: X-Callback-Key: YOUR_CALLBACK_SECRET_TOKEN và Authorization: Bearer YOUR_CALLBACK_SECRET_TOKEN. Nếu máy chủ client chưa sẵn sàng hoặc rớt mạng, hệ thống sẽ tự động thử lại tối đa 5 lần, mỗi lần cách nhau đúng 2 phút.