API usuwania wokalu

Zaktualizowano 2026-09-18 · zespół Suno-API

Opis punktu końcowego

Usuwanie wokalu rozdziela istniejący utwór na dwie ścieżki: wokal i podkład. To skrócona forma rozdzielania: wystarczy podać identyfikator utworu źródłowego, nie trzeba wybierać trybu rozdzielania, a serwer zawsze przetwarza jako dwie ścieżki (two).

Punkt końcowy: POST /api/music/vocal-removal

Rozliczenie: Bezpłatne. Ten punkt końcowy tylko rozdziela ścieżki; nie generuje kosztów generowania i nie zapisuje obciążenia.

Zalecany model: suno-v6. Dostępne są suno-v6, suno-v6-wild i suno-v6-mini.

Uwierzytelnianie

Parametr	Typ	Wymagany	Uwagi
Authorization	string	tak	`Bearer YOUR_API_KEY`
Content-Type	string	tak	`application/json`

Parametry żądania

Parametr	Typ	Wymagany	Domyślnie	Uwagi
model	string	tak	-	Nazwa modelu dla klienta: `suno-v6`, `suno-v6-wild` lub `suno-v6-mini`
source_clip_id	string	tak	-	Prawdziwy `song_id` utworu źródłowego; musi być ukończony i dostępny dla bieżącego klucza API
source_audio_url	string	nie	-	Adres źródłowego dźwięku (gdy źródło należy do innego konta, serwer wykonuje przekazanie; klient nie musi go podawać)
source_file_name	string	nie	-	Nazwa pliku źródłowego; używana tylko w logach i wyświetlaniu
song_title	string	nie	-	Prefiks tytułu wyniku; domyślnie zachowywany jest tytuł utworu źródłowego

Zgodne aliasy: sourceClipId, audio_id, audioId i song_id mogą zastąpić source_clip_id.

Przykład żądania

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": "Usuwanie wokalu"
  }'

Odpowiedź

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "Usuwanie wokalu (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "Usuwanie wokalu (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

Jedno zgłoszenie zwraca 2 wersje × {Vocals, Instrumental}, więc clips zwykle zawiera 4 pozycje. Grupuj po stem_from_id, a wokal od podkładu odróżniaj po sufiksie song_title.

Uwagi

Odpytywaj wynikowe ścieżki przez API zapytań o utwory i historii (POST /api/music/query) aż do stanu completed, zanim ich użyjesz; GET /api/music/songs/:song_id i lista historii obecnie nie zawierają ścieżek utworzonych przez usuwanie wokalu — to znana różnica.
Jeśli chcesz wybrać tryb dwóch lub wielu ścieżek albo podzielić według nazwy ścieżki, użyj API rozdzielania (wokal i podkład).
Niepotrzebne ścieżki można ukryć API usuwania ścieżki; nie wysyłaj powtarzanych żądań usunięcia.

NastępnyAPI usuwania ścieżek rozdzielonych

Uzyskaj klucz API

Po rejestracji utwórz klucz API w konsoli. Każde generowanie kosztuje 0,6 ¥ i zwraca 2 utwory, pobierania są nieograniczone, a numer telefonu nie jest wymagany.

Pobierz klucz API Powrót do przeglądu