API usuwania ścieżek rozdzielonych

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

Opis punktu końcowego

Usuwanie ścieżek rozdzielonych ukrywa w liście już wygenerowane ścieżki. Usuwanie jest miękkie: backend tylko oznacza wiersze ścieżek stem_hidden; samo audio, MIDI i zasoby do pobrania pozostają, a ten sam utwór można później rozdzielić ponownie na nowe ścieżki.

Punkt końcowy: POST /api/music/stem-delete

Rozliczenie: Bezpłatnie. Usuwanie zmienia jedynie widoczność wewnątrz platformy; nie wywołuje Suno i nie powoduje żadnych opłat.

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
song_id	string	nie	-	`song_id` pojedynczej ścieżki (ID zwracane przez `/api/music/separate`)
song_ids	string[]	nie	-	Wariant wsadowy, maksymalnie 100 na wywołanie
stem_batch_id	string	nie	-	Usuwanie według partii: usuwa wszystkie ścieżki tej partii automatycznego rozdziału
stem_mode	string	nie	-	Usuwanie według trybu, np. `two`, `twelve`

Należy podać co najmniej jedno z song_id / song_ids / stem_batch_id / stem_mode, inaczej odpowiedź to 400.

Przykład żądania

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"]
  }'

Odpowiedź

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

Pole	Typ	Uwagi
hidden	number	Liczba ścieżek ukrytych tym wywołaniem
affected_sources	number	Liczba dotkniętych utworów źródłowych

Uwagi

Idempotentne: jeśli ścieżka jest już ukryta lub ID nie istnieje, odpowiedź to hidden: 0 bez błędu, więc powtarzanie wywołania jest bezpieczne.
Usuwanie dotyczy tylko utworów bieżącego klucza API; nie swoje ścieżki nie są zmieniane.
Gdy ostatnia widoczna ścieżka na liście zostanie ukryta, znacznik „rozdzielony" utworu źródłowego również zostaje usunięty.

NastępnyAPI generowania/pobierania WAV

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