鉴权
string
header
必填
千问AI平台 API Key。详见获取 API Key。
Header 参数
enum<string>
设置为 enable 可通过 HTTP 实现流式输出。
enable
音乐生成 Fun-Music 模型 API 参考
curl -X POST 'https://maas.qianwenaiapi.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
}
}千问AI平台 API Key。详见获取 API Key。
设置为 enable 可通过 HTTP 实现流式输出。
模型名称。可选值:fun-music-v1、fun-music-preview。
输入参数对象。
显示子属性
提示词内容,模型将根据提示词自动创作并生成音乐。
fun-music-v1:与 lyrics 二选一,至少传入其中之一。fun-music-preview:必选。字符限制:
当同时传入 prompt 和 lyrics 时,仅 lyrics 生效,prompt 将被忽略。
歌词内容。
fun-music-v1:与 prompt 二选一,至少传入其中之一。fun-music-preview:可选。字符限制:
当同时传入 lyrics 和 prompt 时,仅 lyrics 生效,prompt 将被忽略。
是否生成纯音乐。设为 true 时生成纯音乐(无人声演唱),设为 false 时生成歌曲。
当 is_instrumental 为 true 时,lyrics 和 gender 参数无效。
演唱声音的性别。仅 fun-music-v1 模型支持该参数。
音频编码格式。mp3 适合网络传输和存储,wav 适合后期处理和高质量播放。
AIGC 水印开关。开启后,会在生成的音频末尾追加表示"AI"的摩尔斯电码音频信号(·— ··),用于标识该音频为 AI 生成内容。开启水印会增加音频时长。
请求 ID,用于问题排查和日志追踪。
模型的输出。
显示子属性
模型输出的音频信息。
显示子属性
流式输出时的 Base64 音频数据片段。非流式输出时为空字符串。
完整音频文件的 OSS URL,有效期 24 小时。非流式模式下直接返回;流式模式下仅在最终消息中出现。
音频文件 ID。
音频 URL 过期时间戳(Unix timestamp)。
结束原因。生成过程中为 null;当生成自然结束时,值为 "stop"。
curl -X POST 'https://maas.qianwenaiapi.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
}
}