Zum Hauptinhalt springen
POST
custom bestimmt, welche Felder wirksam werden: Felder, die im falschen Modus gesetzt werden, werden vom Upstream stillschweigend ignoriert (kein Fehler). Bei custom=true (benutzerdefiniert) wirken prompt (Songtext), title, style, negative_tags, auto_lyrics, persona_id, style_weight, weirdness_constraint und audio_weight; bei custom=false (Inspiration) dient prompt als Inspirationsbeschreibung, und title/style sowie die obigen benutzerdefinierten Felder werden ignoriert. vocal_gender funktioniert in beiden Modi.
Diese Schnittstelle verwendet eine eigene Route, daher unterscheiden sich einige Feldnamen von anderen Schnittstellen: style (statt tags).

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).
custom
boolean
Standard:"false"
false=Inspirationsmodus; true=benutzerdefinierter Modus (prompt dient als Songtext). Standardwert ist false.
instrumental
boolean
Standard:"false"
true=reine Instrumentalmusik, ohne Gesang. Standardwert ist false.
version
string
erforderlich
Generierungsversion: v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, beeinflusst Klangqualität und Abrechnung. In beiden Modi erforderlich; ohne Angabe wird direkt 400 zurückgegeben.
prompt
string
Inspirations-Prompt / Songtext. Erforderlich bei custom=false (dient als Inspirationsbeschreibung). Bei custom=true: erforderlich, wenn instrumental=false (dient als Songtext); optional, wenn instrumental=true. Fehlt der Wert, wird bereits beim Absenden 400 zurückgegeben (kein Upstream-Aufruf, keine Abrechnung).
title
string
Titel (benutzerdefinierter Modus). Wird bei custom=false ignoriert (Inspirationsmodus).
style
string
Stil-Tags (benutzerdefinierter Modus, entspricht dem Upstream-Feld tags). Wird bei custom=false ignoriert (Inspirationsmodus).
negative_tags
string
Negative Stil-Tags (unerwünschte Stile). 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.
vocal_gender
string
Gesangsgeschlecht: Male / Female (m / f / male / female werden ebenfalls akzeptiert und vom Backend normalisiert). Funktioniert in beiden Modi.
style_weight
number
Stilgewichtung, 0.001.00. Wirkt nur bei custom=true.
weirdness_constraint
number
Kreativitätsgrad, 0.001.00. Wirkt nur bei custom=true.
audio_weight
number
Audiogewichtung, 0.001.00. 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 audio_url aus data.result.music[] (außerdem image_url / video_url / title / duration usw.). 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