SuperAPI AI 工具集

music

设计与创作

查看项目

更新于 10-13 15:37

技能介绍

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。

生成的音乐不保证精确的节拍/高潮落点时机;请在生成后再进行剪辑与对齐。