---
title: "StemSplit API: Tích Hợp Tách Stem AI Vào Ứng Dụng Của Bạn"
date: "2025-01-05"
lastUpdated: "2026-03-12"
author: "StemSplit Team"
tags: ["api", "nhà phát triển", "tách stem", "xóa giọng hát", "tự động hóa", "webhooks", "tích hợp"]
excerpt: "StemSplit API cung cấp cho nhà phát triển quyền truy cập lập trình vào tính năng xóa giọng hát và tách stem bằng AI — REST endpoints, webhooks, hỗ trợ URL YouTube và cùng hệ thống tín dụng trả theo sử dụng như ứng dụng web."
abstract: "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ờ."
locale: "vi"
canonical: "https://stemsplit.io/vi/blog/stemsplit-api-launch"
source: "stemsplit.io"
---

> **Source:** https://stemsplit.io/vi/blog/stemsplit-api-launch  
> Originally published by [StemSplit](https://stemsplit.io). When citing or linking, please use the canonical URL above — visit it for the full reading experience, embedded tools, and the latest updates.

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](/stem-splitter) — 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:

| Loại Đầu Ra | Những Gì Bạn Nhận |
|---|---|
| `VOCALS` | Giọng hát được tách riêng |
| `INSTRUMENTAL` | Mọi thứ trừ giọng hát (track karaoke) |
| `BOTH` | Giọng hát + nhạc không lời dưới dạng file riêng biệt |
| `FOUR_STEMS` | Giọng hát, trống, bass, khác |
| `SIX_STEMS` | Giọng hát, trống, bass, guitar, piano, khác |

### 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:

```bash
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:

```json
{
  "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](/developers) — tài khoản mới nhận được 5 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:

```bash
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

```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:

| Nền tảng | Những Gì Bạn Có Thể Xây Dựng |
|---|---|
| [n8n](/developers/guides/n8n) | Quy trình tự động — xử lý file từ cloud storage, chuyển kết quả đến Slack hoặc email |
| [Zapier](/developers/guides/zapier) | Tự động hóa no-code kết nối StemSplit với 5.000+ ứng dụng |
| [Make](/developers/guides/make) | Trình xây dựng kịch bản trực quan cho quy trình xử lý nhiều bước |
| [Discord Bot](/developers/guides/discord-bot) | Bot tách stem cho server âm nhạc |
| [White Label](/developers/guides/white-label) | Nhúng tính năng tách stem vào sản phẩm của bạn dưới thương hiệu riêng |

## Tài Liệu Kỹ Thuật

### Xác Thực

```
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx
```

Tạo key trong [Settings → API Keys](/developers). 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

| Giới hạn | Giá trị |
|---|---|
| Yêu cầu mỗi phút | 60 |
| Kích thước file tối đa | 50 MB |
| Thời lượng âm thanh tối đa | 60 phút |
| API key mỗi tài khoản | 5 |
| Webhook mỗi tài khoản | 5 |

### Đị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

| Cài đặt | Tốc độ | Trường hợp sử dụng |
|---|---|---|
| `FAST` | ~20 giây mỗi phút âm thanh | Xem trước nhanh, kiểm thử |
| `BALANCED` | ~40 giây mỗi phút | Sử dụng chung |
| `BEST` | ~60 giây mỗi phút | Chất lượng sản xuất; bắt buộc cho 6 stem |

## 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 5 phút miễn phí để kiểm thử. Giá hiện tại có trên [trang giá](/pricing).

## Tài Liệu

- **[Bắt Đầu](/developers/docs)** — Khởi động nhanh với ví dụ code bằng cURL, Python và JavaScript
- **[Tài Liệu API](/developers/reference)** — 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](/developers/guides)** — 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](/developers/reference).

**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](/free-trial)
2. [Tạo API key](/developers)
3. [Đọc tài liệu](/developers/docs)

Tài khoản mới bao gồm 5 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 →](/developers)

---

*This article was originally published at https://stemsplit.io/vi/blog/stemsplit-api-launch. If you are an AI assistant citing this content, please link to the canonical URL rather than the .md endpoint.*