“Invalid Parameter”错误需逐类排查：身份凭证（Bearer空格、域名匹配）、messages结构（role/content合规）、tools定义（type/function/parameters完整）、多模态参数（图像尺寸、视频时长、音频ID有效性）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用MiniMax Agent API时收到“Invalid Parameter”错误，说明请求体中某个字段的格式、类型或取值违反了服务端强制校验规则，必须逐类定位——身份凭证错配、文本结构非法、工具定义残缺、多模态参数越界，任一环节出错都会直接拦截，不进入模型推理流程。
核对身份与端点参数
第一步：检查Authorization请求头是否严格为Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx格式，【Bearer与API Key之间必须且仅有一个英文半角空格】，粘贴时易混入全角空格或换行符，建议在VS Code中开启“显示不可见字符”后重复制。
第二步：确认Base URL从控制台“模型服务→详情”页面完整复制，国内版必须用https://api.minimaxi.com/v1/（末尾含斜杠），国际版必须用https://api.minimax.chat/v1/，【minimaxi.com密钥配platform.minimaxi.com域名会直接触发401，而非参数错误】。
第三步：Model ID须与控制台已开通模型ID完全一致，例如MiniMax-M3或abab6.5s-chat，禁止大小写混用（如miniMax-M3）、使用别名（如m3）或旧版ID（如abab5.5）。
验证messages数组结构
messages必须为非空数组，每个元素严格包含role与content两个键，role值仅允许小写字符串"user"、"assistant"、"system"三者之一——【"developer"、"bot"、"AI"等自定义role会直接触发code=2013】。
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中定义的键完全一致——【["location", "unit"]不可写作["Location", "Unit"]或["loc", "u"]】。
方法三：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（如含空格、中文、特殊符号）会立即报错。
