Files

T

song_kang_shuai 7b30819c22 feat(skills): 更新 mmx Skill，基于 --help 验证完整命令参数

2026-05-11 17:54:33 +08:00

6.8 KiB

Raw Permalink Blame History

name, description

name	description
mmx	MiniMax CLI 工具，提供文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索、图像理解等 AI 功能

MiniMax CLI 工具 (mmx)

安装与初始化

1. 安装 mmx-cli

npm install -g mmx-cli

2. 登录 API Key

方式一：用户直接提供 Key

用户告诉我 API Key（如 sk-xxxxx）
执行：mmx auth login --api-key sk-xxxxx

方式二：交互式登录

执行：mmx auth login
用户在终端手动输入 API Key

3. 验证登录状态

mmx auth status

全局选项

选项	说明
`--api-key <key>`	API 密钥
`--region <region>`	区域: global (默认), cn
`--base-url <url>`	API 基础 URL（覆盖 region）
`--output <format>`	输出格式: text, json
`--quiet`	静默模式，不显示非必要输出
`--verbose`	显示 HTTP 请求/响应详情
`--timeout <seconds>`	超时时间（默认 300）
`--no-color`	禁用颜色
`--dry-run`	仅展示不执行
`--non-interactive`	非交互模式（CI/agent 模式必须添加）
`--version`	显示版本
`--help`	显示帮助

1. 文本对话 (text chat)

# 基本对话
mmx text chat --message "你好"

# 带系统提示词
mmx text chat --system "你是一个专业的程序员" --message "写一个快速排序"

# 多轮对话（重复 --message）
mmx text chat --message "Hello" --message "How are you?"

# 指定模型
mmx text chat --model MiniMax-M2.7-highspeed --message "Hello"

# 输出 JSON 格式
mmx text chat --message "Hello" --output json

# 最大 token 数
mmx text chat --message "详细解释" --max-tokens 8192

2. 语音合成 (speech synthesize)

⚠️ 注意: 默认语音是英文 English_expressive_narrator，中文必须指定语音！

# 基本语音合成
mmx speech synthesize --text "你好，世界"

# 保存到文件
mmx speech synthesize --text "你好" --out hello.mp3

# 指定中文语音（必须！）
mmx speech synthesize --text "你好" --voice "Chinese (Mandarin)_Warm_Girl"

# 指定英文语音
mmx speech synthesize --text "Hello" --voice English_expressive_narrator

# 调整语速
mmx speech synthesize --text "快速朗读" --speed 1.5

# 指定音频格式
mmx speech synthesize --text "测试" --format wav --out test.wav

# 查看所有可用语音
mmx speech voices

# 筛选特定语言语音
mmx speech voices --language chinese

常用中文语音:

Chinese (Mandarin)_Warm_Girl - 温暖女孩
Chinese (Mandarin)_Sweet_Lady - 甜蜜女士
Chinese (Mandarin)_Kind-hearted_Antie - 善良阿姨
Chinese (Mandarin)_Gentle_Youth - 温柔青年
Chinese (Mandarin)_Gentleman - 绅士
Chinese (Mandarin)_Reliable_Executive - 可靠主管
Chinese (Mandarin)_News_Anchor - 新闻主播
Chinese (Mandarin)_Humorous_Elder - 幽默长辈
Chinese (Mandarin)_Lyrical_Voice - 抒情嗓音

3. 图像生成 (image generate)

# 基本图像生成
mmx image generate --prompt "一只可爱的猫"

# 指定宽高比
mmx image generate --prompt "风景画" --aspect-ratio 16:9

# 生成多张
mmx image generate --prompt "Logo" --n 3

# 保存到文件
mmx image generate --prompt "山水画" --out /tmp/landscape.jpg

# 指定尺寸 (512-2048, 必须是 8 的倍数)
mmx image generate --prompt "宽图" --width 1920 --height 1080

# 使用提示词优化
mmx image generate --prompt "猫" --prompt-optimizer

# 添加 AI 水印
mmx image generate --prompt "山水画" --aigc-watermark

# 使用种子保持一致输出
mmx image generate --prompt "城堡" --seed 42

4. 图像理解 (vision describe)

# 描述本地图片
mmx vision describe --image photo.jpg

# 描述网络图片
mmx vision describe --image https://example.com/photo.jpg

# 自定义问题
mmx vision describe --image photo.jpg --prompt "这张图里有什么动物？"

5. 视频生成 (video generate)

# 文本生成视频 (T2V)
mmx video generate --prompt "一个人在海边跑步"

# 图片生成视频 (I2V) - 使用 Hailuo-2.3
mmx video generate --prompt "风景动画" --first-frame image.jpg

# 快速模式 I2V
mmx video generate --prompt "动画效果" --first-frame image.jpg --model MiniMax-Hailuo-2.3-Fast

# 首尾帧插值 (SEF) - 使用 Hailuo-02
mmx video generate --prompt "行走动画" --first-frame start.jpg --last-frame end.jpg

# 主体参考 (S2V) - 使用 S2V-01
mmx video generate --prompt "侦探行走" --subject-image character.jpg

# 异步模式（不等待，直接返回任务 ID）
mmx video generate --prompt "机器人绘画" --async --quiet

# 下载到文件
mmx video generate --prompt "海边日落" --download sunset.mp4

# 查看任务状态
mmx video task get --task-id <task_id>

# 下载视频
mmx video download --file-id <file_id> --out video.mp4

6. 音乐生成 (music generate)

⚠️ 必须提供: --lyrics 或 --lyrics-optimizer 或 --instrumental

# 自动生成歌词（推荐方式）
mmx music generate --prompt "超燃的CS游戏主题曲" --lyrics-optimizer --out battle.mp3

# 提供自定义歌词
mmx music generate --prompt "流行音乐" --lyrics "第一段歌词" --out song.mp3

# 纯音乐（无人声）
mmx music generate --prompt "史诗管弦乐" --instrumental --out bgm.mp3

# 指定风格参数
mmx music generate --prompt "温暖的民谣" --vocals "温暖男声" --instruments "木吉他，钢琴" --bpm 95 --genre folk --out folk.mp3

# 指定音乐结构
mmx music generate --prompt "摇滚" --structure "verse-chorus-verse-bridge-chorus" --out rock.mp3

# 使用参考曲目
mmx music generate --prompt "类似甲壳虫乐队" --references "The Beatles" --lyrics-optimizer --out beatles.mp3

# 指定输出格式
mmx music generate --prompt "电子乐" --format wav --sample-rate 44100 --out electronic.wav

# 音乐封面生成
mmx music cover --prompt "流行风格" --audio https://example.com/song.mp3 --out cover.mp3

7. 网页搜索 (search query)

# 基本搜索
mmx search query --q "MiniMax AI 最新消息"

# JSON 输出
mmx search query --q "天气" --output json

8. 其他命令

# 查看配额
mmx quota show

# 更新 mmx
mmx update

# 配置管理
mmx config show
mmx config set --key region --value cn

帮助命令

mmx --help              # 全局帮助
mmx <resource> --help    # 资源帮助（如 mmx music --help）
mmx text chat --help     # 命令帮助

重要提示

CI/Agent 模式: 务必添加 --non-interactive 标志
中文语音: speech synthesize 默认是英文，必须通过 --voice 指定中文语音
音乐生成: 必须使用 --lyrics、--lyrics-optimizer 或 --instrumental 之一
查看帮助: 使用 mmx <command> --help 查看最新命令选项

6.8 KiB Raw Permalink Blame History Unescape Escape