--- title: minimax-music3 canonical_url: "https://www.modelscope.cn/studios/MiniMax/minimax-music3" md_url: "https://www.modelscope.cn/studios/MiniMax/minimax-music3.md" repository: MiniMax/minimax-music3 chinese_name: "MiniMax Music 3 Studio" last_updated: 2026-08-19 sdk_type: gradio sdk_version: 6.17.3 downloads: 0 stars: 96 --- # minimax-music3 > minimax-music3 - MiniMax 在 ModelScope 创建的在线 Demo。MiniMax Music 3 文本与歌词生成完整歌曲，在创空间体验MiniMax Music3 。Modelscope xGPU适配版。 MiniMax/minimax-music3 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 gradio 6.17.3 构建，中文名为「MiniMax Music 3 Studio」。 - **Repository**: MiniMax/minimax-music3 - **SDK**: gradio - **SDK version**: 6.17.3 - **Downloads**: 0 - **Stars**: 96 - **Last updated**: 2026-08-19 Source: https://www.modelscope.cn/studios/MiniMax/minimax-music3 --- # MiniMax Music 3 Studio（ModelScope 迁移版） 从歌词与结构化音乐描述生成完整歌曲。界面、流式播放与示例来自上游 Hugging Face Space；本版本针对 ModelScope 创空间做了硬件与模型下载适配。 ## 部署配置 - SDK：Gradio 6.17.3（ModelScope 当前默认/最高可选版本） - 推荐硬件：`xgpu/8v-cpu-64g-mem-48g`（48 GB 显存、64 GB 内存） - 模型：`MiniMax/MiniMax-Music3` - 固定 revision：`652e7b018386b56e755551832f9efc6a0009d6e1` - 模型缓存：`/mnt/workspace/models` - 首次下载：约 28.5 GB（只下载 Diffusers 推理所需组件） - 输出音频/视频：临时目录，重启后不保证保留 16 GB xGPU 不适合当前 BF16 全量驻留实现。官方文档说明启用 CPU offload 后可在 24 GB 级显存运行；本迁移版当前采用全量 GPU 驻留，因此只部署到 48 GB 档，为 KV cache、长音频中间张量和加载峰值保留余量。 ## 可选 Secret - `MODELSCOPE_API_TOKEN`（推荐）：用于 ModelScope API-Inference 的提示词/歌词辅助生成；也是魔搭 Access Token。默认调用 `Qwen/Qwen3.5-35B-A3B`。 - `HF_TOKEN`：兼容上游 Hugging Face Router 的提示词/歌词辅助生成，仅在未配置可用魔搭接口时作为后备。 - 两者都不配置时不会再报错：Simple 模式使用内置模板继续生成，Studio 模式仍可手工编辑。 ## 可选变量 - `MODEL_ID`：默认 `MiniMax/MiniMax-Music3` - `MODEL_REVISION`：默认固定为上述 revision - `MODEL_PATH`：已有本地模型目录；设置后跳过下载 - `MODEL_CACHE_DIR`：默认 `/mnt/workspace/models` - `MIN_VRAM_GIB`：启动前显存下限检查，默认 `40` - `LM_COMPILE`：默认 `0`；目标硬件验证前不建议开启 - `WARM_BUCKETS`：仅 `LM_COMPILE=1` 时使用 - `MODELSCOPE_PROMPT_MODEL`：魔搭 API-Inference 模型 ID，默认 `Qwen/Qwen3.5-35B-A3B` - `PROMPT_ASSIST_BASE_URL`、`PROMPT_ASSIST_API_KEY`、`PROMPT_ASSIST_MODEL`：可选的其他 OpenAI 兼容提示词服务（三项需同时配置） ## 与上游的差异 - 移除了 Hugging Face ZeroGPU 的 `@spaces.GPU` 调度。 - 不加载为 RTX Pro 6000 编译的 Hugging Face AoTI 包，改用可跨 NVIDIA GPU 运行的 eager 路径。 - 从 ModelScope 官方模型仓库按需下载并持久化缓存，避免每次重启跨站重新拉取约 57 GB 的完整仓库。 - 强制 Diffusers 的每个模块从本地 ModelScope 快照加载，运行时不依赖 `huggingface.co` 可达性。 - 随仓库提供由上游提交 `82319140e0456fd58beff0a251c38825bfc310de` 构建的 Diffusers wheel，避免部署时依赖 GitHub 网络。 - 服务显式监听 `0.0.0.0`，端口读取 `PORT`（默认 7860）。 ## 许可与来源 - 上游 Space： - 模型： - 模型与相关推理代码遵循仓库中的 `MiniMax-Music3 COMMUNITY LICENSE`；对外提供生成服务时需要持续满足其中的安全保障、署名与可接受使用要求。 - 详细迁移记录见 `UPSTREAM.md`。 ## 克隆 ```bash git clone https://www.modelscope.cn/studios/icebergyang/minimax-music3.git ```