MiniMax Agent API参数错误怎么排查

遇到“Invalid Parameter”这类报错，别急着一股脑重试，通常得按类别逐项排查：先看身份凭证是否有问题，比如Bearer后的空格是否正确、域名是否匹配；再检查messages结构，确认role和content都符合要求；接着核对tools定义，重点看type、function、parameters是不是填写完整；如果涉及多模态参数，还要继续往下查图像尺寸、视频时长，以及音频ID是否有效。

调用MiniMax Agent API时收到“Invalid Parameter”错误，说明请求体中某个字段的格式、类型或取值违反了服务端强制校验规则，必须逐类定位——身份凭证错配、文本结构非法、工具定义残缺、多模态参数越界，任一环节出错都会直接拦截，不进入模型推理流程。

核对身份与端点参数

第一步：检查Authorization请求头是否严格为Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx格式，

第二步：先把 Base URL 核对清楚，务必从控制台“模型服务→详情”页面完整复制。国内版必须使用https://api.minimaxi.com/v1/（注意末尾这个斜杠不能少），国际版则必须使用https://api.minimax.chat/v1/。

第三步：Model ID须与控制台已开通模型ID完全一致，例如MiniMax-M3或abab6.5s-chat，禁止大小写混用（如miniMax-M3）、使用别名（如m3）或旧版ID（如abab5.5）。

验证messages数组结构

messages必须为非空数组，每个元素严格包含role与content两个键，role值仅允许小写字符串"user"、"assistant"、"system"三者之一——

content字段不能为空字符串，system消息若存在，其content必须提供明确角色定义（如"你是一个严谨的代码审查助手"），不能只写"system"或留空。

检查messages中是否混入了未声明的字段，例如OpenAI风格的name字段、tool_calls字段，MiniMax Agent API不识别这些字段，会静默丢弃整个message元素导致结构异常。

检查tools与tool_choice配置

方法一：tools字段必须为非空数组，每个tool对象中type必须为字符串"function"，function子对象内name、description、parameters三者缺一不可。

方法二：parameters必须为合法JSON Schema v7对象，其中required字段必须是字符串数组，所列参数名须与properties中定义的键完全一致——

方法三：tool_choice字段若启用，值必须为"auto"、"none"或{"type": "function", "function": {"name": "xxx"}}格式，禁止设为true/false或字符串"required"。

排查多模态参数合规性

若请求含图像输入，需确保image字段独立传参（不可嵌入content字符串中），且base64编码前原始图片宽高均≥800像素——

视频生成类请求中，time_dimension字段必须为正整数，且值需匹配所选模板支持的秒数（如模板"short_15s"仅接受15），超出范围将触发参数校验失败。

音频克隆接口中，voice_id必须是已完成克隆任务并返回success状态的ID，未就绪ID或格式错误ID（如含空格、中文、特殊符号）会立即报错。