Skip to main content
POST
Quell-Audiotrack referenzieren: Für Operationen auf Basis vorhandener Songs müssen Sie sich keine zusätzlichen IDs merken. Übergeben Sie einfach task_id (die 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

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

string
Standard:"suno"
Audiomodell. Übergeben Sie derzeit suno (ohne Angabe standardmäßig suno).
string
erforderlich
Die 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.
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).
integer
erforderlich
Startpunkt des zu entfernenden Bereichs (Sekunden). Wenn er fehlt, wird sofort ein 400 zurückgegeben.
integer
erforderlich
Endpunkt des zu entfernenden Bereichs (Sekunden). Wenn er fehlt, wird sofort ein 400 zurückgegeben.
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

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array