Skip to main content
POST
Quellaudio-Referenz: Für Vorgänge auf Basis vorhandener Songs sind keine zusätzlichen IDs erforderlich. Übergeben Sie die task_id der Aufgabe, die die Quellspur erzeugt hat, sowie audio_index für die Position in data.result.music[] (ab 1, Standard 1).
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
Die task_id der Quellaufgabe. Sie muss eine mit uploadTask erstellte Upload-Aufgabe bezeichnen. Fehlt der Wert, ist es keine Upload-Aufgabe oder kann die Quelle nicht aufgelöst werden, wird beim Senden 400 zurückgegeben.
integer
Standard:"1"
Wählt eine Spur aus data.result.music[] der Quellaufgabe aus (ab 1; 1 ist die erste Spur und der Standardwert).
number
erforderlich
Startpunkt des Samples (Sekunden). Fehlt er, wird sofort ein 400 zurückgegeben.
number
erforderlich
Endzeit des Samples in Sekunden. Muss 0 ≤ start_s < end_s erfüllen und darf die bekannte Quelldauer nicht überschreiten.
boolean
Standard:"false"
Ob rein instrumental (true=ohne Gesang); ohne Angabe standardmäßig false (mit Gesang).
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
Bedingt erforderlich: Bei custom=true && instrumental=false muss ein Liedtext angegeben werden. Im Inspirationsmodus wird das Feld nicht verwendet; ein übermittelter Wert muss dennoch die Längenbegrenzung einhalten.
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.
boolean
true=den bereitgestellten Songtext kreativ umschreiben. Wirkt nur bei custom=true.
number
Stilgewicht, 0.00–1.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.00–1.00. Wirkt nur bei custom=true.
string
Gesangsgeschlecht: Male / Female. Wirkt in beiden Modi.
string
Stilvariation: off / normal / high / extra / max. Optional.
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.
Die Quellaufgabe muss eine uploadTask-Upload-Aufgabe sein. start_s und end_s sind beide erforderlich; der Dienst ergänzt keine Standardwerte wie 0 oder 60.
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