Music
submit_music 返回一个生成任务 jobId;请反复调用 track_progress,直到所有结果都保存到媒体池中。摆放、裁剪、循环、淡入淡出与闪避(ducking)仍属于时间线操作。
服务商与模式
Provider Modes Reference
mureka instrumental, song, prompt-song, soundtrack, track references/mureka.md
minimax t2m, cover references/minimax.md
选择指定的/已配置的供应商。普通背景音乐默认使用 Mureka 的 instrumental。需要其人声或参考控制时,使用 Mureka 的 song/prompt-song;需要由图像/视频驱动的配乐时使用 Mureka 的 soundtrack;需要从歌曲/音频源生成分轨/音轨时使用 track 模式。MiniMax 用于其文本生成音乐与翻唱模型。
通用工作流程
确认供应商、模式,以及是否需要多个付费变体。
阅读对应供应商的参考文档,只传该供应商的参数。
提交一次,然后调用 track_progress({ target:"generation", action:"wait", jobIds:[jobId] })。
当 count 生成多个结果时,使用返回的每一个素材;不要假设只存在旧的 result 字段。
只有在实际时长已知后,才在时间线上进行摆放/裁剪/闪避。
示例
// Mureka instrumental(默认 count 特意设为 1) submit_music({ provider: "mureka", mode: "instrumental", prompt: "Warm lo-fi piano bed under narration", count: 1 });
// Mureka lyrics song 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 prompt song 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" });
规则
仅在明确请求后才生成;count 2–3 可能成倍增加供应商费用,因此绝不要静默添加变体。
Mureka 的 stream:true 会启用供应商的流式任务阶段,但 OpenChatCut 仍会等待持久化的最终文件。
MiniMax 翻唱需要已配置的 music-cover* 模型,并且 referenceAssetId 或 coverFeatureId 必须恰好提供其中一个;coverFeatureId 还需要 lyrics。
切勿将 MiniMax 的音频设置字段混入 Mureka,也不要将 Mureka 的 ID/模式混入 MiniMax。
生成的音乐不保证精确的节拍/高潮落点时机;请在生成后再进行剪辑与对齐。