API Extend (przedłużanie)

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

Opis punktu końcowego

Extend kontynuuje istniejący utwór od wybranego momentu i generuje kolejny fragment.

Punkt końcowy: POST /api/music/extend

Rozliczenie: Płatne, obecnie domyślnie 0,6 ¥ za wywołanie. Faktycznie pobierana kwota zależy od bieżącej 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 cenie (0,6 → 1,2 ¥ za wywołanie); variety nie kosztuje nic dodatkowo. Znaczenie i sposób wysyłania opisano w sekcji „Parametry zaawansowane” Przeglądu nowego API.

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.

Parametry żądania

Headers

Parametry treści

Przykład żądania

curl -X POST https://www.suno-api.io/api/music/extend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "prompt": "kontynuuj refren z większą intensywnością",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "Wersja przedłużona",
    "waitAudio": false
  }'

Odpowiedź

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "extended_clip_id",
        "song_title": "Wersja przedłużona",
        "status": "pending"
      }
    ]
  }
}

Pola zgodne

Stare nazwy pól nadal są przyjmowane:

Uwagi

• Nie zaczynaj tuż przy końcu: długość przedłużenia to w praktyce „to, co zostało po punkcie startowym”. Gdy punkt startowy jest zbyt blisko końca, wynik ma tylko kilka sekund — z pomiarów: utwór 242 sekundy przedłużony od 240. sekundy dał jedynie 2,7 sekundy (a opłata za wywołanie i tak jest pobierana). Zostaw po punkcie startowym co najmniej 10 sekund.
• Extend nie ma progu „źródło za krótkie”: z pomiarów: klip 9,6 sekundy przedłużony od 5. sekundy normalnie dał utwór, więc krótkie źródło lub krótka reszta nie są powodem odmowy.
• Punkt startowy musi być większy niż 0: continueAt=0 jest przyjmowany przez platformę, a potem unieważniany, bez zwracania przyczyny błędu; zaczynaj więc zaraz po pierwszej sekundzie.
• Jedno wywołanie zwraca 2 wyniki (rozliczane jako 2 utwory); kieruj się długością tablicy clips.
• Wynik to nowe dzieło; oryginalny utwór pozostaje nietknięty.