必须完成实名认证才能解锁MiniMax Agent全部能力，未认证账户无法创建API密钥或调用M2.5、H3等模型；创建密钥后需同时配置32位API Key和16位Group ID，并正确设置环境变量或通过MMX-CLI调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想用MiniMax Agent快速生成可运行的前端页面、API接口或脚本工具，但卡在第一步：不知道从哪开始调用、该填什么参数、为什么提示词写了却没出代码。
开通权限并获取密钥
登录 agent.minimax.io 后，必须完成实名认证才能解锁全部Agent能力。未认证账户无法创建Key，也无法调用M2.5或H3等生产级模型。
进入「接口密钥」页，点击「创建密钥」，输入名称（如“dev-web”），系统立即生成一串32位Base64字符串——【这串Key仅显示一次，关闭页面即永久不可见】。
同时在「组织管理」中复制16位Group ID，格式类似a1b2c3d4e5f67890。二者必须同时配置，缺一不可。
本地环境一键接入
打开终端，执行三行命令即可完成基础绑定：
export MINIMAX_API_KEY="your-api-key-here"
export MINIMAX_GROUP_ID="your-group-id-here"
export MINIMAX_BASE_URL="https://api.minimaxi.com/v1"
无需安装SDK，所有HTTP请求将自动携带认证头。若使用OpenClaw，运行openclaw configure后按提示填入上述两项值，选择模型为MiniMax-M2.5即可。
写第一段可执行代码
方法一：用curl直接发请求（适合调试）
新建prompt.json，写入以下内容：
{"model": "MiniMax-M2.5", "messages": [{"role": "user", "content": "生成一个带深色模式切换按钮的HTML页面，点击按钮切换body的class为'dark'或'light'，并用CSS实现两套配色"}]}
执行：curl -X POST $MINIMAX_BASE_URL/chat/completions -H "Authorization: Bearer $MINIMAX_API_KEY" -H "Content-Type: application/json" -d @prompt.json
方法二：用MMX-CLI（推荐新手）
先安装：pip install mmx-cli，然后一行命令搞定：mmx chat -m MiniMax-M2.5 "生成一个带深色模式切换按钮的HTML页面..."。它会自动注入Key、Group ID和URL，输出结果直接带语法高亮。
注意：若提示401 Unauthorized，请确认环境变量中的Key是否复制完整——末尾换行符会被误粘贴，导致认证失败。
让代码真正跑起来
第一步：复制返回JSON中choices[0].message.content字段的全部内容，保存为dark-mode.html。
第二步：检查代码是否含<script></script>标签。MiniMax-M2.5默认生成完整可运行页面，但若你只写了“写一个函数”，它可能只返回函数体，不带HTML结构。
第三步：双击打开dark-mode.html，或用python3 -m http.server 8000启动本地服务后访问http://localhost:8000/dark-mode.html。按钮应能实时切换背景与文字颜色。
第四步：若CSS未生效，打开浏览器开发者工具，查看Console是否有Uncaught ReferenceError——这说明JS中引用了未定义的DOM元素，需确认HTML结构是否完整闭合。
