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.

Verwendung

Verwendung A — Neuinterpretation in einem angegebenen Stil (am häufigsten, empfohlen) Geben Sie den Quellsong + Zielstil-tags an; um custom müssen Sie sich nicht kümmern (sobald das System tags sieht, behandelt es dies automatisch als custom=true):
Für mehr Kontrolle können Sie zusätzlich prompt (Songtext) / title angeben. Verwendung B — Inspirationsmodus (custom=false) Geben Sie keinen konkreten Stil an und lassen Sie das Modell improvisieren; Sie müssen jedoch gpt_description angeben und den gewünschten Effekt beschreiben:
Wählen Sie eine der beiden Verwendungen — übergeben Sie nicht nur custom=false ohne gpt_description (das schlägt bereits beim Absenden mit 400 fehl).

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 Aufgabe, die den Quell-Audiotrack erzeugt hat. Fehlt sie oder kann die Quelle nicht aufgelöst werden, wird bereits beim Absenden 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).
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
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
Zielstil-Tags. Wirkt nur bei custom=true.
string
Auszuschließende Stil-Tags. Wirkt nur bei custom=true.
number
Stilgewichtung, 0.001.00 (Werte außerhalb des Bereichs geben bereits beim Absenden direkt 400 zurück). Wirkt nur bei custom=true.
number
Kreativitätsgewichtung, 0.001.00. Der alte Name weirdness_constraint wird unterstützt; neue Anfragen sollten weirdness verwenden.
number
Audiogewichtung, 0.001.00. Wirkt nur bei custom=true.
string
Gesangsgeschlecht: Male / Female. Funktioniert in beiden Modi.
string
Persona-Stil-ID. Gilt nur bei custom=true und kann nicht zusammen mit custom_model_id verwendet werden.
integer
Zieldauer von 10–360 Sekunden. Nur bei custom=true; die tatsächliche Dauer ergibt sich aus dem Ergebnis.
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.
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