Bvoiz Help Center | Tài liệu hướng dẫn & Tích hợp API

1. Lấy danh sách lịch sử tạo âm thanh

GEThttps://api.bvoiz.com/api/v1/tts/history

Tham số Query (Tùy chọn)

Tham số	Kiểu	Mặc định	Mô tả
page	Integer	1	Số trang phân trang
limit	Integer	20	Số lượng kết quả mỗi trang (tối đa 100)
status	String	all	Lọc trạng thái: `PENDING`, `SUCCESS`, `FAILED`

Gọi API lấy lịch sử

curl -X GET "https://api.bvoiz.com/api/v1/tts/history?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

2. Tra cứu trạng thái theo request_id

GEThttps://api.bvoiz.com/api/v1/tts/status/:request_id

Kiểm tra trạng thái request

curl -X GET "https://api.bvoiz.com/api/v1/tts/status/req_1790355651_a5a901" \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Cấu trúc Response trả về

JSON Response thành công

{
  "status": 1,
  "result": {
    "total": 48,
    "page": 1,
    "limit": 10,
    "items": [
      {
        "request_id": "req_1790355651_a5a901",
        "input_text": "Xin chào các bạn, đây là giọng đọc AI từ nền tảng Bvoiz.",
        "speaker_id": "vi_male_leduc_mb",
        "speaker_name": "Lê Đức",
        "char_count": 58,
        "audio_url": "https://api.bvoiz.com/storage/audio/req_1790355651_a5a901.mp3",
        "audio_type": "mp3",
        "file_size": 48920,
        "status": "SUCCESS",
        "created_at": "2026-09-28T00:15:30Z"
      }
    ]
  }
}