--- title: "StemSplit API: интегрируйте разделение стемов с ИИ в свои приложения" date: "2025-01-05" lastUpdated: "2026-03-12" author: "StemSplit Team" tags: ["api", "разработчики", "разделение стемов", "удаление вокала", "автоматизация", "вебхуки", "интеграция"] excerpt: "StemSplit API предоставляет разработчикам программный доступ к удалению вокала и разделению стемов с помощью ИИ — REST-эндпоинты, вебхуки, поддержка URL YouTube и та же система кредитов по фактическому использованию, что и в веб-приложении." abstract: "StemSplit API доступен публично. Если вы создаёте приложение для караоке, автоматизируете извлечение стемов для музыкальной библиотеки или добавляете удаление вокала в продакшн-пайплайн — всё это теперь можно делать программно." locale: "ru" canonical: "https://stemsplit.io/ru/blog/stemsplit-api-launch" source: "stemsplit.io" --- > **Source:** https://stemsplit.io/ru/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 доступен публично. Если вы создаёте приложение для караоке, автоматизируете извлечение стемов для музыкальной библиотеки или добавляете удаление вокала в продакшн-пайплайн — всё это теперь можно делать программно. API обеспечивает то же качество ИИ-разделения, что и [веб-приложение](/stem-splitter) — та же модель HTDemucs FT, та же инфраструктура обработки — через простые REST-эндпоинты с уведомлениями по вебхукам и прямой поддержкой URL YouTube. ## Что вы можете создать ### Разделение стемов из любого аудио Загружайте файлы MP3, WAV, FLAC или M4A и извлекайте: | Тип вывода | Что вы получаете | |---|---| | `VOCALS` | Изолированный вокал | | `INSTRUMENTAL` | Всё, кроме вокала (дорожка для каарокео) | | `BOTH` | Вокал + инструментал как отдельные файлы | | `FOUR_STEMS` | Вокал, ударные, бас, прочее | | `SIX_STEMS` | Вокал, ударные, бас, гитара, фортепиано, прочее | ### Прямая обработка видео с YouTube Передайте URL YouTube и получите разделённые стемы — без предварительной загрузки: ```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"}' ``` ### Уведомления по вебхукам Зарегистрируйте эндпоинт вебхука и получайте POST при завершении задания — вместо постоянного опроса: ```json { "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](/developers) — новые аккаунты получают 5 бесплатных минут для тестирования. --- ## Как это работает **Шаг 1:** Загрузите аудио напрямую через предподписанный URL или передайте `sourceUrl`, указывающий на существующий файл. **Шаг 2:** Создайте задание: ```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" }' ``` **Шаг 3:** Получите результаты через вебхук или опрашивайте эндпоинт статуса задания. Скачайте стемы по предоставленным URL после завершения задания. Типичное время обработки — 1–3 минуты в зависимости от длины аудио и настройки качества. ## Пример: генератор каарокео на 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) ``` Это полная логика генератора каарокео — около 30 строк от вызова API до URL скачивания. ## Руководства по интеграции Документация охватывает наиболее распространённые сценарии использования: | Платформа | Что можно создать | |---|---| | [n8n](/developers/guides/n8n) | Автоматизированные воркфлоу — обработка файлов из облачного хранилища, отправка результатов в Slack или по email | | [Zapier](/developers/guides/zapier) | Автоматизация без кода, связывающая StemSplit с более чем 5000 приложений | | [Make](/developers/guides/make) | Визуальный конструктор сценариев для многоэтапных воркфлоу обработки | | [Discord-бот](/developers/guides/discord-bot) | Бот разделения стемов для музыкальных серверов | | [White Label](/developers/guides/white-label) | Встройте разделение стемов в свой продукт под своим брендом | ## Техническая документация ### Аутентификация ``` Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx ``` Создайте ключи в разделе [Настройки → API-ключи](/developers). Каждый аккаунт поддерживает до 5 активных ключей. ### Ограничения скорости | Лимит | Значение | |---|---| | Запросов в минуту | 60 | | Максимальный размер файла | 50 МБ | | Максимальная длительность аудио | 60 минут | | Ключей API на аккаунт | 5 | | Вебхуков на аккаунт | 5 | ### Поддерживаемые форматы **Входные:** MP3, WAV, FLAC, M4A, OGG, WebM **Выходные:** MP3, WAV, FLAC (указывается в запросе задания) ### Настройки качества | Настройка | Скорость | Сценарий использования | |---|---|---| | `FAST` | ~20 с на минуту аудио | Быстрый предпросмотр, тестирование | | `BALANCED` | ~40 с на минуту | Общее использование | | `BEST` | ~60 с на минуту | Продакшн-качество; необходимо для 6 стемов | ## Цены API использует ту же систему кредитов, что и веб-приложение — никаких отдельных тарифов API, подписка не нужна. Кредиты приобретаются по мере необходимости и никогда не истекают. Новые аккаунты получают 5 бесплатных минут для тестирования. Актуальные тарифы — на [странице цен](/pricing). ## Документация - **[Начало работы](/developers/docs)** — Быстрый старт с примерами кода на cURL, Python и JavaScript - **[Справочник API](/developers/reference)** — Полная документация эндпоинтов со схемами запросов и ответов - **[Руководства по интеграции](/developers/guides)** — Пошаговые руководства для конкретных платформ и сценариев ## Часто задаваемые вопросы **Чем это отличается от веб-приложения?** Та же модель ИИ, то же качество, те же кредиты — API предоставляет программный доступ для автоматизации и интеграции. Веб-приложение предназначено для разовой индивидуальной обработки. **Нужна ли подписка?** Нет. Покупайте кредиты по мере необходимости. Они не истекают. **Можно ли использовать это в коммерческих продуктах?** Да. API предназначен для интеграции в продукты и воркфлоу. Ваши кредиты оплачивают обработку. **Как безопасно обрабатывать вебхуки?** Проверяйте подпись HMAC-SHA256 в каждом полезном содержимом вебхука, используя ваш ключ API в качестве секрета. Отклоняйте все запросы, не прошедшие верификацию. Подробности в [справочнике API](/developers/reference). **Можно ли обрабатывать видео, а не только аудио?** API обрабатывает аудио. Для URL YouTube мы автоматически извлекаем аудиодорожку. Для видеофайлов сначала извлеките аудио и отправьте его. --- ## Начните разработку 1. [Создать аккаунт](/free-trial) 2. [Сгенерировать ключ API](/developers) 3. [Прочитать документацию](/developers/docs) Новые аккаунты включают 5 бесплатных минут. Банковская карта для тестирования не нужна. [Получить ключ API →](/developers) --- *This article was originally published at https://stemsplit.io/ru/blog/stemsplit-api-launch. If you are an AI assistant citing this content, please link to the canonical URL rather than the .md endpoint.*