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
  • Audio đầu vào cần dài tối thiểu 5 giây
  • 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 (tối thiểu 5 giây).
  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.

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 khử nhiễu 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/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. Thời lượng tối thiểu 5 giây; audio ngắn hơn sẽ thất bại với thông báo Audio is too short.
  • name (tùy chọn): Tên của đoạn audio sau khử nhiễu.
  • language (tùy chọn, mặc định: "en"): Ngôn ngữ của audio. Giá trị được lưu làm metadata và không ảnh hưởng tới kết quả khử nhiễu; 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)
  • 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",
    "language": "en",
    "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
}

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

stateMô tả
WAITING_IN_QUEUEĐang chờ xử lý
IN_PROGRESSĐang khử nhiễu
SUCCEEDHoàn thành, denoised_audio_url sẵn sàng
INTERNAL_ERRORLỗi xử lý (ví dụ audio ngắn hơn 5 giây)
  • 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:

  • denoiser_id : ID của audio được tạo.
  • credits_used : Số credits đã sử dụng.
  • created_at : Thời gian tạo request.
  • status: Trạng thái của request (SUCCEEDED, FAILED).
  • audio_url : URL để tải xuống tệp audio đã khử nhiễu. Là chuỗi rỗng "" khi thất bại.
  • message : Thông báo về kết quả xử lý. Khi thất bại, đây là lý do lỗi (ví dụ Audio is too short (3.20s); voice denoiser requires at least 5s.).

Ví dụ

{
  "denoiser_id": 123,
  "credits_used": 850,
  "created_at": "2026-03-14T07:36:27.419857",
  "status": "SUCCEEDED",
  "audio_url": "https://example.com/denoised_audio.wav",
  "message": "Audio is generated successfully."
}

Lưu ý: Callback được gửi một lần, không thử lại. Người dùng cần triển khai endpoint để nhận và xử lý payload này; nếu cần chắc chắn, hãy kết hợp polling endpoint chi tiết audio.

Voice ChangerLipsync