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).
audio_urls
array
erforderlich
Array aus 1–4 öffentlich zugänglichen Audio-URLs.
version
string
Standard:"v5.5"
Generierungsversion: v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, beeinflusst Klangqualität und Abrechnung; ohne Angabe standardmäßig v5.5.
prompt
string
Songtext / Inhalt.
title
string
Titel.
tags
string
Stil-Tags.
negative_tags
string
Auszuschließende Stil-Tags.
style_weight
number
Stilgewichtung, 0.001.00.
weirdness_constraint
number
Kreativitätsgrad, 0.001.00 (Alias weirdness).
audio_weight
number
Audiogewichtung, 0.001.00.
vocal_gender
string
Gesangsgeschlecht: Male / Female.
auto_lyrics
boolean
true=den übergebenen Songtext kreativ umschreiben.
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 (die Musikgenerierung dauert üblicherweise 30–120s; 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