Music Generation (Coming soon)

Music generation (Coming soon)

Use POST /v1/music/generations to create a music task. The API returns a task id; use Task status to get the final audio URL.

This endpoint is documented for preview and is not open yet.

Endpoint

POST /v1/music/generations

Request body

Field	Type	Required	Description
`provider`	string	Yes	Music provider, for example `kie`.
`model`	string	Yes	Music model, for example `V5`.
`prompt`	string	Required in normal mode	Music idea, mood, genre, instruments, or vocal direction.
`customMode`	boolean	No	Set to `true` when you want to provide title, style, and lyrics separately.
`title`	string	Required in custom mode	Song title.
`style`	string	Required in custom mode	Music style, such as `synthwave`, `cinematic pop`, or `acoustic folk`.
`lyrics`	string	Required in custom mode unless instrumental	Lyrics for the song.
`instrumental`	boolean	No	Set to `true` for instrumental music.
`options`	object	No	Extra model options supported by the selected music model.

Credits

Music generation costs 10 credits per task.

Example: normal mode

curl https://sseedance.com/v1/music/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "kie",
    "model": "V5",
    "prompt": "Warm cinematic synth pop with soft drums",
    "instrumental": false
  }'

Example: custom mode

curl https://sseedance.com/v1/music/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "kie",
    "model": "V5",
    "customMode": true,
    "title": "Neon Rain",
    "style": "synthwave",
    "lyrics": "City lights and midnight rain",
    "instrumental": false
  }'

Example: instrumental custom mode

curl https://sseedance.com/v1/music/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "kie",
    "model": "V5",
    "customMode": true,
    "title": "Open Sky",
    "style": "cinematic ambient",
    "instrumental": true
  }'

Response

{
  "id": "task_id",
  "object": "music.generation.task",
  "status": "pending",
  "data": {
    "id": "task_id",
    "mediaType": "music",
    "status": "pending",
    "audioUrls": []
  }
}

Use GET /v1/tasks/{id} to check the final audioUrls.

Music Generation (Coming soon)

On this page