Skip to main content
POST
custom steuert die Interpretation der Textfelder. Bei custom=true enthält prompt den Liedtext und title, style, negative_tags, auto_lyrics sowie persona_id gelten. Bei custom=false enthält prompt die Inspirationsbeschreibung; die Felder des benutzerdefinierten Modus werden ignoriert. style_weight, weirdness_constraint, audio_weight und vocal_gender werden in beiden Modi validiert und angewendet.
Dieser Endpunkt verwendet leicht abweichende Feldnamen: style statt tags.

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).
boolean
Standard:"false"
false=Inspirationsmodus; true=benutzerdefinierter Modus (prompt dient als Songtext). Standardwert ist false.
boolean
Standard:"false"
true=reine Instrumentalmusik, ohne Gesang. Standardwert ist false.
string
Öffentliche Version: v6 / v6-wild / v6-mini. Entweder dieses Feld oder custom_model_id ist erforderlich; bei einem benutzerdefinierten Modell weglassen.
string
Vollständige UUID der erstellten benutzerdefinierten Modellaufgabe. Kann nicht mit version oder persona_id verwendet werden; mit diesem Feld gilt die Preisstufe des benutzerdefinierten Modells.
string
Inspirationsbeschreibung/Liedtext. Bei custom=false erforderlich, maximal 3.000 Zeichen; bei custom=true und instrumental=false ebenfalls erforderlich, maximal 5.000 Zeichen. Für benutzerdefinierte Instrumentalmusik optional.
string
Titel im benutzerdefinierten Modus, maximal 80 Zeichen. Bei custom=false wird er ignoriert.
string
Stil-Tag im benutzerdefinierten Modus, maximal 1.000 Zeichen. Bei custom=false wird es ignoriert.
string
Negative Stil-Tags (unerwünschte Stile). Wirkt nur bei custom=true.
boolean
true=den übergebenen Songtext kreativ umschreiben. Wirkt nur bei custom=true.
string
Persona-Stil-ID. Gilt nur bei custom=true und kann nicht zusammen mit custom_model_id verwendet werden.
string
Gesangsgeschlecht: Male / Female (m / f / male / female werden ebenfalls akzeptiert und vom Backend normalisiert). Funktioniert in beiden Modi.
number
Stilgewichtung, 0.00–1.00. Wird in beiden Modi validiert und angewendet.
number
Kreativitätswert, 0.00–1.00. Wird in beiden Modi validiert und angewendet.
number
Audiogewichtung, 0.00–1.00. Wird in beiden Modi validiert und angewendet.
string
Stilvariation: off / normal / high / extra / max. Optional; kein fester Standardwert.
boolean
Standard:"false"
Ob der Max-Modus aktiviert wird. Erfordert custom=true und wird zum Doppelten des Standardpreises berechnet.
string
Audioausgabeformat: mp3 / m4a / wav. Ohne Angabe gilt die Standardeinstellung des Dienstes.
integer
Zieldauer von 10–360 Sekunden. Nur bei custom=true; die tatsächliche Enddauer ergibt sich aus dem Aufgabenergebnis.
Ergebnis abrufen: Dies ist eine asynchrone Aufgabe. Fragen Sie nach der Übermittlung alle 3–5 Sekunden den Aufgabenstatus ab. Die Musikgenerierung dauert meist 30–120 Sekunden; status kann dabei pending oder processing sein und progress ändert sich nicht zwingend in festen Schritten. Lesen Sie nach Abschluss audio_url aus data.result.music[] (image_url, video_url, title, duration usw. sind ebenfalls enthalten). Bei einem Fehler wird der abgezogene Betrag automatisch erstattet.

Response

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array