Fun音樂大模型 API - Alibaba Cloud 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 流式輸出

請求體

modelstring（必選）

模型名稱。可選值：

fun-music-v1
fun-music-preview

inputobject（必選）

輸入參數對象。

屬性

promptstring（條件必選）

提示詞內容，模型將根據提示詞自動創作並產生音樂。

fun-music-v1：與 lyrics 二選一，至少傳入其中之一。
fun-music-preview：必選。

字元限制：

非流式模式：1~2000 字元
流式模式：5~1000 個中文漢字或英文單詞

說明當同時傳入 prompt 和 lyrics 時，僅 lyrics 生效，prompt 將被忽略。

lyricsstring（條件必選）

歌詞內容。

fun-music-v1：與 prompt 二選一，至少傳入其中之一。
fun-music-preview：可選。

字元限制：

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

說明當同時傳入 lyrics 和 prompt 時，僅 lyrics 生效，prompt 將被忽略。

genderstring（可選）預設值為 female

演唱聲音的性別。僅 fun-music-v1 模型支援該參數。可選值：

male：男聲
female：女聲

formatstring（可選）預設值為 mp3

音頻編碼格式。可選值：

mp3：適合網路傳輸和儲存
wav：適合後期處理和高品質播放

enable_aigc_watermarkboolean（可選）預設值為 false

AIGC 浮水印開關。開啟後，會在產生的音頻末尾追加表示“AI”的摩爾斯電碼音頻訊號（·— ··），用於標識該音頻為 AI 產生內容。開啟浮水印會增加音頻時間長度。

非流式輸出

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

返回對象

request_id string

請求 ID，用於問題排查和日誌追蹤。

outputobject

模型的輸出。

屬性

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

音樂時間長度（秒），用於計費。

非流式輸出

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