Skip to main content
音樂產生

音樂產生Fun-Music API參考

本文介紹音樂產生 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 個中文漢字或英文單詞
當同時傳入 promptlyrics 時,僅 lyrics 生效,prompt 將被忽略。
lyricsstring(條件必選)歌詞內容。
  • fun-music-v1:與 prompt 二選一,至少傳入其中之一。
  • fun-music-preview:可選。
字元限制:
  • 非流式模式:中文 5~350 字元,英文 5~2000 字元
  • 流式模式:中文 300~350 字,英文 200~250 詞
當同時傳入 lyricsprompt 時,僅 lyrics 生效,prompt 將被忽略。
genderstring(可選) 預設值為 female演唱聲音的性別。僅 fun-music-v1 模型支援該參數。可選值:
  • male:男聲
  • female:女聲
formatstring(可選) 預設值為 mp3音頻編碼格式。可選值:
  • mp3:適合網路傳輸和儲存
  • wav:適合後期處理和高品質播放
enable_aigc_watermarkboolean(可選) 預設值為 falseAIGC 浮水印開關。開啟後,會在產生的音頻末尾追加表示“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"
    }
}'

返回對象

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