音乐接口(待开放)
创建普通模式和自定义模式的音乐任务。
音乐接口(待开放)
使用 POST /v1/music/generations 创建音乐任务。接口会返回任务 id,最终音频地址需要到 任务查询 里获取。
该接口文档仅供预览,暂未开放。
接口地址
POST /v1/music/generations请求参数
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
provider | string | 必填 | 音乐服务,例如 kie。 |
model | string | 必填 | 音乐模型,例如 V5。 |
prompt | string | 普通模式必填 | 音乐想法、情绪、曲风、乐器或人声方向。 |
customMode | boolean | 可选 | 需要单独填写歌名、风格、歌词时设为 true。 |
title | string | 自定义模式必填 | 歌名。 |
style | string | 自定义模式必填 | 音乐风格,例如 synthwave、cinematic pop、acoustic folk。 |
lyrics | string | 自定义模式非纯音乐必填 | 歌词。 |
instrumental | boolean | 可选 | 设为 true 表示生成纯音乐。 |
options | object | 可选 | 所选音乐模型支持的额外参数。 |
积分
音乐每个任务消耗 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。