invalid parameter错误源于参数格式、类型或取值违规，需依次校验身份端点、文本生成、工具调用及tts/视频专用参数四类配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在调用MiniMax API时收到“Invalid Parameter”错误响应，则很可能是请求体中某一关键字段的格式、类型或取值范围不符合平台强制校验规则。以下是针对该报错的多种参数配置避坑路径：
一、身份与端点参数校验
Authorization头缺失Bearer前缀、Base URL路径不匹配或Model ID拼写错误，均会触发参数级拒绝，而非认证失败。
1、检查Authorization请求头是否严格为Bearer QC-9aBcDeFgHiJkLmNoPqRsTuVwXyZ格式，Bearer与API Key之间必须为单个英文空格，且Key区分大小写。
2、确认Base URL从控制台“模型服务→详情”页面完整复制，国内版必须使用https://api.minimaxi.com/v1/（末尾含斜杠），不可省略或替换为platform.minimaxi.com。
3、Model ID须与控制台已开通模型ID完全一致，例如abab6.5s-chat或M2.5，禁止使用别名、缩写、旧版ID（如abab5.5）或大小写混用。
二、文本生成类参数结构修复
messages数组结构非法、temperature越界或max_tokens超限，会导致JSON Schema校验直接失败并返回Invalid Parameter。
1、验证messages是否为非空数组，每个元素必须包含且仅包含role与content两个键，role值仅允许"system"、"user"、"assistant"三者之一，不可为null、空字符串或拼写错误（如"usr"）。
2、检查temperature是否落在0.3–0.7闭区间内，禁止设为0、1、负数或字符串形式（如"0.5"需为数字0.5）。
3、确认max_tokens为正整数且≤2048，同时确保prompt总token数未超过模型上下文上限（如M2.5支持200000 tokens，但接口仍校验max_tokens合法性）。
MiniMax Token Plan 工具——支持图片生成、图像理解、语音合成和视频生成。直接调用 MiniMax 官方 API，纯 JavaScript 实现，无需外部 MCP 服务器。
三、工具调用参数完整性补全
tools字段为空、tool对象缺少required字段或parameters不符合JSON Schema v7语法，将被平台判定为参数不完整。
1、确保tools为非空数组，每个tool对象中type必须为字符串"function"，function子对象内name、description、parameters三者缺一不可，且parameters必须为合法JSON Schema对象。
2、parameters中required字段必须为字符串数组，所列参数名须与properties中定义的键完全一致，例如["location", "unit"]不可写作["Location", "Unit"]或["loc", "u"]。
3、检查properties中每个参数的type声明是否合规，禁止使用"type": "string | number"等联合类型，必须为单一基础类型（string/number/boolean/object/array）。
四、TTS与视频生成专用参数对齐
TTS异步调用遗漏task_id轮询路径，或视频生成中图像尺寸/时间维度prompt未达标，均属参数维度硬性拦截。
1、TTS请求必须包含三阶段完整参数：任务创建时传入text与voice；轮询时使用返回的task_id；下载时携带该task_id及文件后缀，任一阶段缺失task_id或路径参数格式错误（如缺少/v1/tts/task/{task_id}/result）即报Invalid Parameter。
2、视频生成输入图像必须为PNG/JPEG格式、分辨率≥512×512且长宽比为1:1或16:9，prompt中必须显式声明时间维度（如"持续3秒"、"镜头平移耗时2.5秒"），不可仅写"移动"或"变化"。
3、模板ID须从控制台“视频生成→可用模板”列表中精确选取，禁止使用未开通模板ID、拼写错误ID（如"template_v2"误作"template-v2"）或过期ID。
