API dodawania podkładu instrumentalnego

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

Opis punktu końcowego

Dodawanie podkładu instrumentalnego aranżuje utwór na nowo, uzupełnia go instrumentami lub tworzy nową strukturę akompaniamentu.

Punkt końcowy: POST /api/music/add-instrumental

Rozliczenie: Płatne, rozliczane według żądanego modelu; faktycznie pobrana kwota zależy od konfiguracji cen w panelu administracyjnym.

Max Mode / Variety: ten punkt końcowy obsługuje opcjonalne parametry max_mode i variety (0-4). Przy włączonym max_mode to wywołanie jest rozliczane po podwójnej stawce; variety nie podnosi kosztu. Co oznaczają i jak je wysyłać — w sekcji „Parametry zaawansowane" w Przeglądzie nowego API.

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

Czasy oczekiwania i limity czasu (ważne): to punkt końcowy synchroniczny — zamówienie zostaje przyjęte i przekazane do generowania dopiero, gdy przyjdzie odpowiedź. Z pomiarów: większość żądań odpowiada w 1-3 sekundy, około 10% przekracza 30 sekund, a najdłuższe trwa około 230 sekund. Ustaw limit czasu klienta na 300 sekund lub więcej; brak odpowiedzi nie oznacza, że nic nie zostało wygenerowane, a ponawianie od razu po limicie czasu duplikuje zamówienie i pobiera opłatę ponownie. Jeśli połączenie się zerwało, sprawdź później przez GET /api/music/songs. Zobacz „Czasy oczekiwania i ustawienia limitu czasu" w Przeglądzie nowego API.

Uwierzytelnianie

Parametry żądania

Przykład żądania

curl -X POST https://www.suno-api.io/api/music/add-instrumental \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "lyrics": "",
    "style_tags": "cinematic, strings, acoustic guitar",
    "song_title": "Wersja ze wzmocnionym podkładem",
    "audio_weight": 1,
    "wait_completion": false
  }'

Odpowiedź

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Wersja ze wzmocnionym podkładem",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "Wersja ze wzmocnionym podkładem",
        "status": "pending"
      }
    ]
  }
}

Jedno wywołanie zwraca 2 wyniki (rozliczane jako 2 utwory); w przykładzie pokazano 2. Kieruj się długością tablicy clips i nie ustawiaj stałej liczby iteracji. Zapisz clips[].song_id i odpytuj API zapytań o utwory i historii aż do stanu completed. Potem możesz odtworzyć lub pobrać utwór przez audio_url; szczegóły w API generowania i pobierania WAV oraz w pozostałych punktach pobierania.

Uwagi

• source_clip_id musi być prawdziwym, ukończonym identyfikatorem utworu dostępnym dla bieżącego klucza API; nie można użyć identyfikatora zastępczego pending:.
• Dodawanie podkładu instrumentalnego nie jest coverem; jeśli potrzebujesz coveru, użyj API coveru na podstawie klipu źródłowego.
• Aby dodać do istniejącego utworu konkretny instrument lub ścieżkę, użyj API dodawania ścieżki.