Voice Changer

Voice Changer API

Tổng Quan

Giới thiệu Voice Changer (Audio Conversion) API của AusyncLab cho phép chuyển đổi giọng nói trong một đoạn audio sang giọng nói của một audio tham chiếu khác. Hệ thống sử dụng công nghệ AI tiên tiến để biến đổi giọng nói một cách tự nhiên và chính xác.

Tính Năng Chính

  • Chuyển đổi giọng nói sang giọng nói tham chiếu
  • Hỗ trợ đa ngôn ngữ
  • Cắt đoạn audio theo thời gian (start_time, end_time)
  • Theo dõi tiến trình qua polling
  • Hỗ trợ streaming với định dạng HLS (m3u8)

Quick Start

  1. Đăng ký và lấy API Key từ hệ thống.
  2. Chuẩn bị audio gốc (raw audio) và audio tham chiếu (reference audio).
  3. Gửi yêu cầu chuyển đổi giọng nói với các URL audio.
  4. Polling endpoint chi tiết audio cho đến khi state là SUCCEED.

Tải Lên File Audio

Nếu bạn chưa có URL audio, hãy sử dụng File Upload API để tải file lên hệ thống của chúng tôi và lấy URL.

Lưu ý quan trọng: File được tải lên qua File Upload API sẽ tự động bị xóa sau 24 giờ. Hãy đảm bảo gọi API chuyển đổi giọng nói trước thời hạn này.

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. Xem thêm Rate Limit.

Base URL

https://api.ausynclab.io/api/v1/audio-conversion

Playground

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

Chi Tiết Endpoints

1. Chuyển Đổi Giọng Nói

Endpoint: POST /convert Mô tả: Chuyển đổi giọng nói trong audio gốc sang giọng nói của audio tham chiếu.

Tham số Request Body:

  • raw_audio_url (bắt buộc): URL của audio gốc cần chuyển đổi giọng.
  • reference_audio_url (bắt buộc): URL của audio tham chiếu chứa giọng nói mục tiêu.
  • reference_language (bắt buộc): Ngôn ngữ của audio tham chiếu. Giá trị được lưu làm metadata và không được kiểm tra; khuyến nghị dùng mã ngôn ngữ sau:
    • en: Tiếng Anh (English)
    • vi: Tiếng Việt (Vietnamese)
    • de: Tiếng Đức (German)
    • fr: Tiếng Pháp (French)
    • ko: Tiếng Hàn (Korean)
    • ja: Tiếng Nhật (Japanese)
    • zh: Tiếng Trung (Chinese)
    • it: Tiếng Ý (Italian)
    • pt: Tiếng Bồ Đào Nha (Portuguese)
    • pl: Tiếng Ba Lan (Polish)
    • es: Tiếng Tây Ban Nha (Spanish)
    • nl: Tiếng Hà Lan (Dutch)
    • th: Tiếng Thái (Thai)
    • ms: Tiếng Mã Lai (Malay)
    • hi: Tiếng Hindi (Hindi)
    • ar: Tiếng Ả Rập (Arabic)
    • he: Tiếng Do Thái (Hebrew)
  • name (tùy chọn): Tên của đoạn audio chuyển đổi.
  • raw_language (tùy chọn): Ngôn ngữ của audio gốc.
  • start_time (tùy chọn): Thời gian bắt đầu cắt audio gốc (tính bằng giây).
  • end_time (tùy chọn): Thời gian kết thúc cắt audio gốc (tính bằng giây).

Lưu ý: Endpoint này hiện không gửi callback. Trường callback_url nếu gửi lên sẽ được chấp nhận nhưng bị bỏ qua. Hãy polling endpoint chi tiết audio để nhận kết quả.

CURL:

curl -X 'POST' \
  'https://api.ausynclab.io/api/v1/audio-conversion/convert' \
  -H 'accept: application/json' \
  -H 'X-API-Key: your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Demo Voice Changer",
    "raw_audio_url": "https://example.com/raw_audio.wav",
    "reference_audio_url": "https://example.com/reference_audio.wav",
    "reference_language": "vi",
    "raw_language": "vi"
  }'

Phản hồi:

  • 200 OK
{
  "status": 200,
  "result": {
    "audio_id": 123,
    "message": "Your request to convert the audio is processing"
  }
}

2. Lấy Danh Sách Audio Đã Chuyển Đổi

URL: https://api.ausynclab.io/api/v1/audio-conversion/ Phương thức: GET Mô tả: Lấy danh sách tất cả các audio đã chuyển đổi.

CURL:

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

Phản hồi:

  • 200 OK
{
  "status": 200,
  "result": [
    {
      "id": 123,
      "state": "SUCCEED",
      "name": "Demo Voice Changer",
      "raw_language": "vi",
      "reference_language": "vi",
      "raw_audio_url": "https://example.com/raw_audio.wav",
      "reference_audio_url": "https://example.com/reference_audio.wav",
      "converted_audio_url": "https://example.com/converted_audio.wav",
      "converted_audio_url_stream": "https://example.com/converted_audio.m3u8",
      "created_at": "2026-01-04T07:05:24.040000"
    },
    ...
  ]
}

3. Lấy Thông Tin Chi Tiết Audio

URL: https://api.ausynclab.io/api/v1/audio-conversion/{audio_id} Phương thức: GET Mô tả: Lấy thông tin chi tiết của một audio đã chuyển đổi.

Tham số:

  • audio_id (bắt buộc): ID của audio (kiểu integer).

CURL:

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

Phản hồi:

  • 200 OK
{
  "status": 200,
  "result": {
    "id": 123,
    "state": "SUCCEED",
    "name": "Demo Voice Changer",
    "raw_language": "vi",
    "reference_language": "vi",
    "raw_audio_url": "https://example.com/raw_audio.wav",
    "reference_audio_url": "https://example.com/reference_audio.wav",
    "converted_audio_url": "https://example.com/converted_audio.wav",
    "converted_audio_url_stream": "https://example.com/converted_audio.m3u8",
    "created_at": "2026-01-04T07:05:24.040000"
  },
  "message": null
}

Các trạng thái có thể (state):

stateMô tả
WAITING_IN_QUEUEĐang chờ xử lý
IN_PROGRESSĐang chuyển đổi
SUCCEEDHoàn thành, converted_audio_url sẵn sàng
INTERNAL_ERRORLỗi xử lý
  • 404 Not Found: Không tìm thấy audio.

4. Xóa Audio

URL: https://api.ausynclab.io/api/v1/audio-conversion/{id} Phương thức: DELETE Mô tả: Xóa một audio đã chuyển đổi khỏi hệ thống.

Tham số:

  • id (bắt buộc): ID của audio cần xóa (kiểu integer).

CURL:

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

Phản hồi:

  • 200 OK
{
  "status": 200,
  "result": {
    "id": 123
  }
}
  • 404 Not Found: Không tìm thấy audio.
File UploadVoice Denoiser