Skip to main content
POST
Quellaudio-Referenz: Für Vorgänge auf Basis vorhandener Songs sind keine zusätzlichen IDs erforderlich. Übergeben Sie die task_id der Aufgabe, die die Quellspur erzeugt hat, sowie audio_index für die Position in data.result.music[] (ab 1, Standard 1).
Diese Schnittstelle hat keine Versionsdimension: Übergeben Sie kein version — wird es übergeben, wird es verworfen und beeinflusst die Abrechnung nicht.

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. Fehlt sie oder kann die Quelle nicht aufgelöst werden, wird beim Absenden direkt ein 400 zurückgegeben.
integer
Standard:"1"
Wählt eine Spur aus data.result.music[] der Quellaufgabe aus (ab 1; Standard 1).
number
Startpunkt des Ausschnitts (Sekunden).
number
Endpunkt des Ausschnitts (Sekunden).
Diese Funktion ist veraltet. Erstellen Sie bei neuen Integrationen eine Persona direkt auf der Persona-Seite und machen Sie vox_audio_id im neuen Ablauf nicht zum Pflichtfeld.
Ergebnis abrufen: Diese API erstellt eine asynchrone Aufgabe. Fragen Sie nach der Übermittlung GET /v1/music/tasks/{task_id} ab, bis status completed oder failed ist. Dieses Ergebnis bleibt nur für den alten Ablauf erhalten; der neue Persona-Ablauf benötigt es nicht.

Response

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array