音乐
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 歌曲/prompt-song 模式;当需要图像/视频驱动的配乐时使用 Mureka soundtrack 模式,从歌曲/音频源生成分轨时使用 track 模式。使用 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: "Warm lo-fi piano bed under narration", count: 1 });
// Mureka 带歌词歌曲
submit_music({
provider: "mureka", mode: "song", prompt: "Bright modern pop", gender: "female", count: 2,
lyrics: "[Verse]\nCity lights open the night\n[Chorus]\nWe build the future in real time",
});
// Mureka 提示词歌曲
submit_music({ provider: "mureka", mode: "prompt-song", prompt: "A hopeful road-trip anthem", styles: ["pop", "folk"] });
// 为项目视频或图像配乐
submit_music({ provider: "mureka", mode: "soundtrack", sourceAssetId: "videoAssetId", prompt: "Tense restrained documentary score" });
// 从 Mureka 歌曲 ID 生成分轨
submit_music({ provider: "mureka", mode: "track", songId: "song-id", trackType: "Drums", prompt: "Tight punchy acoustic drums" });
// MiniMax 器乐/人声
submit_music({ provider: "minimax", mode: "t2m", prompt: "Upbeat electronic tech intro", isInstrumental: true });
submit_music({ provider: "minimax", mode: "t2m", prompt: "Rainy night pop", lyricsOptimizer: true });
// MiniMax 从项目音频素材翻唱
submit_music({ provider: "minimax", mode: "cover", prompt: "Warm acoustic coffee-shop cover", referenceAssetId: "audioAssetId" });
// Atlas Cloud 文本转音乐
submit_music({ provider: "atlas", mode: "t2m", prompt: "Cinematic ambient score with restrained piano", isInstrumental: true });
// Sonilo 从渲染成片视频转音乐(提示词可选)
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId" });
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId", prompt: "Warm indie folk, no drums" });
规则
- 仅在显式请求后生成;
count为 2–3 可能会成倍增加提供商费用,因此切勿静默添加变体。 - Mureka
stream:true启用提供商的流式任务阶段,但 OpenChatCut 仍会等待持久的最终文件。 - MiniMax 翻唱需要配置
music-cover*模型,且必须恰好包含referenceAssetId或coverFeatureId其中之一;coverFeatureId还需要歌词。 - Atlas Cloud 仅支持
t2m模式,不接受 MiniMax 的翻唱/优化器或 Mureka 特有的控制参数。 - 切勿将 MiniMax 的音频设置字段混入 Mureka 的请求,也不要将 Mureka 的 ID/模式混入 MiniMax 的请求。
- 生成的音乐不保证精确的节拍/落点时机;请在生成后自行裁剪并对齐。