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).
Bei extend ist custom optional und standardmäßig true. Mit custom=true enthält prompt den fortzusetzenden Liedtext. Nur ein explizites custom=false lässt gpt_description die Fortsetzung steuern.

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; Standard 1).
number
erforderlich
Sekunde, ab der die Fortsetzung beginnt. Mindestens 1 und kleiner als die tatsächliche Dauer der Quellspur; Dezimalwerte werden unterstützt.
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
Standard:"true"
true = mit Liedtext aus prompt verlängern; false = Inspirationsfortsetzung. Standard bei Auslassung ist true.
string
Songtext für die Verlängerung. Wirkt bei custom=true.
string
Inspirationsbeschreibung. Gilt nur bei ausdrücklichem custom=false und steuert die Fortsetzungsrichtung.
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.
string
Gesangsgeschlecht: Male / Female. Funktioniert in beiden Modi.
number
Stilgewichtung, 0.00–1.00 (Werte außerhalb des Bereichs geben bereits beim Absenden direkt 400 zurück). Wirkt nur bei custom=true.
number
Kreativitätsgewichtung, 0.00–1.00. Der alte Name weirdness_constraint wird unterstützt; neue Anfragen sollten weirdness verwenden.
number
Audiogewichtung, 0.00–1.00. Wirkt nur bei custom=true.
boolean
true=den übergebenen Songtext kreativ umschreiben. Wirkt nur bei custom=true.
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"
Ob der Max-Modus aktiviert wird. Erfordert custom=true und wird zum Doppelten des Standardpreises berechnet.
string
Audioausgabeformat: mp3 / m4a / wav.
Ergebnis: Fragen Sie die asynchrone Aufgabe bis zum Abschluss ab und lesen Sie dann die audio_url der verlängerten Spur aus data.result.music[]. Bei einem Fehler wird der abgezogene Betrag automatisch erstattet.

Response

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array