Zum Hauptinhalt springen
POST

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).
version
string
Standard:"v5.5"
Generierungsversion: nur v5 / v5.5; ohne Angabe standardmäßig v5.5.
prompt
string
erforderlich
Beschreibung des Soundeffekts (wird auf das Upstream-sound abgebildet); fehlt sie, wird bereits beim Absenden 400 zurückgegeben (kein Upstream-Aufruf, keine Abrechnung).
type
string
Standard:"one-shot"
Art des Soundeffekts: one-shot (Standard, einmalig) / loop (loopfähig).
bpm
integer
Tempo, 1300; Werte außerhalb des Bereichs geben bereits beim Absenden direkt 400 zurück.
key
string
Tonarten-Enumeration: Dur-Tonarten C / C# / D / D# / E / F / F# / G / G# / A / A# / B; Moll-Tonarten hängen m an (Cm / C#m / … / Bm). Es wird nur die Kreuz-Schreibweise (#) unterstützt; Tonarten mit b (Db / Eb usw.) und B# geben 400 zurück (key param error).
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 (während der Generierung ist status pending, und progress steigt: in Warteschlange 10 → bereit 50 → fertig 100). Nach Abschluss nehmen Sie audio_url aus data.result.music[]. Bei einem Fehlschlag nennt data.error.message den Grund, und das vorab reservierte Kontingent wird automatisch zurückerstattet.

Response

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