StemSplit API: интегрируйте разделение стемов с ИИ в свои приложения

StemSplit API доступен публично. Если вы создаёте приложение для караоке, автоматизируете извлечение стемов для музыкальной библиотеки или добавляете удаление вокала в продакшн-пайплайн — всё это теперь можно делать программно.

API обеспечивает то же качество ИИ-разделения, что и веб-приложение — та же модель HTDemucs FT, та же инфраструктура обработки — через простые REST-эндпоинты с уведомлениями по вебхукам и прямой поддержкой URL YouTube.

Что вы можете создать

Разделение стемов из любого аудио

Загружайте файлы MP3, WAV, FLAC или M4A и извлекайте:

Прямая обработка видео с YouTube

Передайте URL YouTube и получите разделённые стемы — без предварительной загрузки:

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"}'

Уведомления по вебхукам

Зарегистрируйте эндпоинт вебхука и получайте POST при завершении задания — вместо постоянного опроса:

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

Полезные данные вебхука включают подписи HMAC-SHA256 для верификации.

---

Готовы начать? Получите ключ API — новые аккаунты получают 5 бесплатных минут для тестирования.

---

Как это работает

Шаг 1: Загрузите аудио напрямую через предподписанный URL или передайте sourceUrl, указывающий на существующий файл.

Шаг 2: Создайте задание:

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"
  }'

Шаг 3: Получите результаты через вебхук или опрашивайте эндпоинт статуса задания. Скачайте стемы по предоставленным URL после завершения задания. Типичное время обработки — 1–3 минуты в зависимости от длины аудио и настройки качества.

Пример: генератор каарокео на 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)

Это полная логика генератора каарокео — около 30 строк от вызова API до URL скачивания.

Руководства по интеграции

Документация охватывает наиболее распространённые сценарии использования:

Техническая документация

Аутентификация

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx

Создайте ключи в разделе Настройки → API-ключи. Каждый аккаунт поддерживает до 5 активных ключей.

Ограничения скорости

Поддерживаемые форматы

Входные: MP3, WAV, FLAC, M4A, OGG, WebM

Выходные: MP3, WAV, FLAC (указывается в запросе задания)

Настройки качества

Цены

API использует ту же систему кредитов, что и веб-приложение — никаких отдельных тарифов API, подписка не нужна. Кредиты приобретаются по мере необходимости и никогда не истекают. Новые аккаунты получают 5 бесплатных минут для тестирования. Актуальные тарифы — на странице цен.

Документация

• Начало работы — Быстрый старт с примерами кода на cURL, Python и JavaScript
• Справочник API — Полная документация эндпоинтов со схемами запросов и ответов
• Руководства по интеграции — Пошаговые руководства для конкретных платформ и сценариев

Часто задаваемые вопросы

Чем это отличается от веб-приложения? Та же модель ИИ, то же качество, те же кредиты — API предоставляет программный доступ для автоматизации и интеграции. Веб-приложение предназначено для разовой индивидуальной обработки.

Нужна ли подписка? Нет. Покупайте кредиты по мере необходимости. Они не истекают.

Можно ли использовать это в коммерческих продуктах? Да. API предназначен для интеграции в продукты и воркфлоу. Ваши кредиты оплачивают обработку.

Как безопасно обрабатывать вебхуки? Проверяйте подпись HMAC-SHA256 в каждом полезном содержимом вебхука, используя ваш ключ API в качестве секрета. Отклоняйте все запросы, не прошедшие верификацию. Подробности в справочнике API.

Можно ли обрабатывать видео, а не только аудио? API обрабатывает аудио. Для URL YouTube мы автоматически извлекаем аудиодорожку. Для видеофайлов сначала извлеките аудио и отправьте его.

---

Начните разработку

1. Создать аккаунт
2. Сгенерировать ключ API
3. Прочитать документацию

Новые аккаунты включают 5 бесплатных минут. Банковская карта для тестирования не нужна.

Получить ключ API →