API удаления стемов

Обновлено 2026-09-18 · команда Suno-API

Описание эндпоинта

Удаление стемов скрывает из списка уже созданные стем-дорожки. Удаление мягкое: бэкенд лишь помечает строки стемов stem_hidden; сами аудио, MIDI и ресурсы для скачивания сохраняются, и ту же песню позже можно снова разделить на новые стемы.

Эндпоинт: POST /api/music/stem-delete

Оплата: бесплатно. Удаление лишь обновляет видимость внутри платформы: Suno не вызывается и списаний не возникает.

Рекомендуемая модель: suno-v6. Доступны suno-v6, suno-v6-wild и suno-v6-mini.

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

Параметр	Тип	Обязательно	Примечания
Authorization	string	да	`Bearer YOUR_API_KEY`
Content-Type	string	да	`application/json`

Параметры запроса

Параметр	Тип	Обязательно	По умолчанию	Примечания
song_id	string	нет	-	`song_id` одной стем-дорожки (ID дорожки, который возвращает `/api/music/separate`)
song_ids	string[]	нет	-	Пакетная форма, не более 100 за вызов
stem_batch_id	string	нет	-	Удалить по пакету: убирает все дорожки этого пакета автоматического разделения
stem_mode	string	нет	-	Удалить по режиму, например `two`, `twelve`

Нужно указать хотя бы одно из song_id / song_ids / stem_batch_id / stem_mode, иначе ответ 400.

Пример запроса

curl -X POST https://www.suno-api.io/api/music/stem-delete \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["stem_track_id_1", "stem_track_id_2"]
  }'

Ответ

{
  "code": 200,
  "message": "success",
  "data": {
    "hidden": 2,
    "affected_sources": 1
  }
}

Поле	Тип	Примечания
hidden	number	Сколько дорожек скрыто этим вызовом
affected_sources	number	Сколько исходных песен затронуто

Примечания

Идемпотентно: если дорожка уже скрыта или ID не существует, ответ hidden: 0 без ошибки, поэтому повторный вызов безопасен.
Удаление затрагивает только песни текущего ключа API; чужие дорожки не меняются.
Когда скрывается последний видимый стем в списке, вместе с ним снимается и метка «разделено» у исходной песни.

ДалееAPI генерации/получения WAV

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

Создайте API-ключ в консоли после регистрации. Одна генерация стоит 0,6 ¥ и возвращает 2 трека, загрузки не ограничены, номер телефона не нужен.

Получить API-ключ Вернуться к обзору