Zum Hauptinhalt springen
POST
Quell-Audiotrack referenzieren: Für Operationen auf Basis vorhandener Songs müssen Sie sich keine Upstream-IDs merken. Übergeben Sie einfach task_id (die eigene task_id der Aufgabe, die den Quell-Audiotrack erzeugt hat) + audio_index (den wievielten Song aus dem Ergebnis-music[], 1-basiert, Standard 1).
Diese Schnittstelle hat keine Versionsdimension: Übergeben Sie version nicht — wird es dennoch übergeben, wird es verworfen und wirkt sich nicht auf die Abrechnung aus.
Voraussetzung: concat kann nur von extend (Fortsetzung) erzeugte Segmente zusammenfügen. Ist die Quelle kein extend-Produkt (z. B. ein normal in einem Durchgang generierter kompletter Song), wird die Anfrage beim Absenden mit einem 400 abgelehnt und der vorgelagerte Dienst wird nicht aufgerufen.

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_id
string
erforderlich
Die eigene task_id der Quellaufgabe — muss ein von extend (Fortsetzung) erzeugtes Segment sein (siehe die Warnung oben). Wenn sie fehlt, kein extend-Produkt ist oder die Quelle nicht aufgelöst werden kann, wird beim Absenden ein 400 zurückgegeben.
audio_index
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).
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 (dauert üblicherweise 30–120s; während der Generierung ist status pending und progress läuft von queued 10 → ready 50 → done 100). Bei Abschluss nehmen Sie die audio_url des vollständigen Songs aus data.result.music[]. Bei einem Fehlschlag gibt data.error.message den Grund an und das vorab reservierte Kontingent wird automatisch zurückerstattet.

Response

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