Fun音乐大模型 API-大模型服务平台百炼(Model Studio)-阿里云帮助中心

本文介绍音乐生成 Fun-Music 模型的 API 参数详情。

用户指南：关于模型介绍和选型建议请参见音乐生成。

重要

该模型目前处于邀测阶段，您需要前往模型广场申请开通后方可使用。该模型服务仅在华北2（北京）地域下可用。

前提条件

已获取 API Key。获取方式请参见获取 API Key。

服务端点

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/music/generation，调用时请将WorkspaceId替换为真实的Workspace ID。

通信协议：HTTPS。流式输出支持 SSE（Server-Sent Events）。

重要

百炼为华北2（北京）、新加坡地域推出了业务空间专属域名，能够为推理请求提供卓越的性能和更高的稳定性，建议迁移至新域名：

华北2（北京）地域：从 https://dashscope.aliyuncs.com 迁移至 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
新加坡地域：从 https://dashscope-intl.aliyuncs.com 迁移至 https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com

其中 {WorkspaceId} 为您的业务空间 ID，可在百炼控制台的业务空间详情页面查看。现有域名仍可正常使用。

请求头

参数名	类型	必填	说明
Authorization	string	是	`Bearer {api-key}`，请替换为您的 API Key
Content-Type	string	是	`application/json`
X-DashScope-SSE	string	否	设为 `enable` 启用 SSE 流式输出

请求体

非流式输出

curl -X POST 'https://{WorkspaceId}.cn-beijing.maas.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"
    }
}'

流式输出

curl -X POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/music/generation' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-H "X-DashScope-SSE: enable" \
-d '{
    "model": "fun-music-v1",
    "input": {
        "prompt": "节奏感强的电子舞曲，合成器音效，充满能量，适合健身运动场景",
        "gender": "male"
    }
}'

model string （必选）

模型名称。可选值：

fun-music-v1
fun-music-preview

input object （必选）

输入参数对象。

属性

prompt string （条件必选）

提示词内容，模型将根据提示词自动创作并生成音乐。

fun-music-v1：与 lyrics 二选一，至少传入其中之一。
fun-music-preview：必选。

字符限制：

非流式模式：1~2000 字符
流式模式：5~1000 个中文汉字或英文单词

说明

当同时传入 prompt 和 lyrics 时，仅 lyrics 生效，prompt 将被忽略。

lyrics string （条件必选）

歌词内容。

fun-music-v1：与 prompt 二选一，至少传入其中之一。
fun-music-preview：可选。

字符限制：

非流式模式：中文 5~350 字符，英文 5~2000 字符
流式模式：中文 300~350 字，英文 200~250 词

说明

当同时传入 lyrics 和 prompt 时，仅 lyrics 生效，prompt 将被忽略。

is_instrumental boolean （可选）默认值为 false

是否生成纯音乐。设为 true 时生成纯音乐（无人声演唱），设为 false 时生成歌曲。

说明

当 is_instrumental 为 true 时，lyrics 和 gender 参数无效。

gender string （可选）默认值为 female

演唱声音的性别。仅 fun-music-v1 模型支持该参数。可选值：

male：男声
female：女声

format string （可选）默认值为 mp3

音频编码格式。可选值：

mp3：适合网络传输和存储
wav：适合后期处理和高质量播放

enable_aigc_watermark boolean （可选）默认值为 false

AIGC 水印开关。开启后，会在生成的音频末尾追加表示“AI”的摩尔斯电码音频信号（·— ··），用于标识该音频为 AI 生成内容。开启水印会增加音频时长。

返回对象

非流式输出

{
    "output": {
        "audio": {
            "data": "",
            "expires_at": 1774936147,
            "id": "audio_46c51288-7ed6-95cc-a119-xxxxxxxxxxxx",
            "url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/pre/fun-music/20260330/xxxxxxxx/a8db24cc-d35f-961b-af81-a9e8d8b01f67.mp3?xxx"
        },
        "extra_info": {
            "channels": 2,
            "lyrics": "[verse]\n清晨的阳光穿过窗帘,\n咖啡的香气弥漫房间.\n翻开昨天未读完的书,\n时光就这样悄悄流转.\n\n[chorus]\n慢慢来不着急,\n生活本该如此惬意.\n把烦恼都丢进风里,\n拥抱每一个晴天雨季.",
            "sample_rate": 48000
        },
        "finish_reason": "stop"
    },
    "usage": {
        "duration": 200
    },
    "request_id": "46c51288-7ed6-95cc-a119-xxxxxxxxxxxx"
}

流式输出（中间消息）

{
    "output": {
        "audio": {
            "data": "base64 音频数据",
            "expires_at": 1774937185,
            "id": "audio_a8db24cc-d35f-961b-af81-xxxxxxxxxxxx"
        },
        "finish_reason": "null"
    },
    "request_id": "a8db24cc-d35f-961b-af81-xxxxxxxxxxxx"
}

流式输出（最终消息）

{
    "output": {
        "audio": {
            "expires_at": 1774937185,
            "id": "audio_a8db24cc-d35f-961b-af81-xxxxxxxxxxxx",
            "data": "",
            "url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/pre/fun-music/20260330/xxxxxxxx/a8db24cc-d35f-961b-af81-a9e8d8b01f67.mp3?xxx"
        },
        "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
    },
    "request_id": "a8db24cc-d35f-961b-af81-xxxxxxxxxxxx"
}

request_id string

请求 ID，用于问题排查和日志追踪。

output object

模型的输出。

属性

audio object

模型输出的音频信息。

属性

data string

流式输出时的 Base64 音频数据片段。非流式输出时为空字符串。

url string

完整音频文件的 OSS URL，有效期 24 小时。非流式模式下直接返回；流式模式下仅在最终消息中出现。

id string

音频文件 ID。

expires_at integer

音频 URL 过期时间戳（Unix timestamp）。

extra_info object

额外信息。包含以下字段：

属性

channels integer

音频声道数（如：2 表示立体声）。

sample_rate string

音频采样率（如："48000"）。

lyrics string

歌词内容。

finish_reason string

结束原因：

null：正在生成中
stop：生成自然结束

usage object

本次请求的计费信息。

属性

duration integer

音乐时长（秒），用于计费。