API zum Hinzufügen von Instrumental

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

Beschreibung des Endpunkts

Instrumental hinzufügen arrangiert einen bestehenden Song neu, ergänzt Instrumente oder erzeugt eine neue Begleitstruktur.

Endpunkt: POST /api/music/add-instrumental

Abrechnung: Kostenpflichtig, abgerechnet nach dem angeforderten Modell; der tatsächlich berechnete Betrag folgt der 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; variety kostet nichts extra. Bedeutung und Schreibweise stehen im Abschnitt „Erweiterte Parameter" der Übersicht der neuen API.

Empfohlenes Modell: suno-v6. Verfügbar sind suno-v6, suno-v6-wild und suno-v6-mini.

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.

Authentifizierung

Anfrageparameter

Beispielanfrage

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": "Version mit verstärkter Begleitung",
    "audio_weight": 1,
    "wait_completion": false
  }'

Antwort

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Version mit verstärkter Begleitung",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "Version mit verstärkter Begleitung",
        "status": "pending"
      }
    ]
  }
}

Ein Aufruf liefert 2 Ergebnisse (als 2 Songs abgerechnet); das Beispiel zeigt 2. Richten Sie sich nach der Länge des clips-Arrays und verdrahten Sie keine feste Anzahl im Code. Speichern Sie clips[].song_id und fragen Sie die API zum Abfragen von Songs ab, bis der Status completed ist. Danach können Sie über audio_url abspielen oder herunterladen; siehe WAV-Erzeugung/-Abruf-API und die Download-Endpunkte.

Hinweise

• source_clip_id muss eine echte, abgeschlossene Song-ID sein, auf die der aktuelle API-Schlüssel zugreifen kann; eine pending:-Platzhalter-ID ist nicht zulässig.
• Instrumental hinzufügen ist kein Cover; für ein Cover nutzen Sie die API für Cover aus einem Quell-Clip.
• Um einem bestehenden Song ein bestimmtes Instrument oder eine Spur hinzuzufügen, nutzen Sie die API zum Hinzufügen einer Spur.