必须准确填写agent_id、messages等核心字段,确认Agent已发布并获取ID,messages至少含一条role为"user"的消息,设置agent_id、model(如需)、stream和max_tokens等参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让程序正确调用MiniMax Agent API并拿到有效回复,必须在请求体中准确填写agent_id、messages等核心字段,缺一不可,否则会直接返回400错误。
确认Agent已发布并获取ID
未发布的Agent无法被API调用,控制台显示“已发布”状态是调用成功的前提。
登录Minimax开发者控制台→左侧导航栏点击【Agent】→找到目标Agent→确认状态为“已发布”→点击右侧【详情】→复制页面顶部显示的【Agent ID】(格式如agt_XXXXXXXXXXXXXXXX)。
若页面仅显示“测试Token”而无Agent ID,说明该Agent尚未完成发布流程,需返回编辑页点击【保存并发布】。
构造合法的messages数组
messages字段必须是JSON数组,且至少包含一条role为"user"的消息;空数组或缺少role字段将触发400响应。
方法一:单轮基础对话
填入[{"role":"user","content":"你好"}]——这是最简可用结构,适合首次测试。
方法二:带系统角色的多轮初始化
填入[{"role":"system","content":"你是一名技术支持工程师"},{"role":"user","content":"我的设备无法联网,请问怎么排查?"}]——system消息必须提供明确角色定义,不能留空字符串。
方法三:延续历史对话
将前几轮交互按时间顺序追加进数组,例如[{"role":"user","content":"订单号是多少?"},{"role":"assistant","content":"您的订单号是ORD-7890"},{"role":"user","content":"能查下物流吗?"}]——注意总长度不可超过模型上下文窗口限制(如M2.5支持200000 tokens)。
设置必填参数与可选控制项
第一步:填入agent_id字段
值必须与上一步复制的ID完全一致,区分大小写,且不能加引号外的空格。
第二步:指定model字段(部分场景强制要求)
若Agent未绑定默认模型,则必须显式填写model,例如"abab6.5s-chat";填写错误型号(如拼成abab6.5s_chat)会导致404。
第三步:添加stream控制(推荐关闭初测)
加入"stream": false字段可禁用流式响应,避免前端解析不完整JSON片段;不加此字段时,响应体为SSE格式,需额外处理。
第四步:约束输出长度(防截断无声错)
设置"max_tokens": 1024,确保回复不被后台静默截断;值设为0或负数将导致请求失败。


















