# Bvoiz Documents & API Index

## Bvoiz Documents

- [Bvoiz Help Center](https://help.bvoiz.com/): Trung tâm thông tin, hỗ trợ người dùng và tài liệu tích hợp nền tảng Bvoiz.
- [Giới thiệu nền tảng](https://help.bvoiz.com/tai-lieu-chung/gioi-thieu): Tìm hiểu kiến trúc giọng nói AI, công nghệ Edge TTS & Kokoro ONNX của Bvoiz.
- [Câu hỏi thường gặp (FAQ)](https://help.bvoiz.com/tai-lieu-chung/faq): Giải đáp các thắc mắc về credits, định dạng âm thanh, bản quyền thương mại và tài khoản.
- [Quản lý tài khoản & Bảo mật](https://help.bvoiz.com/huong-dan-su-dung/tai-khoan): Đăng ký, đăng nhập, bảo mật 2 lớp, đổi mật khẩu và quản lý thông tin cá nhân.
- [Chuyển văn bản thành giọng nói (TTS)](https://help.bvoiz.com/huong-dan-su-dung/chuyen-van-ban): Cách nhập kịch bản, lựa chọn giọng đọc 3 miền, tinh chỉnh tốc độ, cao độ và xuất audio.
- [Nhân bản giọng nói (Voice Cloning)](https://help.bvoiz.com/huong-dan-su-dung/voice-cloning): Tạo giọng đọc độc quyền từ mẫu ghi âm hoặc file âm thanh sẵn có với độ chân thực 99%.
- [Lồng tiếng video AI (Voice Dubbing)](https://help.bvoiz.com/huong-dan-su-dung/long-tieng): Dịch phụ đề, tạo giọng lồng tiếng tự động từ file video hoặc tệp phụ đề SRT.
- [Nhóm & Không gian làm việc](https://help.bvoiz.com/huong-dan-su-dung/nhom): Tạo nhóm, mời thành viên, phân quyền và chia sẻ kho tài nguyên credits chung.
- [Bắt đầu nhanh & Xác thực API](https://help.bvoiz.com/api-docs/quickstart): Cách tạo API Key, cấu hình Bearer Token, Base URL và gọi request đầu tiên.
- [API Text-to-Speech](https://help.bvoiz.com/api-docs/text-to-speech): Endpoint tổng hợp văn bản thành âm thanh chất lượng cao kèm tham số chi tiết.
- [API Danh sách giọng đọc](https://help.bvoiz.com/api-docs/voices): Truy vấn danh sách giọng đọc theo vùng miền, giới tính và ngôn ngữ hỗ trợ.
- [API Tra cứu lịch sử & Audio](https://help.bvoiz.com/api-docs/history): Kiểm tra tiến độ xử lý và lấy đường dẫn tải về audio thông qua request_id.
- [API Voice Cloning](https://help.bvoiz.com/api-docs/voice-cloning): Tạo, quản lý và xóa giọng nói cá nhân hóa thông qua RESTful API.
- [API Voice Dubbing & SRT](https://help.bvoiz.com/api-docs/voice-dubbing): Tự động phân tách thoại, dịch kịch bản và ghép giọng AI vào video.
- [Webhook & Thanh toán VietQR](https://help.bvoiz.com/api-docs/webhooks): Tích hợp webhook thông báo hoàn thành audio và biến động số dư ngân hàng.
- [Mã lỗi & Xử lý sự cố](https://help.bvoiz.com/api-docs/errors): Bảng tổng hợp mã trạng thái HTTP, Error Codes và phương án xử lý tương ứng.
- [Bảng giá & Mua gói Credits](https://help.bvoiz.com/thanh-toan/mua-goi-credits): Chi tiết các gói Free, Basic, Advanced, Premium và cơ chế trừ credits minh bạch.
- [Thanh toán VietQR Napas 247](https://help.bvoiz.com/thanh-toan/vietqr): Hướng dẫn quét mã VietQR tự động kích hoạt gói cước trong vòng 3-10 giây.
- [Lịch sử thanh toán & Hóa đơn](https://help.bvoiz.com/thanh-toan/lich-su-thanh-toan): Tra cứu đơn hàng, kiểm tra biên lai giao dịch và yêu cầu xuất hóa đơn VAT.

## API Overview
- Base URL: https://api.bvoiz.com/api/v1
- Auth: Bearer <API_KEY>
- Endpoints:
  - POST /api/v1/tts : Text-to-speech synthesis (Edge TTS, Kokoro ONNX)
  - GET /api/v1/tts/voices : List available AI voices
  - GET /api/v1/tts/history : Query audio conversion status and history
  - POST /api/v1/voice-cloning/create : Train custom voice clone
  - POST /api/v1/payment/create-order : Generate VietQR Napas 247 dynamic QR code