MiniMax Agent根据产品说明生成代码教程

先安装minimax-api SDK并配置API密钥与GROUP_ID，再用MinimaxAgent类调用chat()发送prompt；流式响应需判空chunk再取delta.content，错误码401/403/429须分别处理。

你需要为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 MinimaxAgent
agent = 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请求。请求头里有两项是不能漏的：Authorization: Bearer {API_KEY}和Content-Type: application/json；同时，请求体里的model字段只能填写"abab6.5s-chat"或"abab6.5t-chat"，一旦写错，接口会直接返回400，而且通常不会给出清晰的错误提示。

处理流式响应并捕获常见错误

第一步：启用流式输出，在chat()调用中加入stream=True参数。

第二步，用for chunk in agent.chat(..., stream=True):按块读取返回内容。这里拿到的每个块本质上都是一个dict，里面会带有"choices"和"delta"这两个字段；

第三步：捕获MinimaxAPIError异常，重点检查e.status_code：401代表密钥失效，403说明GROUP_ID与密钥不匹配，429表示QPS超限——此时应暂停1秒后重试，不要盲目轮询。