scenario-minimax-music

Scenario MiniMax 音乐

概述

Scenario 上的 MiniMax 音乐系列分为两类：Music 3.0 根据风格提示词和歌词表创作并演唱完整歌曲；Music Cover 则在保留旋律的同时，将上传的歌曲改编成新风格。使用 search 查找两者，并将 model_schema_get 视为规范：这两个成员都支持 prompt、sampleRate 和 bitrate，除此之外没有共同点。

有关连接和核心流程，请参阅 scenario 技能；有关与模型无关的音频工作，请参阅 scenario-audio 技能。如果这里提到的某个同级技能不在你的可用技能中，请让用户安装它（npx skills add scenario-labs/skills --skill <name>）；如果无人值守，请根据工具架构继续操作，并指出这一缺失。

快速参考

两个成员共支持四种模式（名称来自实时架构）：

模式	成员	输入	行为
人声歌曲	Music 3.0	prompt + lyrics	演唱你的歌词；标签用于塑造编曲
自动写词	Music 3.0	prompt + lyrics 中的简要描述 + lyricsOptimizer: true	为你编写结构化歌词表
纯器乐	Music 3.0	prompt + isInstrumental: true	不含歌词；提示词就是完整的创作说明
翻唱	Cover	audioUrl + prompt	保留旋律，重新塑造其他所有部分

两个成员都必须提供 prompt（编写时长度为 10 到 2,000 个字符），其中只描述风格：流派、情绪、BPM 速度、调性、人声音色和乐器配置。歌词应放在 lyrics 中（最多 3,500 个字符），它也决定计费：编写时每分钟约按 700 个字符计费，时长为一到五分钟。任务需要运行数分钟，因此启动时请使用 wait=false。

编写歌词表

歌词表是一份编曲脚本，而非普通文本。结构标签应单独占一行，并用方括号括起来（[Intro]、[Verse]、[Pre Chorus]、[Chorus]、[Hook]、[Drop]、[Bridge]、[Inst]、[Outro]；架构中还列有更多标签）。换行用于分隔歌词行，段落之间留一个空行表示停顿；每段写两到四行，效果通常比密集的段落更好。圆括号中填写表演提示，而不是要唱出的歌词，例如 (whispered)、(belted)，或放在 [Inst] 或 [Solo] 段落中的简短指示。结尾使用 [Outro]，让曲目自然收尾，而不是戛然而止。编写时，英语和普通话的演唱效果最稳定。

使用 lyricsOptimizer: true 时，lyrics 字段的含义会改变：传入自然语言创作说明（例如“独立民谣风格的分手歌，夜晚独自漫步”），模型会自行编写结构化歌词表。关闭该选项时，模型会演唱字段中的所有内容，包括创作说明。

翻唱会保留旋律

Music Cover 通过 audioUrl 接收源音频：先使用 upload_asset 上传 MP3 或 WAV 文件（请参阅 scenario 技能），然后传入资源 ID。它会保留旋律线，并根据提示词重新生成其他部分（流派、人声特点、乐器、制作风格），因此适合转换流派，不适合改变旋律的混音。源音频的人声和旋律越清晰，效果越好；它没有歌词字段，因此提示词只会改变风格，不会改变歌词。编写时，它每次运行的费用固定，而 3.0 的费用会随歌词表长度变化，因此选择时请对两者都运行 dry_run。

示例：带人声的预告片歌曲

1. 使用 search，设置 target="models"、query="minimax music"、public=true。优先选择最新且未弃用的结果，例如 model_minimax-music-3-0（编写本文档时的实时结果；每次会话都要重新检索）；封面成员的能力列表中包含 audio2audio。
2. 使用该 ID 调用 model_schema_get：先查看字段、能力和默认值，再进行其他操作。
3. 使用该 model_id 调用 model_run，设置 dry_run=true，并传入以下准确的 parameters={"prompt": "epic orchestral trailer, 140 BPM, D minor, female vocals, taiko and strings", "lyrics": "[Intro]\n(Low strings)\n\n[Verse]\nWe were born below the thunder\n...\n\n[Outro]\n(Choir fades)"}。 修改歌词后重新估算：字符数变化会影响价格。
4. 再次调用 model_run 并设置 wait=false，然后使用返回的任务 ID 调用 jobs_wait；超时时，使用 pending_job_ids 再次调用，切勿第二次调用 model_run。
5. 使用 asset_display 查看输出，并在将其放到剪辑下方前先试听。

常见错误

• 把歌词写进 prompt，或把流派词汇写进 lyrics：模型会描述一首歌，或唱出你的风格说明。
• 在提示词中要求“无演唱”：结果不可靠；请设置 isInstrumental: true。
• 设置 lyricsOptimizer: true 并传入完成的歌词：歌词会被改写；此标志适用于简要说明。
• 用填充词伪造器乐段落：请使用 [Inst] 或 [Solo]，并附上括号提示。
• 将本地路径或外部 URL 作为 audioUrl 传入：请先上传，再传入资源 ID。
• 用没有清晰旋律的曲目进行翻唱：翻唱只会保留模型能听到的内容。