跳转到主要内容
千问云 home page
开放平台文档
音频与语音

音乐生成

使用百聆音乐生成大模型（Fun-Music）根据提示词或歌词生成完整歌曲

百聆音乐生成大模型（Fun 音乐大模型）支持输入开放性歌曲的创作要求或歌词，生成整首男/女声演唱的中文或英文歌曲。歌曲通俗易懂，情绪由浅入深，是人类灵感与大模型能力的完美结合。

核心功能

  • 根据提示词（prompt）自动创作歌词并生成完整歌曲
  • 根据自定义歌词（lyrics）生成歌曲
  • 支持男声（male）和女声（female）演唱
  • 支持中文和英文歌词与提示词
  • 支持流式和非流式两种输出模式
  • 支持 MP3 和 WAV 音频格式输出

支持的模型

音乐生成模型： fun-music-v1 支持的语言：
  • 歌词语言：中文、英文
  • 提示词语言：中文、英文

快速开始

前提条件
  • 已获取 API Key。获取方式请参见获取 API Key。
  • 已将 API Key 配置到环境变量（推荐）：
export DASHSCOPE_API_KEY="sk-xxx"
lyrics 和 prompt 参数必须至少提供一个，不可同时为空。当同时传入两个参数时，仅 lyrics 生效，prompt 将被忽略。
  • 通过提示词生成音乐
  • 通过歌词生成音乐
传入 prompt 参数描述音乐风格和场景，模型将自动创作歌词并生成歌曲。
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"
    }
}'

流式调用

流式模式支持边生成边返回音频数据，适用于实时播放等场景。启用流式输出需要在请求头中添加 X-DashScope-SSE: enable。
流式模式与非流式模式的输入参数字符数限制不同，请注意区分：
  • 非流式模式：lyrics 支持中文 5350 字符、英文 52000 字符，prompt 支持 1~2000 字符。
  • 流式模式：lyrics 支持中文 300350 字、英文 200250 词，prompt 支持 5~1000 个中文汉字或英文单词。
curl -X POST 'https://dashscope.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"
    }
}'

歌词创作规范

Fun-Music 内置专业歌词创作模型。当您选择自行提供歌词时，遵循以下规范可生成更高质量的音乐。

结构标签

标准歌词结构应包含以下标签：
标签说明
[intro]前奏，引入氛围
[verse]主歌，叙述故事
[chorus]副歌，情感高潮
[bridge]桥段，视角转换
[outro]尾奏，渐弱收尾
歌词示例 
[intro]
琴键轻落，晚风微凉.
那年夏天，心跳悄悄发烫.

[verse]
教室窗边，阳光斜照你侧脸.
借半块橡皮，指尖碰出电流线.
放学路上，单车铃声追云烟.
你说未来很远，我却想走到终点.

[chorus]
青春是未拆的信笺，写满勇敢的誓言.
哪怕世界忽明又忽暗，有你就看见光点.
恋爱像初夏的雨甜，淋湿梦也不怕远.
我们笑着奔向明天，手牵手不回头望.

[bridge]
后来风雨打散纸伞，沉默代替了答案.
可心底那首歌未完，还等一句"别走散".

[chorus]
青春是未拆的信笺，写满勇敢的誓言.
哪怕世界忽明又忽暗，有你就看见光点.
恋爱像初夏的雨甜，淋湿梦也不怕远.
我们笑着奔向明天，手牵手不回头望.

[outro]
琴声渐远，星光铺满长街.
故事未完，下一页仍热烈.

创作要求

  • 原创性原则：严禁抄袭已发表歌曲的歌词，不得模仿知名歌曲的押韵模式或标志性句式。
  • 内容安全：禁止涉及政治、暴力、色情、低俗、恐怖、毒品等违法内容，保持内容健康、情感真挚。
  • 语言要求：仅支持中文或英文，不支持日文、韩文等其他语言。

最佳实践

提示词撰写

具体描述情绪、场景、乐器偏好，能生成更贴合需求的音乐。
  • 推荐：悲伤钢琴曲，雨夜思念
  • 不推荐：悲伤音乐（过于笼统）
不同风格的提示词示例
风格提示词示例
民谣温暖治愈的民谣歌曲，木吉他伴奏，讲述午后咖啡馆里的慵懒时光
古风古风歌曲，古筝与竹笛伴奏，水墨山水般的悠远意境，诉说江湖离别
摇滚热血摇滚，电吉他失真音墙，密集鼓点，唱出青春的叛逆与自由
抒情抒情慢歌，钢琴伴奏，安静深沉，带有淡淡忧伤，适合表达思念与回忆
说唱节拍鲜明的嘻哈说唱，808低音鼓，充满街头活力，讲述城市生活故事
儿歌欢快可爱的儿童歌曲，木琴与手鼓伴奏，节奏简单明快，教小朋友认识大自然

音频格式选择

  • mp3：适合网络传输和存储，为默认格式。
  • wav：适合后期处理和高质量播放。

API 参考

音乐生成 API 参考

常见问题

lyrics 参数用于传入您自己编写的歌词，模型将严格根据歌词内容进行谱曲和演唱。prompt 参数用于传入对音乐风格、场景的自然语言描述，模型将自动创作歌词并生成对应的音乐。两个参数至少传入一个。如果同时传入，仅 lyrics 生效。
如果只需获取最终的完整音频文件，推荐使用非流式模式，接口调用更简单。如果需要在音乐生成过程中逐步获取音频数据（如边生成边播放），建议使用流式模式。
音频文件下载 URL 的有效期为 24 小时，请在此时间内完成下载。超过有效期后 URL 将失效，需要重新调用接口生成。
两种模式下 lyrics 和 prompt 的字符数限制存在差异。非流式模式下，lyrics 支持中文 5350 字符、英文 52000 字符，prompt 支持 12000 字符。流式模式下，lyrics 支持中文 300350 字、英文 200250 词，prompt 支持 51000 个中文汉字或英文单词。请根据所选模式注意对应的参数限制。