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 видалення доріжки; не надсилайте повторні запити на видалення.