Skip to main content
POST
Quell-Audiotrack referenzieren: Mashup benötigt genau 2 Quell-Audiotracks – angegeben über task_ids (Array unserer task_id mit Länge 2), optional audio_indexes (ein dazu paralleles Array, das für jede Aufgabe den wievielten Song aus music[] angibt, 1-basiert, standardmäßig jeweils 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
Array unserer task_id der Aufgaben, zu denen die 2 Quell-Audiotracks gehören (müssen genau 2 sein; jede andere Anzahl gibt beim Absenden direkt ein 400 zurück).
integer[]
Ein zu task_ids paralleles Array, das aus data.result.music[] jeder Aufgabe eine Spur auswählt (ab 1; Standard je Element 1).
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 oder persona_id 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
Persona-Stil-ID. Gilt nur bei custom=true und kann nicht zusammen mit custom_model_id verwendet werden.
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.
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