StemSplit API: Tích Hợp Tách Stem AI Vào Ứng Dụng Của Bạn

StemSplit API đã có sẵn công khai. Nếu bạn đang xây dựng ứng dụng karaoke, tự động hóa việc trích xuất stem cho thư viện nhạc, hoặc thêm tính năng xóa giọng hát vào quy trình sản xuất, bạn có thể thực hiện điều đó theo cách lập trình ngay bây giờ.

API cung cấp cùng chất lượng tách AI như ứng dụng web — cùng mô hình HTDemucs FT, cùng cơ sở hạ tầng xử lý — thông qua các REST endpoint đơn giản với thông báo webhook và hỗ trợ URL YouTube trực tiếp.

Những Gì Bạn Có Thể Xây Dựng

Tách Stem Từ Bất Kỳ Âm Thanh Nào

Tải lên file MP3, WAV, FLAC hoặc M4A và trích xuất:

Xử Lý Video YouTube Trực Tiếp

Gửi URL YouTube và nhận lại các stem đã tách — không cần tải xuống trước:

curl -X POST https://stemsplit.io/api/v1/youtube-jobs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"youtubeUrl": "https://youtube.com/watch?v=dQw4w9WgXcQ"}'

Thông Báo Webhook

Đăng ký endpoint webhook và nhận POST khi các job hoàn thành, thay vì phải polling:

{
  "event": "job.completed",
  "timestamp": "2026-01-05T12:30:00Z",
  "data": {
    "jobId": "clxxx123...",
    "status": "COMPLETED",
    "outputs": {
      "vocals": { "url": "https://...", "expiresAt": "..." },
      "instrumental": { "url": "https://...", "expiresAt": "..." }
    }
  }
}

Webhook payload bao gồm chữ ký HMAC-SHA256 để xác minh.

---

Sẵn sàng bắt đầu? Lấy API key của bạn — tài khoản mới nhận được 10 phút miễn phí để kiểm thử.

---

Cách Thức Hoạt Động

Bước 1: Tải âm thanh trực tiếp qua URL đã ký trước, hoặc gửi sourceUrl trỏ đến file hiện có.

Bước 2: Tạo một job:

curl -X POST https://stemsplit.io/api/v1/jobs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://example.com/song.mp3",
    "outputType": "BOTH",
    "quality": "BEST"
  }'

Bước 3: Nhận kết quả qua webhook hoặc poll endpoint trạng thái job. Tải xuống stem từ các URL được cung cấp khi job hoàn thành. Thời gian xử lý thông thường là 1–3 phút tùy thuộc vào độ dài âm thanh và cài đặt chất lượng.

Ví Dụ: Bộ Tạo Karaoke Bằng Python

import requests
import time

API_KEY = "sk_live_xxx"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

response = requests.post(
    "https://stemsplit.io/api/v1/jobs",
    headers=HEADERS,
    json={
        "sourceUrl": "https://example.com/song.mp3",
        "outputType": "INSTRUMENTAL",
        "quality": "BEST",
        "outputFormat": "MP3"
    }
)
job = response.json()
print(f"Created job: {job['id']}")

while True:
    status = requests.get(
        f"https://stemsplit.io/api/v1/jobs/{job['id']}",
        headers=HEADERS
    ).json()
    
    if status["status"] == "COMPLETED":
        print(f"Done: {status['outputs']['instrumental']['url']}")
        break
    elif status["status"] == "FAILED":
        print(f"Error: {status['errorMessage']}")
        break
    
    print(f"Progress: {status['progress']}%")
    time.sleep(5)

Đó là toàn bộ logic cho một bộ tạo karaoke — khoảng 30 dòng từ lời gọi API đến URL tải xuống.

Hướng Dẫn Tích Hợp

Tài liệu bao gồm các trường hợp sử dụng phổ biến nhất:

Tài Liệu Kỹ Thuật

Xác Thực

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx

Tạo key trong Settings → API Keys. Mỗi tài khoản hỗ trợ tối đa 5 key đang hoạt động.

Giới Hạn Tốc Độ và Ràng Buộc

Định Dạng Được Hỗ Trợ

Đầu vào: MP3, WAV, FLAC, M4A, OGG, WebM

Đầu ra: MP3, WAV, FLAC (chỉ định trong yêu cầu job)

Cài Đặt Chất Lượng

Giá Cả

API sử dụng cùng hệ thống tín dụng như ứng dụng web — không có giá API riêng, không cần đăng ký. Tín dụng được mua khi cần và không bao giờ hết hạn. Tài khoản mới nhận được 10 phút miễn phí để kiểm thử. Giá hiện tại có trên trang giá.

Tài Liệu

• Bắt Đầu — Khởi động nhanh với ví dụ code bằng cURL, Python và JavaScript
• Tài Liệu API — Tài liệu endpoint đầy đủ với schema yêu cầu và phản hồi
• Hướng Dẫn Tích Hợp — Hướng dẫn từng bước cho các nền tảng và trường hợp sử dụng cụ thể

Câu Hỏi Thường Gặp

Điều này khác với ứng dụng web như thế nào? Cùng mô hình AI, cùng chất lượng, cùng tín dụng — API cung cấp quyền truy cập lập trình cho tự động hóa và tích hợp. Ứng dụng web dành cho việc xử lý đơn lẻ của từng cá nhân.

Tôi có cần đăng ký không? Không. Mua tín dụng khi cần. Chúng không hết hạn.

Tôi có thể dùng điều này trong sản phẩm thương mại không? Có. API được thiết kế để tích hợp vào sản phẩm và quy trình làm việc. Tín dụng của bạn trả cho việc xử lý.

Làm thế nào để xử lý webhook một cách an toàn? Xác minh chữ ký HMAC-SHA256 trên mọi webhook payload sử dụng API key của bạn làm bí mật. Từ chối mọi yêu cầu không được xác thực. Chi tiết trong tài liệu API.

Tôi có thể xử lý video không, không chỉ âm thanh? API xử lý âm thanh. Đối với URL YouTube, chúng tôi tự động trích xuất track âm thanh. Đối với file video, hãy trích xuất âm thanh trước và gửi file đó.

---

Bắt Đầu Xây Dựng

1. Tạo tài khoản
2. Tạo API key
3. Đọc tài liệu

Tài khoản mới bao gồm 10 phút miễn phí. Không cần thẻ tín dụng để kiểm thử.

Lấy API Key Của Bạn →