先安装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,导入并初始化:
将匿名化的 OpenClaw 配置共享给 OpenSoul 社区,适用于用户想分享代理设置、探索他人使用方式等场景。
from minimax_api import MinimaxAgentagent = MinimaxAgent(api_key=API_KEY, group_id=GROUP_ID)
调用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秒后重试,不要盲目轮询。

















