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-ключ
Створіть API-ключ у консолі після реєстрації. Одна генерація коштує 0,6 ¥ і повертає 2 треки, завантаження необмежені, номер телефону не потрібен.
Отримати API-ключ Повернутися до огляду