Flow Music
Musik mit Lyria 3.5 generieren
Mit Lyria 3.5 und Flow Music Musik aus Text generieren – mit Stil-Prompts, Songtexten, BPM- und Längensteuerung
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" übergebenLyria 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 Sekundenstring
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}):