Voice Denoiser

Voice Denoiser API

Tổng Quan

Giới thiệu Voice Denoiser API của AusyncLab cho phép loại bỏ tiếng ồn nền trong một đoạn audio. Hệ thống sử dụng công nghệ AI tiên tiến để tách và loại bỏ nhiễu, giữ lại giọng nói rõ ràng và chất lượng cao.

Tính Năng Chính

  • Loại bỏ tiếng ồn nền khỏi audio
  • Giữ nguyên chất lượng giọng nói gốc
  • Callback URL để theo dõi tiến trình xử lý
  • 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 cần khử nhiễu.
  3. Gửi yêu cầu khử nhiễu với URL audio.
  4. Nhận thông báo qua callback_url khi hoàn thành.

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/voice-denoiser

Playground

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

Chi Tiết Endpoints

1. Khử Nhiễu Audio

Endpoint: POST /denoise Mô tả: Loại bỏ tiếng ồn nền trong audio gốc.

Tham số Request Body:

  • raw_audio_url (bắt buộc): URL của audio cần khử nhiễu.
  • name (tùy chọn): Tên của đoạn audio sau khử nhiễu.
  • callback_url (tùy chọn): URL sẽ được gọi khi quá trình khử nhiễu hoàn thành. Xem mục Callback Payload để tìm hiểu thêm.

CURL:

curl -X 'POST' \
  'https://api.ausynclab.io/api/v1/voice-denoiser/denoise' \
  -H 'accept: application/json' \
  -H 'X-API-Key: your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Demo Voice Denoiser",
    "raw_audio_url": "https://example.com/noisy_audio.wav",
    "callback_url": "https://your-callback-url.com"
}'

Phản hồi:

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

2. Lấy Danh Sách Audio Đã Khử Nhiễu

URL: https://api.ausynclab.io/api/v1/voice-denoiser/ Phương thức: GET Mô tả: Lấy danh sách tất cả các audio đã khử nhiễu.

CURL:

curl -X 'GET' \
  'https://api.ausynclab.io/api/v1/voice-denoiser/' \
  -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 Denoiser",
      "raw_audio_url": "https://example.com/noisy_audio.wav",
      "denoised_audio_url": "https://example.com/denoised_audio.wav",
      "denoised_audio_url_stream": "https://example.com/denoised_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/voice-denoiser/{audio_id} Phương thức: GET Mô tả: Lấy thông tin chi tiết của một audio đã khử nhiễu.

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/voice-denoiser/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 Denoiser",
    "raw_audio_url": "https://example.com/noisy_audio.wav",
    "denoised_audio_url": "https://example.com/denoised_audio.wav",
    "denoised_audio_url_stream": "https://example.com/denoised_audio.m3u8",
    "created_at": "2026-01-04T07:05:24.040000"
  },
  "message": null
}
  • 404 Not Found: Không tìm thấy audio.

4. Xóa Audio

URL: https://api.ausynclab.io/api/v1/voice-denoiser/{id} Phương thức: DELETE Mô tả: Xóa một audio đã khử nhiễu 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/voice-denoiser/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.

Callback Payload

Khi quá trình khử nhiễu hoàn thành, API sẽ gửi thông báo đến callback_url với payload:

Nội dung Payload:

  • audio_id : ID của audio được tạo.
  • status: Trạng thái của request (SUCCEED, FAILED).
  • denoised_audio_url : URL để tải xuống tệp audio đã khử nhiễu.
  • denoised_audio_url_stream : URL streaming (HLS) của audio đã khử nhiễu.
  • message : Thông báo về kết quả xử lý.

Ví dụ

{
  "audio_id": 123,
  "status": "SUCCEED",
  "denoised_audio_url": "https://example.com/denoised_audio.wav",
  "denoised_audio_url_stream": "https://example.com/denoised_audio.m3u8",
  "message": "Your audio denoising is completed successfully."
}

Lưu ý: Người dùng cần triển khai endpoint để nhận và xử lý payload này.

Voice ChangerLipsync