Voice Library

Voice Library API

Tổng Quan

Giới thiệu
Voice Library API của AusyncLab cung cấp các chức năng quản lý và thao tác với các giọng nói cá nhân. Bạn có thể đăng ký giọng nói riêng để sử dụng cho Text-to-Speech và các tính năng khác.

Tính Năng Chính

  • Đăng ký giọng nói từ file audio (WAV/MP3)
  • Quản lý danh sách giọng nói cá nhân
  • Hỗ trợ đa ngôn ngữ
  • Phân loại theo giới tính, độ tuổi và use case

Quick Start

  1. Đăng ký và lấy API Key từ hệ thống.
  2. Tải lên file audio mẫu giọng nói (3-7 giây).
  3. Cung cấp thông tin metadata (ngôn ngữ, giới tính, độ tuổi, use case).
  4. Sử dụng voice_id trong Text-to-Speech API.

Xác Thực

API yêu cầu cung cấp API Key qua header X-API-Key. API Key phải được bảo mật và không chia sẻ công khai.

Base URL

https://api.ausynclab.io/api/v1/voices

Playground

Thử nghiệm API tại: https://api.ausynclab.io/docs (opens in a new tab)

Chi Tiết Endpoints

1. Đăng Ký Giọng Nói

URL: https://api.ausynclab.io/api/v1/voices/register
Phương thức: POST
Mô tả: Đăng ký một giọng nói mới.

Tham số Query:

  • name : Tên giọng nói.
  • language : Ngôn ngữ (vi, en). Quan trọng: phải input chính xác ngôn ngữ tương ứng với đoạn audio.
  • gender : Giới tính (MALE, FEMALE).
  • age : Độ tuổi (YOUNG, MIDDLE_AGED, OLD).
  • use_case : Trường hợp sử dụng (CASUAL, NARRATION, ADVERTISEMENT, REPORTING).

Body:
Dữ liệu audio file wav hoặc mp3 tải lên dưới dạng multipart/form-data.

CURL:

curl -X 'POST' \
  'https://api.ausynclab.io/api/v1/voices/register?name=Sample%20Voice&language=vi&gender=FEMALE&age=YOUNG&use_case=CASUAL' \
  -H 'accept: application/json' \
  -H 'X-API-Key: your_api_key' \
  -H 'Content-Type: multipart/form-data' \
  -F 'audio_file=@AudioFile.wav;type=audio/wav'

Phản hồi:

  • 200 OK
{
  "status": 200,
  "result": {
    "id": 1000
  }
}

2. Lấy Thông Tin Chi Tiết Giọng Nói

URL: https://api.ausynclab.io/api/v1/voices/{voice_id}
Phương thức: GET
Mô tả: Lấy thông tin chi tiết của một giọng nói.

Tham số:

  • voice_id (bắt buộc): ID của giọng nói (kiểu integer).

CURL:

curl -X 'GET' \
  'https://api.ausynclab.io/api/v1/voices/1000' \
  -H 'accept: application/json' \
  -H 'X-API-Key: your_api_key'

Phản hồi:

  • 200 OK
{
  "status": 200,
  "result": {
    "id": 1000,
    "name": "Sample 1",
    "language": "vi",
    "gender": "FEMALE",
    "age": "YOUNG",
    "use_case": "CASUAL",
    "audio_url": "https://cdn-ausync-endpoint.azureedge.net/audio/sample_path.wav"
  }
}
  • 404 Not Found: Không tìm thấy giọng nói.

3. Lấy Danh Sách Giọng Nói

URL: https://api.ausynclab.io/api/v1/voices/list
Phương thức: GET
Mô tả: Lấy danh sách các giọng nói.

CURL:

curl -X 'GET' \
  'https://api.ausynclab.io/api/v1/voices/list' \
  -H 'accept: application/json' \
  -H 'X-API-Key: your_api_key'

Phản hồi:

  • 200 OK
{
  "status": 200,
  "result": [
    {
      "id": 1000,
      "name": "Sample 1",
      "language": "vi",
      "gender": "FEMALE",
      "age": "YOUNG",
      "use_case": "CASUAL",
      "audio_url": "https://cdn-ausync-endpoint.azureedge.net/audio/sample_path.wav"
    },
    {
      "id": 1001,
      "name": "Sample 2",
      "language": "vi",
      "gender": "FEMALE",
      "age": "YOUNG",
      "use_case": "CASUAL",
      "audio_url": "https://cdn-ausync-endpoint.azureedge.net/audio/sample_path.wav"
    }
  ]
}
  • 404 Not Found: Không tìm thấy giọng nói.

4. Xóa Giọng Nói

URL: https://api.ausynclab.io/api/v1/voices/{voice_id}
Phương thức: DELETE
Mô tả: Xóa một giọng nói theo voice_id.

Tham số:

  • voice_id (bắt buộc): ID của giọng nói.

CURL:

curl -X 'DELETE' \
  'https://api.ausynclab.io/api/v1/voices/1000' \
  -H 'accept: application/json' \
  -H 'X-API-Key: your_api_key'

Phản hồi:

  • 200 OK
{
  "status": 200,
  "result": {
    "id": 1000
  }
}
  • 404 Not Found: Không tìm thấy giọng nói.
IntroductionText to Speech