Skip to main content
POST

Authentifizierung

string
erforderlich
Alle Endpunkte erfordern eine Authentifizierung per Bearer TokenAPI Key erhalten:Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API Key zu erhaltenFügen Sie ihn bei der Verwendung dem Request-Header hinzu:

Anfrageparameter

string
erforderlich
Modellname, immer "flowmusic" übergeben (Groß-/Kleinschreibung wird nicht beachtet)
string
erforderlich
Modellversion, immer "lyria-3.5" übergeben
Lyria 3.5 verwendet weiterhin flowmusic als Modellnamen. Ändern Sie model nicht in lyria-3.5 oder flowmusic-lyria-3.5.
string
Prompt zur Beschreibung von Musikstil oder KlangBeispiel: "upbeat pop music with piano"
sound_prompt und lyrics dürfen nicht beide leer sein (mindestens einer muss übergeben werden). Pro Anfrage wird nur ein Musikstück generiert.
string
Songtext; kann zuvor über den Endpunkt Songtext generieren erzeugt und hier eingefügt werdenBeispiel: "[Verse 1]\nAuch die längste Nacht endet im Morgenlicht\n..."
string
Titel der generierten Musik
string
BPM (Schläge pro Minute), muss ≥ 1 seinBeispiel: "120"
integer
Generierungsdauer (Sekunden)Unterstützter Bereich: 1 ~ 240 Sekunden
string
Zufalls-Seed zur Reproduktion von Ergebnissen
Wird bei derselben Anfrage derselbe Seed-Wert übergeben, entstehen ähnliche Ergebnisse, eine vollständige Übereinstimmung ist jedoch nicht garantiert.

Antwort

integer
Antwortstatuscode, bei Erfolg 200
array
Array der zurückgegebenen Daten

Anwendungsfälle

Szenario 1: Generierung nur mit Stil-Prompt

Szenario 2: Songtext + Stil zu einem Song

Aufgabenergebnis abfragenDie Musikgenerierung ist eine asynchrone Aufgabe; nach der Übermittlung wird eine task_id zurückgegeben. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um Fortschritt und Ergebnis der Generierung abzufragen.

Beispiel für abgeschlossenes Aufgabenergebnis

Beispiel einer Abfrageantwort (GET /v1/music/tasks/{task_id}):