本文介绍音乐生成 Fun-Music 模型的 API 参数详情。
用户指南：关于模型介绍和选型建议请参见音乐生成。
已获取 API Key。获取方式请参见获取 API Key。
POST
前提条件
已获取 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）。
请求头
参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 |
|
Content-Type | string | 是 |
|
X-DashScope-SSE | string | 否 | 设为 |
请求体modelstring（必选）模型名称。可选值：
object（必选）输入参数对象。
属性 prompt string（条件必选）提示词内容，模型将根据提示词自动创作并生成音乐。
当同时传入 prompt 和 lyrics 时，仅 lyrics 生效，prompt 将被忽略。string（条件必选）歌词内容。
当同时传入 lyrics 和 prompt 时，仅 lyrics 生效，prompt 将被忽略。boolean（可选） 默认值为 false是否生成纯音乐。设为 true 时生成纯音乐（无人声演唱），设为 false 时生成歌曲。当 is_instrumental 为 true 时，lyrics 和 gender 参数无效。string（可选） 默认值为 female演唱声音的性别。仅 fun-music-v1 模型支持该参数。可选值：
string（可选） 默认值为 mp3音频编码格式。可选值：
boolean（可选） 默认值为 falseAIGC 水印开关。开启后，会在生成的音频末尾追加表示“AI”的摩尔斯电码音频信号（·— ··），用于标识该音频为 AI 生成内容。开启水印会增加音频时长。 |
返回对象request_idstring请求 ID，用于问题排查和日志追踪。outputobject模型的输出。
属性 audio object模型输出的音频信息。
属性 data string流式输出时的 Base64 音频数据片段。非流式输出时为空字符串。url string完整音频文件的 OSS URL，有效期 24 小时。非流式模式下直接返回；流式模式下仅在最终消息中出现。id string音频文件 ID。expires_at integer音频 URL 过期时间戳（Unix timestamp）。object额外信息。包含以下字段：
属性 channels integer音频声道数（如：2 表示立体声）。sample_rate string音频采样率（如："48000"）。lyrics string歌词内容。string结束原因：
object本次请求的计费信息。
属性 duration integer音乐时长（秒），用于计费。 |