遇到“Invalid Parameter”这类报错，别急着一股脑重试。通常需要按类别逐项排查。

先看身份凭证是否有问题，比如Bearer后的空格是否正确、域名是否匹配。再检查messages结构，确认role和content都符合要求。

接着核对tools定义，重点看type、function、parameters是不是填写完整。如果涉及多模态参数，还要继续往下查图像尺寸、视频时长，以及音频ID是否有效。

调用MiniMax Agent API时收到“Invalid Parameter”错误，说明请求体中某个字段的格式、类型或取值违反了服务端强制校验规则。

必须逐类定位：身份凭证错配、文本结构非法、工具定义残缺、多模态参数越界，任一环节出错都会直接拦截，不进入模型推理流程。

核对身份与端点参数

Authorization请求头格式

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

【Bearer与API Key之间必须且仅有一个英文半角空格】。粘贴时容易混入全角空格或换行符，建议在VS Code中开启“显示不可见字符”后重新复制。

Base URL是否正确

第二步：先把 Base URL 核对清楚，务必从控制台“模型服务→详情”页面完整复制。

• 国内版必须使用https://api.minimaxi.com/v1/（注意末尾这个斜杠不能少）

• 国际版则必须使用https://api.minimax.chat/v1/

【如果拿 minimaxi.com 的密钥去配 platform.minimaxi.com 这个域名，系统会直接报 401，不会提示参数错误】。

Model ID是否一致

第三步：Model ID须与控制台已开通模型ID完全一致，例如MiniMax-M3或abab6.5s-chat。

• 禁止大小写混用，如miniMax-M3

• 禁止使用别名，如m3

• 禁止使用旧版ID，如abab5.5

验证messages数组结构

messages基础要求

messages必须为非空数组，每个元素严格包含role与content两个键。

role值仅允许小写字符串"user"、"assistant"、"system"三者之一。【"developer"、"bot"、"AI"等自定义role会直接触发code=2013】。

content内容要求

content字段不能为空字符串。

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

避免混入未声明字段

检查messages中是否混入了未声明的字段，例如OpenAI风格的name字段、tool_calls字段。

MiniMax Agent API不识别这些字段，会静默丢弃整个message元素，导致结构异常。

检查tools与tool_choice配置

tools字段完整性

方法一：tools字段必须为非空数组，每个tool对象中type必须为字符串"function"。

function子对象内name、description、parameters三者缺一不可。

parameters格式要求

方法二：parameters必须为合法JSON Schema v7对象，其中required字段必须是字符串数组。

所列参数名须与properties中定义的键完全一致。【["location", "unit"]不可写作["Location", "Unit"]或["loc", "u"]】。

tool_choice取值范围

方法三：tool_choice字段若启用，值必须为"auto"、"none"或{"type": "function", "function": {"name": "xxx"}}格式。

禁止设为true/false或字符串"required"。

排查多模态参数合规性

图像输入检查

若请求含图像输入，需确保image字段独立传参，不可嵌入content字符串中。

且base64编码前原始图片宽高均≥800像素。【低于800×800的图片会被网关层直接拒绝，返回Invalid Parameter而非尺寸提示】。

视频生成参数检查

视频生成类请求中，time_dimension字段必须为正整数。

且值需匹配所选模板支持的秒数，例如模板"short_15s"仅接受15，超出范围将触发参数校验失败。

音频克隆参数检查

音频克隆接口中，voice_id必须是已完成克隆任务并返回success状态的ID。

未就绪ID或格式错误ID，如含空格、中文、特殊符号，会立即报错。