Extend-API (Verlängerung)

Aktualisiert am 2026-09-18 · Suno-API-Team

Beschreibung des Endpunkts

Extend setzt einen bestehenden Song ab einem gewählten Zeitpunkt fort und generiert die folgende Passage.

Endpunkt: POST /api/music/extend

Abrechnung: Kostenpflichtig, derzeit standardmäßig 0,6 ¥ pro Aufruf. Der tatsächlich berechnete Betrag folgt der aktuellen Preis-Konfiguration im Backoffice.

Max Mode / Variety: Dieser Endpunkt unterstützt die optionalen Parameter max_mode und variety (0-4). Mit aktiviertem max_mode wird dieser Aufruf zum doppelten Preis abgerechnet (0,6 → 1,2 ¥ pro Aufruf); variety kostet nichts extra. Bedeutung und Schreibweise stehen im Abschnitt „Erweiterte Parameter“ in der Übersicht der neuen API.

Wartezeiten und Timeouts (wichtig): Dies ist ein synchroner Endpunkt — die Bestellung wird erst angenommen und der Generierung übergeben, wenn die Antwort eintrifft. Gemessen antworten die meisten Anfragen in 1-3 Sekunden, etwa 10 % brauchen länger als 30 Sekunden und die längste liegt bei rund 230 Sekunden. Setzen Sie den Client-Timeout auf 300 Sekunden oder mehr; keine Antwort bedeutet nicht, dass nichts generiert wurde, und wiederholen Sie nicht direkt nach einem Timeout (das dupliziert die Bestellung und berechnet erneut). Wenn die Verbindung abbrach, prüfen Sie später mit GET /api/music/songs. Siehe „Wartezeiten und Timeout-Einstellungen“ in der Übersicht der neuen API.

Anfrageparameter

Headers

Body-Parameter

Beispielanfrage

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": "setze den Refrain mit mehr Intensität fort",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "Verlängerte Version",
    "waitAudio": false
  }'

Antwort

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "extended_clip_id",
        "song_title": "Verlängerte Version",
        "status": "pending"
      }
    ]
  }
}

Kompatible Felder

Die alten Feldnamen werden weiterhin akzeptiert:

Hinweise

• Nicht direkt am Ende ansetzen: Die Länge der Verlängerung entspricht im Wesentlichen „dem, was nach dem Startpunkt übrig bleibt“. Liegt der Startpunkt zu nah am Ende, besteht das Ergebnis nur aus wenigen Sekunden — gemessen lieferte ein 242-Sekunden-Song, ab Sekunde 240 verlängert, nur 2,7 Sekunden (berechnet wird trotzdem pro Aufruf). Lassen Sie mindestens 10 Sekunden nach dem Startpunkt.
• Extend hat keine Schwelle „Quelle zu kurz“: gemessen lieferte ein 9,6-Sekunden-Clip, ab Sekunde 5 verlängert, normal einen Song; eine kurze Quelle oder ein kurzer Rest sind also kein Ablehnungsgrund.
• Der Startpunkt muss größer als 0 sein: continueAt=0 wird von der Plattform angenommen und dann verworfen, ohne Fehlergrund; beginnen Sie also direkt nach der ersten Sekunde.
• Ein Aufruf liefert 2 Ergebnisse (als 2 Songs abgerechnet); richten Sie sich nach der Länge des clips-Arrays.
• Das Ergebnis ist ein neues Werk; der Originalsong bleibt unberührt.