要将MiniMax Agent嵌入后端，需先在控制台创建并发布Agent获取Agent ID和项目级API Key，再构造含Authorization、Content-Type的HTTPS POST请求调用API，正确解析200响应中choices[0].message.content字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要把MiniMax Agent能力嵌入你自己的后端服务，必须构造合法的HTTP请求并正确解析响应，否则会卡在401或404错误里反复重试密钥。
获取Agent ID和API密钥
登录MiniMax开发者控制台，进入Agent模块创建实例后才能拿到这两个关键凭证。未发布的Agent无法调用，且测试Token仅对Web调试有效，正式调用必须用项目级API Key。
访问 https://platform.minimax.io，用实名认证手机号或邮箱登录 → 左侧导航栏点击【Agent】→【创建Agent】→ 选择“通用对话型”模板 → 填写名称与系统提示词 → 点击【保存并发布】。
发布成功后，在Agent详情页复制显示的【Agent ID】（一串32位十六进制字符串）；再进入【项目管理】→【API密钥管理】，确认已生成有效密钥，复制sk-xxx格式密钥并立即存至安全位置——该密钥在控制台仅显示一次，丢失需重新生成。
构造标准POST请求
MiniMax Agent API只接受HTTPS POST请求，且必须携带三个Header字段，缺一不可。任意字段拼写错误或值为空都会触发401。
方法一：curl命令行直调（适合快速验证）
执行以下命令，把YOUR_API_KEY、YOUR_AGENT_ID替换成实际值：
curl -X POST "https://api.minimax.chat/v1/text/chatcompletion" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "YOUR_AGENT_ID",
"messages": [{"role": "user", "content": "你好"}]
}'
方法二：Python requests调用（生产环境推荐）
确保已安装requests库：pip install requests。
import requests
url = "https://api.minimax.chat/v1/text/chatcompletion"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
data = {
"agent_id": "YOUR_AGENT_ID",
"messages": [{"role": "user", "content": "订单怎么退款？"}]
}
response = requests.post(url, headers=headers, json=data)
print(response.json()["choices"][0]["message"]["content"])
注意：不要在代码里硬编码密钥，务必从环境变量读取，比如os.getenv("MINIMAX_API_KEY")。
处理响应与常见错误
第一步：检查HTTP状态码。200才代表调用成功；401说明密钥无效或x-group-id缺失（旧版接口必须传）；404通常因Agent未发布或ID填错；429是超出速率限制，需加指数退避重试。
第二步：解析JSON响应体。必须按路径choices[0].message.content提取文本，直接打印整个response.json()会导致前端渲染异常。
第三步：启用流式响应（可选但推荐）。在请求体中加入"stream": true，后端需用SSE方式逐块接收，避免长响应阻塞连接。此时响应结构不再是完整JSON，而是以data:开头的多行文本流，每行一个chunk。
这一步操作起来很简单，直接在data字典里加一行即可，但不加stream参数时，超长回复可能触发网关超时。
