Flow Music
Generate Music
Flow Music text-to-music generation. Supports style prompts / lyrics / BPM / duration control, generating one track per request
POST
Authentication
All endpoints require Bearer Token authenticationGet your API Key:Visit the API Key management page to get your API KeyAdd it to the request header:
Request Parameters
Model name, must be
"flowmusic" (case-insensitive)Music style or sound description promptExample:
"upbeat pop music with piano"sound_prompt and lyrics cannot both be empty (at least one is required). Each request generates only one track.Lyrics text; you can first obtain lyrics from the Generate Lyrics endpoint and fill them in hereExample:
"[Verse 1]\nEven the longest night turns to dawn\n..."Title of the generated music
BPM (beats per minute), must be ≥ 1Example:
"120"Generation duration (seconds)Supported range:
1 ~ 240 secondsRandom seed, used to reproduce results
Passing the same seed value with the same request produces similar results, but exact reproducibility is not guaranteed.
Response
Response status code, 200 on success
Array of returned data
Use Cases
Scenario 1: Generate from a style prompt only
Scenario 2: Lyrics + style to a full song
Query Task ResultsMusic generation is an asynchronous task; a
task_id is returned after submission. Use the Get Task Status endpoint to query generation progress and results.Completed Task Result Example
Query response example (GET /v1/music/tasks/{task_id}):