MiniMax Agent API请求参数填写方法

必须准确填写agent_id、messages等核心字段，确认Agent已发布并获取ID，messages至少含一条role为"user"的消息，设置agent_id、model（如需）、stream和max_tokens等参数。

要让程序正确调用MiniMax Agent API并拿到有效回复，必须在请求体中准确填写agent_id、messages等核心字段，缺一不可，否则会直接返回400错误。

确认Agent已发布并获取ID

未发布的Agent无法被API调用，控制台显示“已发布”状态是调用成功的前提。

登录Minimax开发者控制台→左侧导航栏点击【Agent】→找到目标Agent→确认状态为“已发布”→点击右侧【详情】→复制页面顶部显示的

（格式如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或负数将导致请求失败。