Crop-API (Zuschneiden)

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

Beschreibung des Endpunkts

Crop behält einen Zeitbereich eines bestehenden Songs und erzeugt eine neue, zugeschnittene Version.

Endpunkt: POST /api/music/crop

Abrechnung: Kostenpflichtig, abgerechnet nach dem angeforderten Modell; der tatsächlich berechnete Betrag folgt der Preis-Konfiguration im Backoffice.

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/crop \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "crop_start_s": 10,
    "crop_end_s": 48,
    "song_title": "Zugeschnittene Version"
  }'

Antwort

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Zugeschnittene Version",
        "status": "processing"
      }
    ]
  }
}

Ein Aufruf liefert 1 Ergebnis (Bearbeitungsaktionen erzeugen keine 2 Songs). Speichern Sie clips[].song_id und fragen Sie die API zum Abfragen von Songs ab, bis der Status completed ist. Manchmal hat die erste Antwort noch keine abfragbare song_id registriert; warten Sie kurz und fragen Sie erneut.

Hinweise

• Der behaltene Bereich muss 0 <= crop_start_s < crop_end_s erfüllen und innerhalb der Dauer des Quellsongs liegen.
• Anders als beim Zuschneiden nutzen Sie zum Löschen einer Passage die API zum Löschen eines Abschnitts.