API удаления вокала

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

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

Удаление вокала разбирает существующую песню на две дорожки: вокал и аккомпанемент. Это быстрая форма разделения на дорожки: достаточно передать идентификатор исходной песни, выбирать режим разделения не нужно, сервер всегда обрабатывает как две дорожки (two).

Эндпоинт: POST /api/music/vocal-removal

Оплата: Бесплатно. Этот эндпоинт только разделяет дорожки: расходов на генерацию не возникает и запись о списании не создаётся.

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

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

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

Совместимые псевдонимы: sourceClipId, audio_id, audioId и song_id можно использовать вместо source_clip_id.

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

curl -X POST https://www.suno-api.io/api/music/vocal-removal \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "Удаление вокала"
  }'

Ответ

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "Удаление вокала (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "Удаление вокала (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

Одна отправка возвращает 2 версии × {Vocals, Instrumental}, поэтому в clips обычно 4 элемента. Группируйте по stem_from_id, а вокал и аккомпанемент различайте по суффиксу song_title.

Примечания

• Опрашивайте полученные дорожки через API запроса песен (POST /api/music/query) до состояния completed, прежде чем использовать; GET /api/music/songs/:song_id и список истории сейчас не включают дорожки, созданные удалением вокала — это известное отличие.
• Если нужно выбрать режим двух или нескольких дорожек либо разделить по именам дорожек, используйте API разделения на дорожки (вокал и аккомпанемент).
• Ненужные дорожки можно скрыть через API удаления дорожки; не отправляйте повторные запросы на удаление.