要将MiniMax Agent嵌入后端，需先在控制台创建并发布Agent获取Agent ID和项目级API Key，再构造含Authorization、Content-Type的HTTPS POST请求调用API，正确解析200响应中choices[0].message.content字段。

要把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 发起 POST 请求时，可按以下格式调用 https://api.minimax.chat/v1/text/chatcompletion 接口：
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参数时，超长回复可能触发网关超时。

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

下载APP查看