Skip to main content
POST

Authentication

string
required
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

string
required
Model name, must be "flowmusic" (case-insensitive)
string
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.
string
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..."
string
Title of the generated music
string
BPM (beats per minute), must be ≥ 1Example: "120"
integer
Generation duration (seconds)Supported range: 1 ~ 240 seconds
string
Random seed, used to reproduce results
Passing the same seed value with the same request produces similar results, but exact reproducibility is not guaranteed.

Response

integer
Response status code, 200 on success
array
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}):