Zum Hauptinhalt springen
POST
Quell-Audiotrack referenzieren: Dieser Endpunkt verwendet nicht task_id + audio_index, sondern benötigt direkt eine öffentlich zugängliche audio_url (aus der die Upstream-Seite die Klangfarbe extrahiert). Fehlt sie, wird 400 audio_url cannot be empty zurückgegeben.
Dieser Endpunkt hat keine Versionsdimension: Übergeben Sie version nicht — wird es übergeben, wird es verworfen und beeinflusst die Abrechnung nicht.

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).
audio_url
string
erforderlich
Öffentlich zugängliche URL des Quell-Audiotracks, aus der die Upstream-Seite die Klangfarbe extrahiert. Nur MP3 / WAV werden akzeptiert. Fehlt sie, wird 400 audio_url cannot be empty 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 Warteschlange 10 → bereit 50 → fertig 100). Das Ergebnis enthält Informationen zur erstellten Klangfarbe. 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