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).
custom ist für extend weder erforderlich, noch wird es abgeleitet — Sie können es weglassen, und die Verlängerung funktioniert einwandfrei; wird es übergeben, wird es unverändert an das Upstream-System weitergereicht. custom=true verlängert entlang des prompt-Songtexts; bei custom=false oder ohne Angabe können Sie gpt_description (Inspirations-Prompt) übergeben, um die Richtung zu steuern.

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 Aufgabe, die den Quell-Audiotrack erzeugt hat. Fehlt sie oder kann die Quelle nicht aufgelöst werden, wird bereits beim Absenden 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).
continue_at
integer
erforderlich
Ab welcher Sekunde weitergeschrieben wird.
version
string
Standard:"v5.5"
Generierungsversion: v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, beeinflusst Klangqualität und Abrechnung; ohne Angabe Standard v5.5, und ein ungültiger Wert gibt bereits beim Absenden direkt 400 zurück.
custom
boolean
Kein Übergeben nötig (für extend nicht erzwungen). true=Verlängerung entlang des prompt-Songtexts; false=inspirationsgeleitete Verlängerung.
prompt
string
Songtext für die Verlängerung. Wirkt bei custom=true.
gpt_description
string
Inspirations-Prompt. Wirkt bei custom=false oder wenn custom weggelassen wird (steuert die Richtung der Verlängerung).
title
string
Titel. Wirkt nur bei custom=true.
tags
string
Stil-Tags. Wirkt nur bei custom=true.
negative_tags
string
Auszuschließende Stil-Tags. Wirkt nur bei custom=true.
vocal_gender
string
Gesangsgeschlecht: Male / Female. Funktioniert in beiden Modi.
style_weight
number
Stilgewichtung, 0.001.00 (Werte außerhalb des Bereichs geben bereits beim Absenden direkt 400 zurück). Wirkt nur bei custom=true.
weirdness_constraint
number
Kreativitätsgrad, 0.001.00 (Alias weirdness). Wirkt nur bei custom=true.
audio_weight
number
Audiogewichtung, 0.001.00. Wirkt nur bei custom=true.
auto_lyrics
boolean
true=den übergebenen Songtext kreativ umschreiben. Wirkt nur bei custom=true.
persona_id
string
Persona-Stil-ID. Wirkt nur bei custom=true.
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 steigt: in Warteschlange 10 → bereit 50 → fertig 100). Nach Abschluss nehmen Sie die verlängerte audio_url aus data.result.music[]. Bei einem Fehlschlag nennt data.error.message den Grund, und das vorab reservierte Kontingent wird automatisch zurückerstattet.

Response

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