音樂
submit_music 會回傳一個生成任務 jobId；請持續呼叫 track_progress 直到每個結果都存入媒體池。時間線上的放置、裁切、循環、淡入淡出與音量避讓仍是後製操作。
供應商與模式
| 供應商 | 模式 | 參考文件 |
|---|---|---|
mureka | instrumental、song、prompt-song、soundtrack、track | references/mureka.md |
minimax | t2m、cover | references/minimax.md |
atlas | t2m | references/atlas.md |
sonilo | v2m | references/sonilo.md |
選擇已命名/已設定的供應商。一般背景音樂預設為 Mureka 器樂模式。需要人聲或參考控制時使用 Mureka 歌曲/提示歌曲模式；需要根據圖片/影片生成配樂時使用 Mureka 配樂模式，需要從歌曲/音訊來源生成單軌時使用音軌模式。使用 MiniMax 的文字轉音樂與翻唱模型。使用 Atlas Cloud 透過其非同步音訊 API 進行基於結構的文字轉音樂。當音樂應從已完成剪輯本身（專案影片素材）而非文字描述生成時，使用 Sonilo v2m 模式。
共同工作流程
- 確認供應商、模式，以及是否需要多個付費變體。
- 閱讀該供應商的參考文件，僅傳入該供應商的參數。
- 提交一次，然後呼叫
track_progress({ target:"generation", action:"wait", jobIds:[jobId] })。 - 當
count產生多個結果時，使用所有回傳的素材；不要假設只有舊有的result欄位存在。 - 只有在實際時長已知後，才能在時間線上進行放置/裁切/音量避讓。
範例
// Mureka 器樂（預設 count 刻意為 1）
submit_music({ provider: "mureka", mode: "instrumental", prompt: "旁白背景下的溫暖鬆弛氛圍鋼琴", count: 1 });
// Mureka 歌詞歌曲
submit_music({
provider: "mureka", mode: "song", prompt: "明亮的現代流行", gender: "female", count: 2,
lyrics: "[Verse]\n城市的燈火點亮夜晚\n[Chorus]\n我們即時打造未來",
});
// Mureka 提示歌曲
submit_music({ provider: "mureka", mode: "prompt-song", prompt: "充滿希望的公路旅行頌歌", styles: ["pop", "folk"] });
// 為專案影片或圖片配樂
submit_music({ provider: "mureka", mode: "soundtrack", sourceAssetId: "videoAssetId", prompt: "緊湊克制的紀錄片配樂" });
// 從 Mureka 歌曲 ID 生成單軌
submit_music({ provider: "mureka", mode: "track", songId: "song-id", trackType: "Drums", prompt: "緊湊有力的原聲鼓" });
// MiniMax 器樂 / 人聲
submit_music({ provider: "minimax", mode: "t2m", prompt: "歡快的電子科技開場", isInstrumental: true });
submit_music({ provider: "minimax", mode: "t2m", prompt: "雨夜流行", lyricsOptimizer: true });
// MiniMax 從專案音訊素材翻唱
submit_music({ provider: "minimax", mode: "cover", prompt: "溫暖的原聲咖啡廳翻唱", referenceAssetId: "audioAssetId" });
// Atlas Cloud 文字轉音樂
submit_music({ provider: "atlas", mode: "t2m", prompt: "結合克制鋼琴的電影感環境配樂", isInstrumental: true });
// Sonilo 從已渲染剪輯影片生成音樂（提示可選）
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId" });
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId", prompt: "溫暖獨立民謠，無鼓" });
規則
- 僅在收到明確要求後才生成；
count設為 2–3 會倍增供應商費用，所以絕不能偷偷增加變體。 - Mureka
stream:true會啟用供應商的串流任務階段，但 OpenChatCut 仍會等待最終持久化檔案。 - MiniMax 翻唱需要設定
music-cover*模型，且必須恰好指定referenceAssetId或coverFeatureId其中之一；coverFeatureId還需要歌詞。 - Atlas Cloud 僅支援
t2m，不接受 MiniMax 的翻唱/最佳化器或 Mureka 專屬控制項。 - 絕不能將 MiniMax 的音訊設定欄位混入 Mureka，也不能將 Mureka 的 ID/模式混入 MiniMax。
- 生成的音樂不保證精確的節拍/重拍時機；請在生成後自行裁切與對齊。