MiniMax CLI (mmx) 多模态调用工具，触发于需生成图片/视频/音乐/语音或使用 mmx 命令时。功能：生成媒体、调用 MiniMax API、查询用量额度、配置或诊断 mmx。
MiniMax CLI (mmx)
功能概述
MiniMax CLI (mmx)是一项面向实际任务的技能，主要用于MiniMax CLI 是 MiniMax Token Plan 的命令行工具，通过 mmx 命令提供文本、图片、视频、语音、音乐、视觉理解、网络检索等能力；Agent 安装方式：将以下提示词复制给 AI Agent；
核心要点
- 全局常用选项；
- quiet 静默模式，减少非必要输出；
- output json|text 输出格式；
使用与执行
timeout <seconds> 请求。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
MiniMax CLI (mmx)
MiniMax CLI 是 MiniMax Token Plan 的命令行工具，通过 mmx 命令提供文本、图片、视频、语音、音乐、视觉理解、网络检索等能力。
安装
npm install -g mmx-cli mmx auth login --api-key
Agent 安装方式：将以下提示词复制给 AI Agent
帮我安装 MiniMax CLI：https://github.com/MiniMax-AI/cli 我的密钥是
全局常用选项
--quiet静默模式，减少非必要输出--output json|text输出格式--timeout请求超时--dry-run预览命令而不执行
图片理解
mmx vision describe --image[--prompt ]
| 参数 | 说明 |
|---|---|
--image |
图片路径或 URL（本地路径自动 base64 编码） |
--file-id |
预上传的文件 ID（跳过 base64 转换） |
--prompt |
关于图片的问题（默认：描述图片） |
# 基础描述 mmx vision describe --image photo.jpg # URL 图片 mmx vision describe --image https://example.com/photo.jpg # 定制问题 mmx vision describe --image photo.jpg --prompt "这张图里有什么？" # 提取文字 mmx vision describe --image doc.png --prompt "提取图片中的文字" # 预上传文件（避免大文件 base64 开销） mmx vision describe --file-id file-123456789 --prompt "这是什么？"
图片生成
mmx image generate --prompt[flags]
| 参数 | 说明 |
|---|---|
--prompt |
图片描述（必填） |
--aspect-ratio |
宽高比，如 16:9、1:1 |
--n |
生成数量（默认1） |
--width |
宽度（512-2048，必须是8的倍数） |
--height |
高度（512-2048，必须是8的倍数） |
--seed |
随机种子（可复现） |
--out |
精确保存路径（单图） |
--out-dir |
保存目录 |
--out-prefix |
文件名前缀 |
--response-format url|base64 |
返回格式（默认url） |
--prompt-optimizer |
自动优化提示词 |
--aigc-watermark |
添加AI生成水印 |
--subject-ref |
角色一致性参考 |
# 基础 mmx image generate --prompt "赛博朋克城市夜景" --aspect-ratio 16:9 # 批量生成到目录 mmx image generate --prompt "极简风格logo" --n 4 --out-dir ./logos/ # 精确尺寸 mmx image generate --prompt "宽屏风景" --width 1920 --height 1080 # 可复现 mmx image generate --prompt "城堡" --seed 42 # 保存路径 mmx image generate --prompt "山水画" --out ~/Pictures/landscape.jpg
视频生成
mmx video generate --prompt[flags]
| 模型 | 说明 | 触发方式 |
|---|---|---|
| Hailuo-2.3 (T2V) | 文本生视频（默认） | 直接使用 --prompt |
| Hailuo-2.3 (I2V) | 图生视频 | --first-frame |
| Hailuo-2.3-Fast | 快速图生视频 | --first-frame + fast |
| Hailuo-02 (SEF) | 首尾帧插值 | --first-frame + --last-frame |
| S2V-01 | 角色一致性 | --subject-image |
| 参数 | 说明 |
|---|---|
--prompt |
视频描述（必填） |
--model |
指定模型 |
--first-frame |
首帧图片 |
--last-frame |
尾帧图片（需配合 --first-frame） |
--subject-image |
角色参考图 |
--download |
保存路径（同步等待时） |
--no-wait / --async |
异步模式，立即返回任务ID |
--poll-interval |
轮询间隔（默认5秒） |
--callback-url |
完成通知Webhook |
# 同步等待 mmx video generate --prompt "夕阳下，一只猫坐在窗边望向远方" --download sunset.mp4 # 异步，立即返回任务ID mmx video generate --prompt "机器人画画" --async --quiet # 图生视频 mmx video generate --prompt "一个女人在走路" --first-frame woman.jpg # 首尾帧插值 mmx video generate --prompt "向前走" --first-frame start.jpg --last-frame end.jpg # 角色一致性 mmx video generate --prompt "侦探行走" --subject-image character.jpg # 查询任务状态 mmx video task get# 下载已完成视频 mmx video download --out output.mp4
音乐生成
mmx music generate --prompt[flags]
| 模型 | 说明 |
|---|---|
| music-2.6 | 推荐 |
| music-2.6-free | 免费版（无限量） |
| music-2.5+ | 增强版 |
| music-2.5 | 标准版 |
| 参数 | 说明 |
|---|---|
--prompt |
音乐风格描述（最多2000字符） |
--lyrics |
歌词（带结构标签） |
--lyrics-file |
从文件读取歌词 |
--lyrics-optimizer |
从 prompt 自动生成歌词 |
--instrumental |
纯音乐模式 |
--vocals |
人声风格 |
--genre |
音乐流派 |
--mood |
情绪 |
--instruments |
乐器 |
--tempo |
节奏描述 |
--bpm |
精确 BPM |
--key |
调性 |
--structure |
歌曲结构 |
--out |
保存路径（必填） |
--format |
音频格式（默认mp3） |
--model |
模型选择 |
--output-format hex|url |
返回格式（默认hex） |
歌词结构标签：[Intro] [Verse] [Pre Chorus] [Chorus] [Interlude] [Bridge] [Outro] [Post Chorus] [Transition] [Break] [Hook] [Build Up] [Inst] [Solo]
# 带歌词 mmx music generate --prompt "轻快爵士风格" --lyrics "La la la..." --out summer.mp3 # 自动生成歌词 mmx music generate --prompt "关于夏天的流行歌曲" --lyrics-optimizer --out summer_pop.mp3 # 纯音乐 mmx music generate --prompt "电影配乐，管弦乐" --instrumental --out bgm.mp3 # 详细参数 mmx music generate --prompt "温暖的早晨民谣" --vocals "男声女声二重唱，和声" --instruments "原声吉他，钢琴，弦乐" --bpm 95 --out duet.mp3
语音合成
mmx speech synthesize --text[--out ] [flags]
| 模型 | 说明 |
|---|---|
| speech-2.8-hd | 高清（默认） |
| speech-2.6 | 标准版 |
| speech-02 | 轻量版 |
| 参数 | 说明 | 默认值 |
|---|---|---|
--text |
文本（最多10k字符） | 必填 |
--text-file |
从文件读取 | - |
--voice |
音色ID | English_expressive_narrator |
--out |
保存路径 | - |
--model |
模型 | speech-2.8-hd |
--speed |
语速倍数 | 1.0 |
--pitch |
音调调整 | - |
--volume |
音量 | - |
--format |
音频格式 | mp3 |
--sample-rate |
采样率 | 32000 |
--bitrate |
比特率 | 128000 |
--language |
语言增强 | - |
--subtitles |
包含字幕时间轴 | - |
--pronunciation |
自定义发音 | - |
查看音色列表：mmx speech voices
# 基础合成 mmx speech synthesize --text "欢迎使用 MiniMax Token Plan" --out welcome.mp3 # 指定音色 mmx speech synthesize --text "你好" --voice "温暖女声" --out hello.mp3 # 调整语速 mmx speech synthesize --text "快速播报新闻" --speed 1.5 --out news_fast.mp3 # 从文件读取 echo "Breaking news." | mmx speech synthesize --text-file - --out news.mp3 # 带字幕 mmx speech synthesize --text "Hello world" --subtitles --out with_subs.mp3 # 流式输出 mmx speech synthesize --text "Stream test" --stream | mpv --no-terminal -
文本对话
mmx text chat --message[flags]
| 参数 | 说明 |
|---|---|
--message |
消息内容 |
--model |
模型选择 |
--stream |
流式输出 |
# 简单对话 mmx text chat --message "帮我生成一首关于AI的4言诗" # 流式输出 mmx text chat --message "解释量子计算" --stream
网络搜索
mmx search query
mmx search query "MiniMax 最新动态"
其他命令
| 命令 | 说明 |
|---|---|
mmx auth status |
认证状态 |
mmx auth refresh |
刷新 Token |
mmx quota show |
用量配额 |
mmx config show |
查看配置 |
mmx config set |
设置配置 |
mmx update |
检查更新 |
mmx |
打开交互面板 |
默认输出路径
不指定时，生成的文件默认保存到当前目录的 minimax-output/ 文件夹。
热门AI工具
相关专题
针对个人用户与中小团队最关心的成本问题，全面梳理 Minimax 平台的免费使用方案与省钱技巧，涵盖海螺 AI 网页端/App 端的免费功能范围与每日使用限额、API 开放平台新用户免费额度领取与使用期限、各模型（文本/语音/视频）的 Token 计费规则与价格明细、免费版与付费会员功能权益的详细对比、通过 Prompt 优化减少 Token 消耗的实用技巧、合理选择模型版本降低调用成本的策略，帮助用户以最低成本充分利用 Minimax
614
2026.05.18
讲解 Minimax 在 AI 音乐生成领域的能力与创作方法，涵盖文本描述生成音乐（Text-to-Music）的提示词编写（风格/情绪/节奏/乐器描述）、歌词创作辅助与旋律适配、音乐风格（流行/古风/电子/爵士/古典/说唱）的精准控制、AI 歌声合成与人声效果调节、生成片段的拼接编排与时长控制、AI 音乐在短视频 BGM、播客片头、游戏配乐、广告音乐等场景的商用实践，帮助音乐爱好者与内容创作者零门槛实现 AI 原创音乐。
448
2026.05.18
本专题围绕Minimax海螺 AI 最受用户欢迎的角色扮演功能，讲解虚拟角色的创建与人设定制（性格/背景/说话风格/记忆设定）、沉浸式多轮对话的引导技巧、角色语音绑定与实时语音对话体验、热门角色类型（AI 伴侣/历史人物/影视角色/游戏NPC/虚拟导师）的设定模板与玩法分享、社区热门角色排行与二创互动、角色对话的隐私安全与使用边界，帮助用户深度体验 AI 角色互动的乐趣并激发创意玩法灵感。
319
2026.05.18
系统讲解 Minimax 开放平台 API 的开发与集成方法，涵盖 API Key 申请与鉴权机制、Chat Completion 文本对话接口的参数配置（temperature/top_p/tokens_to_generate）与多轮对话管理、流式输出（SSE Streaming）实现、Text-to-Speech（T2A）语音合成接口与音色选择、视频生成（Video Generation）接口调用与任务状态查询、Embeddings
357
2026.05.13
面向 AI 工具新手，从 Minimax 的账号注册、海螺 AI（Hailuo AI）网页端与移动端使用讲起，介绍 Minimax 大模型家族（abab 系列语言模型、语音模型、视频模型）的能力定位与产品矩阵、智能对话的基本使用技巧、角色扮演与长文本处理功能体验、免费额度与订阅方案说明，帮助用户快速了解 Minimax 平台全貌并高效上手使用。
494
2026.05.13
聚焦 Minimax 语音技术中最受关注的声音克隆与 AI 配音应用，讲解声音克隆（Voice Clone）的录制要求与上传流程、少量样本即可定制专属音色的操作步骤、克隆音色的自然度与相似度优化技巧、中英文及多语种语音合成效果调控、情感化朗读（开心/悲伤/激昂/低沉）的参数设置，以及在短视频配音、有声读物批量制作、播客节目生成、电商产品口播、企业培训课件配音等热门场景中的实操应用。
303
2026.05.13
围绕当前最热门的 AI 视频生成需求，全面讲解 Minimax 海螺 AI 视频生成的使用方法，涵盖文本生成视频（Text-to-Video）的场景描述与镜头语言提示词编写、图片生成视频（Image-to-Video）的首帧构图与运动方向控制、视频风格（写实/动漫/电影/3D）切换技巧、生成效果的常见问题（人物变形/动作不连贯）优化策略、热门爆款视频的创作思路拆解，帮助创作者与运营人员用 AI 高效产出吸睛短视频内容。
398
2026.05.13
热门下载
相关下载
精品课程
共1课时 | 537人学习
共0课时 | 0人学习
共1课时 | 208人学习
