{ "error": { "message": "Die aktuelle Gruppenkapazität ist ausgelastet, bitte später erneut versuchen", "type": "rate_limit_error", "param": "", "code": "rate_limit_error" }}
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
/
v1
/
music
/
generations
curl --request POST \ --url https://api.apimart.ai/v1/music/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "flowmusic", "version": "lyria-3.5", "title": "My Song", "sound_prompt": "upbeat pop music with piano", "bpm": "120", "length": 60 }'
import requestsurl = "https://api.apimart.ai/v1/music/generations"payload = { "model": "flowmusic", "version": "lyria-3.5", "title": "My Song", "sound_prompt": "upbeat pop music with piano", "bpm": "120", "length": 60}headers = { "Authorization": "Bearer <token>", "Content-Type": "application/json"}response = requests.post(url, json=payload, headers=headers)print(response.json())
{ "error": { "message": "Die aktuelle Gruppenkapazität ist ausgelastet, bitte später erneut versuchen", "type": "rate_limit_error", "param": "", "code": "rate_limit_error" }}
curl --request POST \ --url https://api.apimart.ai/v1/music/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "flowmusic", "version": "lyria-3.5", "title": "My Song", "sound_prompt": "upbeat pop music with piano", "bpm": "120", "length": 60 }'
import requestsurl = "https://api.apimart.ai/v1/music/generations"payload = { "model": "flowmusic", "version": "lyria-3.5", "title": "My Song", "sound_prompt": "upbeat pop music with piano", "bpm": "120", "length": 60}headers = { "Authorization": "Bearer <token>", "Content-Type": "application/json"}response = requests.post(url, json=payload, headers=headers)print(response.json())
{ "error": { "message": "Die aktuelle Gruppenkapazität ist ausgelastet, bitte später erneut versuchen", "type": "rate_limit_error", "param": "", "code": "rate_limit_error" }}
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:
Authorization: Bearer YOUR_API_KEY
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 lyricsdü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"
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
Anzeigen Array-Elemente
string
Aufgabenstatus, bei der ersten Übermittlung submitted
string
Eindeutige Aufgaben-ID, dient zum Abfragen von Aufgabenstatus und Ergebnis
Anwendungsfälle
Szenario 1: Generierung nur mit Stil-Prompt
{ "model": "flowmusic", "version": "lyria-3.5", "title": "My Song", "sound_prompt": "upbeat pop music with piano", "bpm": "120", "length": 60}
Szenario 2: Songtext + Stil zu einem Song
{ "model": "flowmusic", "version": "lyria-3.5", "title": "Durchhalten", "lyrics": "[Verse 1]\nAuch die längste Nacht endet im Morgenlicht\n...", "sound_prompt": "energetic rock with electric guitar", "length": 120}
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}):