Skip to main content
POST
Quell-Audiotrack referenzieren: Für Operationen auf Basis vorhandener Songs müssen Sie sich keine zusätzlichen IDs merken. Übergeben Sie einfach task_id (die task_id der Aufgabe, die den Quell-Audiotrack erzeugt hat) + audio_index (den wievielten Song aus dem Ergebnis-music[], 1-basiert, 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"
Der wievielte Song aus data.music[] des referenzierten Quellaufgaben-Ergebnisses (1-basiert; Standard 1; eine Generierung erzeugt üblicherweise 2 Songs: Index 1 und 2).
string
Songtext des Ersatzabschnitts.
integer
erforderlich
Startpunkt der Ersetzung (Sekunden). Fehlt er, wird sofort 400 zurückgegeben.
integer
erforderlich
Endpunkt der Ersetzung (Sekunden). Fehlt er, wird sofort 400 zurückgegeben.
string
Standard:"v5.5"
Generierungsversion: v4 / v4.5+ / v5 / v5.5; ohne Angabe standardmäßig v5.5. Jeder andere Wert (einschließlich v3.5 / v4.5 / v4.5-all) gibt zum Zeitpunkt des Absendens direkt 400 zurück.
string
Kontext-Songtext.
string
Titel.
string
Stil-Tags.
string
Auszuschließende Stil-Tags.
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). Nehmen Sie nach Abschluss die ersetzte audio_url aus data.result.music[]. Bei einem Fehlschlag gibt data.error.message den Grund an und das vorab reservierte Kontingent wird automatisch zurückerstattet.

Response

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array