POST
/api/v1/services/audio/music/generation
复制
curl -X POST 'https://dashscope.aliyuncs.com/api/v1/services/audio/music/generation' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "fun-music-v1",
"input": {
"prompt": "夏日清新民谣，木吉他与口琴伴奏，轻快节奏，适合旅行Vlog背景音乐",
"gender": "female"
}
}'复制
{
"request_id": "46c51288-7ed6-95cc-a119-xxxxxxxxxxxx",
"output": {
"audio": {
"data": "",
"url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/pre/fun-music/20260330/xxxxxxxx/a8db24cc-d35f-961b-af81-a9e8d8b01f67.mp3?xxx",
"id": "audio_46c51288-7ed6-95cc-a119-xxxxxxxxxxxx",
"expires_at": 1774936147
},
"extra_info": {
"channels": 2,
"sample_rate": "48000",
"lyrics": "[verse]\n清晨的阳光穿过窗帘,\n咖啡的香气弥漫房间.\n翻开昨天未读完的书,\n时光就这样悄悄流转.\n\n[chorus]\n慢慢来不着急,\n生活本该如此惬意.\n把烦恼都丢进风里,\n拥抱每一个晴天雨季."
},
"finish_reason": "stop"
},
"usage": {
"duration": 200
}
}鉴权
string
header
必填
千问云 API Key。详见获取 API Key。
Header 参数
enum<string>
设置为 enable 可通过 HTTP 实现流式输出。
可选值：enable
请求体
application/jsonstring
必填
模型名称，固定为 fun-music-v1。
object
必填
输入参数对象。
显示子属性
显示子属性
string
歌词内容。与 prompt 二选一，至少传入其中之一。当同时传入 lyrics 和 prompt 时，仅 lyrics 生效，prompt 将被忽略。
字符限制：
- 非流式模式：中文 5~350 字符，英文 5~2000 字符
- 流式模式：中文 300~350 字，英文 200~250 词
string
提示词内容，模型将根据提示词自动创作歌词并生成歌曲。与 lyrics 二选一。
字符限制：
- 非流式模式：1~2000 字符
- 流式模式：5~1000 个中文汉字或英文单词
enum<string>
默认值"female"
演唱声音的性别。
可选值：male,female
enum<string>
默认值"mp3"
音频编码格式。mp3 适合网络传输和存储，wav 适合后期处理和高质量播放。
可选值：mp3,wav
boolean
默认值false
AIGC 水印开关。开启后，会在生成的音频末尾追加表示"AI"的摩尔斯电码音频信号（·— ··），用于标识该音频为 AI 生成内容。开启水印会增加音频时长。
响应
200-application/json
string
请求 ID，用于问题排查和日志追踪。
示例:46c51288-7ed6-95cc-a119-xxxxxxxxxxxx
object
模型的输出。
显示子属性
显示子属性
object
模型输出的音频信息。
显示子属性
显示子属性
string
流式输出时的 Base64 音频数据片段。非流式输出时为空字符串。
示例:
string
完整音频文件的 OSS URL，有效期 24 小时。非流式模式下直接返回；流式模式下仅在最终消息中出现。
示例:http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/pre/fun-music/20260330/xxxxxxxx/a8db24cc-d35f-961b-af81-a9e8d8b01f67.mp3?xxx
string
音频文件 ID。
示例:audio_46c51288-7ed6-95cc-a119-xxxxxxxxxxxx
integer
音频 URL 过期时间戳（Unix timestamp）。
示例:1774936147
object
enum<string>
结束原因。生成过程中为 null；当生成自然结束时，值为 "stop"。
可选值：stop,null
示例:stop
