Skip to main content
POST
Quellspur: Die Quelle muss aus einer mit POST /v1/music/generations/uploadTask erstellten Upload-Aufgabe stammen. Übergeben Sie deren task_id und wählen Sie mit audio_index eine Spur aus data.result.music[] (ab 1, Standard 1). Eine normale Generierungsaufgabe kann nicht als Quelle dienen.
custom steuert, welche Felder gelten. Übermittelte Felder müssen auch dann alle Typ-, Bereichs- und Längenanforderungen erfüllen, wenn sie im gewählten Modus nicht gelten. Bei custom=true gelten prompt, title, tags, negative_tags, style_weight, weirdness und audio_weight; gpt_description wird ignoriert. Bei custom=false gilt nur das erforderliche gpt_description; fehlt es, wird beim Senden 400 zurückgegeben. vocal_gender gilt in beiden Modi. Ohne custom wird anhand von prompt, dann gpt_description, anschließend tags oder title auf true beziehungsweise false geschlossen.

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
Von POST /v1/music/generations/uploadTask zurückgegebene task_id. Normale Generierungsaufgaben sind nicht zulässig. Eine fehlende oder ungültige Quelle führt beim Senden zu 400.
integer
Standard:"1"
Wählt eine Spur aus data.result.music[] der Quellaufgabe aus (ab 1; Standard 1).
string
Standard:"v6"
Öffentliche Version: v6 / v6-wild / v6-mini. Standard ist v6; bei Verwendung von custom_model_id weglassen.
string
Vollständige UUID aus der Modellerstellungsaufgabe. Kann nicht mit version verwendet werden.
boolean
true=benutzerdefinierter Modus (prompt wird als Songtext verwendet); false=Inspirationsmodus (verwendet gpt_description); ohne Angabe wird anhand des Inhalts abgeleitet (siehe die Warnung oben).
string
Songtext. Wirkt bei custom=true (im Inspirationsmodus ignoriert).
string
Inspirations-Prompt. Erforderlich bei custom=false — fehlt er, schlägt die Anfrage bereits beim Absenden mit 400 fehl (es wird nichts berechnet).
string
Titel. Wirkt nur bei custom=true.
string
Stil-Tags. Wirkt nur bei custom=true.
string
Auszuschließende Stil-Tags. Wirkt nur bei custom=true.
number
Stilgewichtung, 0.00–1.00 (Werte außerhalb des Bereichs geben bereits beim Absenden direkt 400 zurück). Wirkt nur bei custom=true.
number
Kreativitätsgewichtung, 0.00–1.00. Der alte Name weirdness_constraint wird unterstützt; neue Anfragen sollten weirdness verwenden.
number
Audiogewichtung, 0.00–1.00. Wirkt nur bei custom=true.
string
Gesangsgeschlecht: Male / Female. Funktioniert in beiden Modi.
string
Stilvariation: off / normal / high / extra / max.
boolean
Standard:"false"
Aktiviert den Max-Modus. Erfordert den benutzerdefinierten Modus und wird zum Doppelten des Standardpreises abgerechnet.
string
Audioausgabeformat: mp3 / m4a / wav. Dieser Endpunkt unterstützt kein Feld für die Zieldauer.
Diese API unterstützt weder auto_lyrics, persona_id, instrumental noch Zieldauer.
Ergebnis abrufen: Dies ist eine asynchrone Aufgabe. Fragen Sie nach der Übermittlung alle 3–5 Sekunden den Aufgabenstatus ab. Die Generierung dauert meist 30–120 Sekunden; Zwischenstatus und Fortschritt ändern sich nicht zwingend in festen Schritten. Lesen Sie nach Abschluss audio_url aus data.result.music[]. Bei einem Fehler wird der abgezogene Betrag automatisch erstattet.

Response

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array