音乐接口(待开放)

创建普通模式和自定义模式的音乐任务。

音乐接口(待开放)

使用 POST /v1/music/generations 创建音乐任务。接口会返回任务 id,最终音频地址需要到 任务查询 里获取。

该接口文档仅供预览,暂未开放。

接口地址

POST /v1/music/generations

请求参数

字段类型是否必填说明
providerstring必填音乐服务,例如 kie
modelstring必填音乐模型,例如 V5
promptstring普通模式必填音乐想法、情绪、曲风、乐器或人声方向。
customModeboolean可选需要单独填写歌名、风格、歌词时设为 true
titlestring自定义模式必填歌名。
stylestring自定义模式必填音乐风格,例如 synthwavecinematic popacoustic folk
lyricsstring自定义模式非纯音乐必填歌词。
instrumentalboolean可选设为 true 表示生成纯音乐。
optionsobject可选所选音乐模型支持的额外参数。

积分

音乐每个任务消耗 10 积分。

示例:普通模式

curl https://sseedance.com/v1/music/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "kie",
    "model": "V5",
    "prompt": "温暖的电影感合成器流行音乐,带柔和鼓点",
    "instrumental": false
  }'

示例:自定义模式

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
  }'

示例:纯音乐自定义模式

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
  }'

返回结果

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

GET /v1/tasks/{id} 查询最终的 audioUrls

音乐接口(待开放)