要将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参数时,超长回复可能触发网关超时。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











