音樂產生

​

概述

• 通過提示詞（prompt）描述音樂風格、情境、情緒和樂器偏好，模型自動創作歌詞並產生歌曲
• 通過歌詞（lyrics）提供自訂歌詞內容，模型據此譜曲並演唱
• 通過聲音性別（gender）選擇男聲或女聲（僅 fun-music-v1 模型）
• 支援流式和非流式兩種輸出模式
• 支援 MP3 和 WAV 兩種音頻格式輸出

​

兩個模型的區別

​

音訊輸出格式

​

前提條件

• 已擷取 API Key。擷取方式請參見擷取 API Key。
• 已將 API Key 配置到環境變數（推薦）：

export DASHSCOPE_API_KEY="sk-xxx"

​

快速開始

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" \
-d '{
    "model": "fun-music-v1",
    "input": {
        "lyrics": "[verse]\n清晨的陽光穿過窗帘,\n咖啡的香氣瀰漫房間.\n翻開昨天未讀完的書,\n時光就這樣悄悄流轉.\n\n[chorus]\n慢慢來不著急,\n生活本該如此愜意.\n把煩惱都丟進風裡,\n擁抱每一個晴天雨季.",
        "gender": "female"
    }
}'

​

創作指南

​

提示詞（prompt）

• 推薦：悲傷鋼琴曲，雨夜思念
• 不推薦：悲傷音樂（過於籠統）

​

歌詞（lyrics）

[intro]
琴鍵輕落，晚風微涼.
那年夏天，心跳悄悄發燙.

[verse]
教室窗邊，陽光斜照你側臉.
借半塊橡皮，指尖碰出電流線.
放學路上，單車鈴聲追雲煙.
你說未來很遠，我卻想走到終點.

[chorus]
青春是未拆的信箋，寫滿勇敢的誓言.
哪怕世界忽明又忽暗，有你就看見光點.
戀愛像初夏的雨甜，淋濕夢也不怕遠.
我們笑著奔向明天，手牽手不回頭望.

[bridge]
後來風雨打散紙傘，沉默代替了答案.
可心底那首歌未完，還等一句"別走散".

[chorus]
青春是未拆的信箋，寫滿勇敢的誓言.
哪怕世界忽明又忽暗，有你就看見光點.
戀愛像初夏的雨甜，淋濕夢也不怕遠.
我們笑著奔向明天，手牽手不回頭望.

[outro]
琴聲漸遠，星光鋪滿長街.
故事未完，下一頁仍熱烈.

• 原創性原則：嚴禁抄襲已發表歌曲的歌詞，不得模仿知名歌曲的押韻模式或標誌性句式。
• Alibaba Content Security Service：禁止涉及政治、暴力、色情、低俗、恐怖、毒品等違法內容，保持內容健康、情感真摯。
• 語言要求：僅支援中文或英文，不支援日文、韓文等其他語言。

​

聲音性別（gender）

• female：女聲（預設）
• male：男聲

​

進階功能

​

流式輸出

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"
    }
}'

​

支援的模型與地區

​

API參考

​

常見問題

​

能否指定樂器、節奏或情感？

​

兩個模型怎麼選？

​

產生的音頻 URL 有效期間是多久？

​

lyrics 和 prompt 有什麼區別？

​

流式和非流式模式如何選擇？

​

流式和非流式模式的參數限制有何不同？