本文介紹音樂產生 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 將被忽略。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音樂時間長度(秒),用於計費。 |