Skip to main content
POST
Quell-Audiotrack referenzieren: Der Quell-Audiotrack muss ein von Ihnen über uploadTask hochgeladenes eigenes Audio sein. Übergeben Sie task_id + audio_index dieser Upload-Aufgabe (den wievielten Song aus dem Ergebnis-music[], 1-basiert, Standard 1). Ein generierter Audiotrack als Quelle schlägt fehl – Sie können nur Ihre selbst hochgeladenen Audiotracks referenzieren.
custom bestimmt, welche Felder wirksam werden: Felder, die im falschen Modus gesetzt werden, werden stillschweigend ignoriert (kein Fehler). Bei custom=true wirken prompt (Songtext), title, tags, negative_tags, style_weight, weirdness_constraint und audio_weight, und gpt_description wird verworfen; bei custom=false wird nur gpt_description gelesen (erforderlich in diesem Fall — fehlt es, wird bereits beim Absenden 400 zurückgegeben). vocal_gender funktioniert in beiden Modi. Wird custom weggelassen, leitet das Backend es in dieser Reihenfolge ab: prompt vorhanden → true; kein prompt, aber gpt_description vorhanden → false; andernfalls tags/title vorhanden → true.

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 uploadTask-Upload-Aufgabe, in der sich der Quell-Audiotrack befindet (muss ein von Ihnen selbst hochgeladener Audiotrack sein; ein Audiotrack aus einer Generierungsaufgabe als Quelle schlägt fehl). Fehlt sie oder kann die Quelle nicht aufgelöst werden, wird bereits beim Absenden 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
Standard:"v5.5"
Generierungsversion: nur v5 / v5.5; ohne Angabe Standard v5.5. Jeder andere Wert gibt bereits beim Absenden direkt 400 zurück.
boolean
true=benutzerdefinierter Modus (prompt wird als Songtext verwendet); false=Inspirationsmodus (verwendet gpt_description); ohne Angabe wird anhand des Inhalts abgeleitet (siehe die Warnung oben).
string
Songtext. Wirkt bei custom=true (im Inspirationsmodus ignoriert).
string
Inspirations-Prompt. Erforderlich bei custom=false — fehlt er, schlägt die Anfrage bereits beim Absenden mit 400 fehl (es wird nichts berechnet).
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.
number
Stilgewichtung, 0.001.00 (Werte außerhalb des Bereichs geben bereits beim Absenden direkt 400 zurück). Wirkt nur bei custom=true.
number
Kreativitätsgrad, 0.001.00 (Alias weirdness). Wirkt nur bei custom=true.
number
Audiogewichtung, 0.001.00. Wirkt nur bei custom=true.
string
Gesangsgeschlecht: Male / Female. Funktioniert in beiden Modi.
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 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

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array