先安装minimax-api SDK并配置API密钥与GROUP_ID，再用MinimaxAgent类调用chat()发送prompt；流式响应需判空chunk再取delta.content，错误码401/403/429须分别处理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为MiniMax Agent编写一份能直接上手操作的代码教程，让开发者按步骤就能跑通基础Agent调用流程，不依赖官方SDK文档翻找、不卡在认证或参数格式错误上。
准备API密钥和基础环境
访问 https://www.minimax.ai/console 登录账号，在「API Keys」页面点击「Create API Key」生成新密钥；【密钥仅显示一次，复制后立即保存，刷新页面将无法再次查看】。
新建一个 Python 3.8+ 项目目录，执行：pip install minimax-api 安装官方SDK（注意不是minimax或其他相似包名）。
创建config.py文件，写入：
API_KEY = "your_api_key_here"GROUP_ID = "your_group_id_here" # 控制台项目详情页可查，不是用户ID
初始化Agent并发送第一条消息
方法一：使用MinimaxAgent类封装调用（推荐新手）
新建agent_demo.py，导入并初始化：
from minimax_api import MinimaxAgentagent = MinimaxAgent(api_key=API_KEY, group_id=GROUP_ID)
您的智能体声称“已完成”——但它真的验证过了吗？Superpowers 可将任意 OpenClaw 智能体转变为一名严谨的工程师。其核心机制包括： - **验证铁律**（主张须有证据支撑） - **三智能体代码评审流程**（构建 → 验证规格符合性 → 验证质量） - **系统化调试机制**（四阶段根因分析 + 三击规则） - **头脑风暴关卡**（先完成设计，再编写代码） - **反过度工程规则** 适用场景： (1) 任意复杂度的编码任务 (2) 调试失败问题 (
调用agent.chat()发送文本请求，传入prompt字符串即可，不需要构造复杂message列表——SDK会自动补全system角色和格式校验。
方法二：手动构造HTTP请求（适合调试或集成到非Python系统）
向https://api.minimax.chat/v1/text/chat发送POST请求，Header中必须包含Authorization: Bearer {API_KEY}和Content-Type: application/json；Body中model字段值必须是"abab6.5s-chat"或"abab6.5t-chat"，填错会返回400且无明确提示。
处理流式响应并捕获常见错误
第一步：启用流式输出，在chat()调用中加入stream=True参数。
第二步：用for chunk in agent.chat(..., stream=True):逐块读取，每块是dict类型，含"choices"和"delta"字段；【chunk可能为空字典，需加if chunk.get("choices"):判空再取delta.content，否则会抛KeyError】。
第三步：捕获MinimaxAPIError异常，重点检查e.status_code：401代表密钥失效，403说明GROUP_ID与密钥不匹配，429表示QPS超限——此时应暂停1秒后重试，不要盲目轮询。
