必须通过PHP后端发起HTTPS POST请求调用MiniMax Agent API,需配置正确Agent ID、项目级API密钥(sk-xxx)、Authorization与Content-Type请求头,并构造含agent_id和messages的JSON载荷,响应结果从choices[0].message.content提取。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在PHP项目中调用MiniMax Agent API实现智能对话能力,必须绕过前端直连限制,通过后端脚本发起HTTPS POST请求,携带有效Agent ID与API密钥,并严格构造JSON载荷——缺少agent_id字段或Content-Type头错误将直接返回400响应。
获取Agent ID与API密钥
登录Minimax开发者控制台,在Agent列表页找到已发布的实例,复制其Agent ID;在【项目管理】→【API密钥管理】中确认存在有效密钥,格式为sk-xxx,【务必使用项目级密钥而非测试Token】,测试Token仅限控制台调试,无法用于生产环境API调用。
打开浏览器访问https://platform.minimax.io,用实名认证手机号登录后,点击左侧【Agent】→进入详情页→复制顶部显示的Agent ID;再点击【项目管理】→【API密钥管理】→若无密钥则点击【创建新密钥】→复制生成的sk-xxx密钥字符串。
构造标准HTTP POST请求
方法一:使用cURL原生调用(推荐,兼容PHP 7.2+)
立即学习“PHP免费学习笔记(深入)”;
第一步:初始化cURL句柄,设置URL为https://api.minimax.chat/v1/text/chatcompletion;
第二步:配置请求头,必须包含Authorization: Bearer {your_api_key}和Content-Type: application/json,【缺一不可,否则返回401或400】;
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1),免gas,支持macOS/Linux/Windows。触发词:/r
第三步:构建JSON载荷数组,确保含agent_id(填入上一步复制的ID)、messages(至少一个role=user的关联数组)、stream=false(禁用流式以简化解析);
第四步:执行curl_exec()并检查$code是否为200,非200需读取curl_error()定位问题。
方法二:使用file_get_contents + stream_context_create(轻量、无需扩展)
这一步操作起来很简单,直接把JSON数据用json_encode()转成字符串,再用stream_context_create()封装headers即可;但注意:必须显式设置'http' => ['method' => 'POST'],否则默认是GET,会触发405错误。
解析Agent返回的纯文本内容
成功响应体是标准JSON,结构固定,必须从嵌套路径choices[0].message.content中提取结果;
用json_decode($response, true)将返回字符串转为关联数组,然后读取$result['choices'][0]['message']['content'];
如果未启用多轮对话,该字段就是最终AI回复文本,可直接echo或存入数据库;若启用了历史消息,需在下次请求的messages数组中追加本次的user+assistant两条记录,且总长度不能超过上下文窗口限制。


















