Zum Hauptinhalt springen
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 entscheidet, welche Felder wirksam werden: Felder, die im falschen Modus angegeben werden, werden vom Upstream-System stillschweigend ignoriert (kein Fehler). Bei custom=true werden prompt (Songtext), title, tags, negative_tags, auto_lyrics, style_weight, weirdness_constraint, audio_weight und persona_id wirksam und gpt_description wird ignoriert; bei custom=false wird nur gpt_description gelesen (in diesem Fall erforderlich — fehlt es, wird beim Absenden ein 400 zurückgegeben). vocal_gender wirkt in beiden Modi. Wird custom weggelassen, leitet das Backend es in dieser Reihenfolge ab: prompt vorhanden → true; kein prompt, aber gpt_description vorhanden → false; andernfalls tags/title vorhanden → true.

Authorizations

Authorization
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

model
string
Standard:"suno"
Audiomodell. Übergeben Sie derzeit suno (ohne Angabe standardmäßig suno).
task_ids
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).
audio_indexes
integer[]
Ein zu task_ids paralleles Array, das für jede Aufgabe den wievielten Song aus dem Ergebnis-music[] angibt (1-basiert, standardmäßig jeweils 1).
instrumental
boolean
Standard:"false"
Ob rein instrumental (true=ohne Gesang); ohne Angabe standardmäßig false (mit Gesang).
version
string
Standard:"v5.5"
Generierungsversion: v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, beeinflusst Audioqualität und Abrechnung; ohne Angabe standardmäßig v5.5, ein ungültiger Wert gibt beim Absenden direkt ein 400 zurück.
custom
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).
prompt
string
Songtext. Wirkt bei custom=true (im Inspirationsmodus ignoriert).
gpt_description
string
Inspirations-Prompt. Erforderlich bei custom=false — fehlt er, schlägt die Anfrage bereits beim Absenden mit 400 fehl (das Upstream-System wird nicht aufgerufen, es wird nichts berechnet).
title
string
Titel. Wirkt nur bei custom=true.
tags
string
Stil-Tags. Wirkt nur bei custom=true.
negative_tags
string
Auszuschließende Stil-Tags. Wirkt nur bei custom=true.
auto_lyrics
boolean
true=den bereitgestellten Songtext kreativ umschreiben. Wirkt nur bei custom=true.
style_weight
number
Stilgewicht, 0.001.00 (Werte außerhalb des Bereichs geben beim Absenden direkt ein 400 zurück). Wirkt nur bei custom=true.
weirdness_constraint
number
Kreativitätsgewicht, 0.001.00 (Alias weirdness). Wirkt nur bei custom=true.
audio_weight
number
Audiogewicht, 0.001.00. Wirkt nur bei custom=true.
vocal_gender
string
Gesangsgeschlecht: Male / Female. Wirkt in beiden Modi.
persona_id
string
Persona-Stil-id. Wirkt nur bei custom=true.
Ergebnis abrufen: Diese Schnittstelle ist eine asynchrone Aufgabe. Nach dem Absenden erhalten Sie eine task_id. Fragen Sie GET /v1/music/tasks/{task_id} im Abstand von 3–5s ab, bis status completed oder failed ist (die Musikgenerierung dauert üblicherweise 30–120s; während der Generierung ist status pending und progress läuft von Warteschlange 10 → bereit 50 → fertig 100). Bei Abschluss entnehmen Sie audio_url aus data.result.music[]. Bei einem Fehlschlag nennt data.error.message den Grund und das vorab reservierte Kontingent wird automatisch zurückerstattet.

Response

code
integer
Antwort-Statuscode
data
array
Zurückgegebenes Daten-Array