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
clip_id der herunterzuladenden Musik, stammt aus result.music[].clip_id einer erfolgreich abgeschlossenen Aufgabe
string
erforderlich
Download-FormatMögliche Werte:
  • mp3 - verlustbehaftete Kompression, geringe Dateigröße
  • wav - verlustfrei, geeignet für die Postproduktion

Antwort

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

Anwendungsfälle

Szenario 1: Verlustfreies wav exportieren

Aufgabenergebnis abfragenDas Herunterladen von Audio ist eine asynchrone Aufgabe; nach der Übermittlung wird eine task_id zurückgegeben. Verwenden Sie den Endpunkt Aufgabenstatus abrufen, um Fortschritt und Ergebnis abzufragen. Das Ergebnis befindet sich einheitlich in result.music[0].audio_url (url hat denselben Wert); die Felder format / mime_type geben das tatsächliche Format an.

Beispiel für abgeschlossenes Aufgabenergebnis

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