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).

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 zum Zeitpunkt des Absendens ein 400 zurückgegeben.
integer
Standard:"1"
Wählt eine Spur aus data.result.music[] der Quellaufgabe aus (ab 1; Standard 1).
string
Songtext des Ersatzabschnitts.
number
erforderlich
Startpunkt der Ersetzung (Sekunden). Fehlt er, wird sofort 400 zurückgegeben.
number
erforderlich
Endzeit in Sekunden. Muss 0 ≤ start_s < end_s erfüllen und darf die bekannte Quelldauer nicht überschreiten.
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.
string
Kontext-Songtext.
string
Titel.
string
Stil-Tags.
string
Auszuschließende Stil-Tags.
string
Stilvariation: off / normal / high / extra / max. Optional.
boolean
Standard:"false"
Aktiviert den Max-Modus; Abrechnung zum Doppelten des Standardpreises.
string
Audioausgabeformat: mp3 / m4a / wav. Dieser Endpunkt unterstützt kein Feld für die Zieldauer.
prompt ist der ursprüngliche Liedtextkontext, infill_lyrics der neue Liedtext nach der Ersetzung. Senden Sie weder custom, instrumental, auto_lyrics noch alte Bearbeitungssitzungsfelder.
Ergebnis abrufen: Fragen Sie die asynchrone Aufgabe bis zum Abschluss ab und lesen Sie dann die audio_url der ersetzten Spur aus data.result.music[]. Bei einem Fehler steht der Grund in data.error.message; der abgezogene Betrag wird automatisch erstattet.

Response

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array