先安装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"这两个字段。

【但要特别注意，chunk有时可能是空字典，所以在读取delta.content之前，必须先用if chunk.get("choices"):做一次判空，否则很容易直接抛出KeyError】

第三步：捕获常见错误码

捕获MinimaxAPIError异常后，重点检查e.status_code。

• 401：代表密钥失效
• 403：说明GROUP_ID与密钥不匹配
• 429：表示QPS超限

遇到429时，应暂停1秒后重试，不要盲目轮询。

《夸克》非常好用的免费AI浏览器

下载APP查看