MiniMax Skill

MiniMax CLI（mmx）是 MiniMax 平台的官方命令行工具，支持文本、图片、视频、语音、音乐、视觉理解、网络搜索等全部生成能力。

前置条件

确认 mmx-cli 已安装：

mmx --version

如未安装：

npm install -g mmx-cli
# 需要 Node.js >= 18

认证（如需）：

mmx auth login --api-key <your-api-key>
# 或浏览器交互登录：mmx auth login
mmx auth status  # 查看认证状态

核心能力速查

用量查询（quota）

基本查询

mmx quota

返回各模型的配额余量。

JSON 格式（推荐程序解析）

mmx quota --format json

解析配额 JSON

可用 scripts/quota.py 格式化输出：

mmx quota --format json | python3 skills/minimax/scripts/quota.py

文字聊天（text）

# 简单对话
mmx text chat --message "写一首关于AI的小诗"

# 带系统提示
mmx text chat --system "你是苏东坡" --message "写一首词"

# 流式输出
mmx text chat --message "..." --stream

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

图片生成（image）

# 基础图片生成
mmx image --prompt "一只在月球上弹吉他的猫，动漫风格"

# 指定宽高比
mmx image --prompt "..." --aspect 16:9

# 指定输出文件
mmx image --prompt "..." --out output.png

# 批量生成
mmx image --prompt "..." --batch 4

视频生成（video）

# 提交视频生成任务（异步）
mmx video generate --prompt "日落时一只猫坐在窗边看向远方"

# 查询任务状态
mmx video task get <task_id>

# 下载完成的视频
mmx video download <task_id> --out video.mp4

视频生成是异步的，需轮询任务状态。

语音合成（speech）

# 基础语音合成
mmx speech synthesize --text "欢迎使用MiniMax语音合成" --out voice.mp3

# 指定音色（查看可用音色）
mmx speech voices

# 指定特定音色
mmx speech synthesize --text "..." --voice <voice_name> --out voice.mp3

# 流式输出（实时播放）
mmx speech synthesize --text "..." --stream

音乐生成（music）

# 纯音乐生成
mmx music generate --prompt "一首轻快的夏日海滩爵士乐" --out music.mp3

# 生成带歌词的歌曲
mmx music generate --prompt "一首关于梦想的流行歌曲" --lyrics --out song.mp3

# 生成翻唱/改编
mmx music cover --source original.mp3 --prompt "改编成摇滚风格" --out cover.mp3

视觉理解（vision）

# 图片理解（本地文件）
mmx vision describe image.jpg

# URL 图片
mmx vision describe https://example.com/image.jpg

# 支持多种输出格式
mmx vision describe image.jpg --output json

网络搜索（search）

mmx search "最新的AI技术趋势"
mmx search "MiniMax API 文档"

认证管理（auth）

mmx auth status      # 查看当前登录状态
mmx auth refresh    # 刷新 Token
mmx auth logout     # 登出
mmx auth login      # 交互式登录

配置管理（config）

mmx config show              # 显示当前配置
mmx config set <key> <value> # 设置配置项
mmx config export-schema     # 导出配置 schema

更新 mmx

mmx update

全局参数

脚本资源

• scripts/quota.py：解析 mmx quota --format json 输出，格式化为易读的用量报表
• scripts/video_poll.py：轮询视频任务状态直至完成或超时