API zum Löschen eines Abschnitts
Beschreibung des Endpunkts
Das Löschen eines Abschnitts entfernt einen Zeitbereich aus einem bestehenden Song und fügt die verbleibenden Teile zu einer neuen Version zusammen.
Endpunkt: POST /api/music/remove-section
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
| Parameter | Typ | Erforderlich | Hinweise |
|---|---|---|---|
| Authorization | string | ja | Bearer YOUR_API_KEY |
| Content-Type | string | ja | application/json |
Anfrageparameter
| Parameter | Typ | Erforderlich | Standard | Hinweise |
|---|---|---|---|---|
| model | string | ja | - | Modellname für Kunden: suno-v6, suno-v6-wild oder suno-v6-mini |
| source_clip_id | string | ja | - | Die echte song_id des Quellsongs; er muss abgeschlossen und für den aktuellen API-Schlüssel zugänglich sein |
| crop_start_s | number | ja | - | Startsekunde des zu löschenden Bereichs; muss 0 oder größer sein |
| crop_end_s | number | ja | - | Endsekunde des zu löschenden Bereichs; muss größer als crop_start_s sein |
| song_title | string | nein | - | Titel des Ergebnisses |
Beispielanfrage
curl -X POST https://www.suno-api.io/api/music/remove-section \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"crop_start_s": 30,
"crop_end_s": 45,
"song_title": "Gekürzte Version"
}'
Antwort
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "Gekürzte 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.
Hinweise
- Der gelöschte Bereich muss
0 <= crop_start_s < crop_end_serfüllen und innerhalb der Dauer des Quellsongs liegen. - Um einen Bereich zu behalten statt ihn zu löschen, nutzen Sie die Crop-API.
API-Schlüssel erhalten
Erstellen Sie nach der Anmeldung einen API-Schlüssel in der Konsole. Jede Generierung kostet 0,6 ¥ und liefert 2 Tracks, Downloads sind unbegrenzt und eine Telefonnummer ist nicht erforderlich.
API-Schlüssel holen Zurück zur Übersicht