Zum Hauptinhalt springen
POST
Quell-Audiotrack referenzieren: Für Operationen auf Basis vorhandener Songs müssen Sie sich keine Upstream-IDs merken. Übergeben Sie einfach task_id (die eigene task_id der Aufgabe, die den Quell-Audiotrack erzeugt hat) + audio_index (den wievielten Song aus dem Ergebnis-music[], 1-basiert, Standard 1).
Diese Schnittstelle hat keine Versionsdimension: Übergeben Sie version nicht — wird es dennoch übergeben, wird es verworfen und wirkt sich nicht auf die Abrechnung aus.

Authorizations

Authorization
string
erforderlich
Alle Schnittstellen erfordern eine Authentifizierung mit einem Bearer TokenAPI-Key abrufen:Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API-Key zu erhaltenFügen Sie bei der Verwendung im Request-Header hinzu:

Body

model
string
Standard:"suno"
Audiomodell. Übergeben Sie derzeit suno (ohne Angabe standardmäßig suno).
task_id
string
erforderlich
Die eigene task_id der Aufgabe, die den Quell-Audiotrack erzeugt hat. Wenn sie fehlt oder die Quelle nicht aufgelöst werden kann, wird beim Absenden ein 400 zurückgegeben.
audio_index
integer
Standard:"1"
Der wievielte Song aus data.music[] des referenzierten Quellaufgaben-Ergebnisses (1-basiert; Standard 1; eine Generierung erzeugt üblicherweise 2 Songs: Index 1 und 2).
start_s
integer
erforderlich
Startpunkt des zu entfernenden Bereichs (Sekunden; wird auf das vorgelagerte crop_start_s abgebildet). Wenn er fehlt, wird sofort ein 400 zurückgegeben, ohne den vorgelagerten Dienst aufzurufen.
end_s
integer
erforderlich
Endpunkt des zu entfernenden Bereichs (Sekunden; wird auf das vorgelagerte crop_end_s abgebildet). Wenn er fehlt, wird sofort ein 400 zurückgegeben, ohne den vorgelagerten Dienst aufzurufen.
Ergebnis abrufen: Diese Schnittstelle ist eine asynchrone Aufgabe. Nach dem Absenden erhalten Sie eine task_id. Fragen Sie GET /v1/music/tasks/{task_id} im Abstand von 3–5s ab, bis status completed oder failed ist (dauert üblicherweise 30–120s; während der Generierung ist status pending und progress läuft von queued 10 → ready 50 → done 100). Bei Abschluss nehmen Sie die verarbeitete audio_url aus data.result.music[]. Bei einem Fehlschlag gibt data.error.message den Grund an und das vorab reservierte Kontingent wird automatisch zurückerstattet.

Response

code
integer
Antwort-Statuscode
data
array
Zurückgegebenes Daten-Array