跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://platform.minimaxi.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

对于Token Plan 用户,不用写一行代码,帮助你的 Agent 拥有 MiniMax 的全部多模态能力:视频生成、语音合成、音乐创作、编程,都可以在 OpenClaw, Claude Code 等AI助手中直接调用。 如果仍想通过 API 直接调用,作为开发者自行集成,另外详见 API 文档

安装和配置 CLI

请将以下提示词复制给你的AI Agent(OpenClaw、Claude Code、Cursor、MaxClaw、AutoClaw、KimiClaw、TRAE、OpenCode等), 它会引导你完成安装、登录与 SKILL 接入(请将 sk-xxxxx 替换为你的实际密钥):
请帮我接入 MiniMax CLI(https://github.com/MiniMax-AI/cli),按以下三步完成安装与配置:

1. 全局安装 CLI:执行 `npm install -g mmx-cli`,完成后用 `mmx --version` 验证
2. 登录并配置 API Key:执行 `mmx auth login --api-key sk-xxxxx`;
3. 安装官方 SKILL:执行 `npx skills add MiniMax-AI/cli -y -g`

完成后请执行 `mmx quota` 查看我的 Token Plan 余额,确认整体配置生效。

调用 CLI

文本 · 四言诗输入(Agent指令): 帮我用minimax生成一首关于AI的4言诗输出: 算力无垠,星火相连;
智能如海,梦随光年

视频 · Hailuo 2.3输入(Agent指令): 生成一段视频:夕阳下,一只猫坐在窗边望向远方输出:
音乐 · Music 2.6输入(Agent指令): 生成一首轻快爵士风格的歌曲,主题是夏天的海边输出:
语音 · Speech 2.8输入(Agent指令): 用温柔女声音朗读:欢迎使用 MiniMax Token Plan, 订阅 Token Plan 后,让你的 Agent 拥有全模态能力,生成视频、音乐、语音和图片。输出:
图片 · Image 01输入(Agent指令): 生成一张赛博朋克风格的城市夜景图,16:9 比例输出:生成的文件会保存在当前目录下的 minimax-output/ 文件夹中,推荐在 Agent 结果下直接展示生成内容。

CLI 面板

在命令行输入 mmx,即可打开CLI面板,快速了解 MMX-CLI 的主要功能和用量信息

MMX-CLI 登录成功界面示意图
  • resources: 当前可用的调用资源类型
  • flags: 支持在命令后加的参数/选项
  • 用量信息: 剩余额度与配额概览
  • 帮助入口: 使用方法说明

能力概览

MMX-CLI 在终端内提供统一的命令入口,覆盖文本、图像、视频、语音、音乐、视觉理解与网络检索等能力:
能力基本命令说明
文本mmx text chat多轮对话、流式输出、系统提示词、JSON 输出
图像mmx image generate文生图,支持宽高比与批量生成
视频mmx video generate异步视频生成,支持任务查询与下载
语音mmx speech synthesize文字转语音(TTS),支持多音色与流式输出
音乐mmx music generate文生音乐,支持歌词模式与纯音乐模式
视觉mmx vision describe图像理解,支持本地文件、URL、文件 ID
搜索mmx search query内置网络检索
命令用途典型示例
mmx auth status / refresh / logout查看登录身份 / 刷新凭据 / 登出mmx auth status
mmx config show / set查看与修改配置(region、默认模型等)mmx config set --key region --value cn
mmx quota查看 Token Plan 用量与剩余额度mmx quota
mmx update / mmx update latest检查更新 / 升级到最新版mmx update latest

不同模态的用量

对于不同的 token plan 的不同模态的用量,请见:Token Plan 订阅定价

常见问题

API Key 在哪里申请?

登录后仍报 401 怎么办?

通常 mmx auth login 会根据 API Key 自动检测服务区域(若购买的是国内套餐,在进行 mmx auth login 配置时尽量不要开VPN)。若仍报 401,大概率是 region 未自动匹配成功,可手动指定:
mmx config set --key region --value cn       # 国内 API Key
mmx config set --key region --value global   # 海外 API Key
执行 mmx auth status 确认当前 region 与 Key 来源平台一致。