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 bestimmt, welche Felder verwendet werden. Alle übermittelten Werte müssen die Anforderungen an Typ, Bereich und Länge erfüllen, auch wenn ein Feld im gewählten Modus nicht verwendet wird. Bei custom=true enthält prompt den Liedtext und kann bei instrumental=false gemäß den folgenden Bedingungen erforderlich sein. Bei custom=false ist gpt_description erforderlich. Wird custom weggelassen, leitet das Backend den Modus aus prompt, gpt_description, tags und title ab.

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
Stilgewicht, 0.001.00 (Werte außerhalb des Bereichs geben beim Absenden direkt ein 400 zurück). Wirkt nur bei custom=true.
number
Kreativitätsgewichtung von 0.00 bis 1.00. weirdness_constraint ist ein Kompatibilitätsalias; verwenden Sie für neue Anfragen weirdness.
number
Audiogewicht, 0.001.00. Wirkt nur bei custom=true.
string
Gesangsgeschlecht: Male / Female. Wirkt 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