答案是请求体字段名拼错、类型错误或必填项遗漏导致格式错误。需检查Authorization头是否为“Bearer+空格+Key”，query/model/context三字段类型及取值是否合规，禁用前端专属参数，布尔值不加引号，数组字段不误传为对象，并严格对照文档校验命名规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在调用秘塔AI搜索API时收到“提示参数格式错误”报错，不是密钥失效也不是网络超时，而是请求体里某个字段名拼错了、类型传成了字符串而非布尔值、或必填项被遗漏——这类错误不会返回具体哪一行出错，只笼统提示格式问题，必须逐层校验结构。
检查请求头Authorization字段是否合规
打开你的代码文件，定位到headers字典或对象，确认键名是【Authorization】而非Authrization、authorization或X-API-Key；值必须为Bearer后接一个英文空格再跟完整API Key，不能多空格、少空格或混入中文空格。
这一步极容易手误。复制粘贴时若从网页文档里直接拖选，常会带入不可见的零宽空格（U+200B），导致认证失败却显示“格式错误”而非“Unauthorized”。建议手动敲写Bearer部分，Key部分用环境变量注入。
验证JSON请求体中三个核心字段
方法一：用Python requests库调试时，打印出最终发送的data字典内容，重点核对以下三项：
• query字段是否存在且为字符串类型（不能是None、空字典或数字）；
• model字段若存在，值必须是字符串，可选值仅限"fast"、"balanced"、"precise"，传"Fast"或"FAST"会触发格式错误；
• context字段若存在，必须是列表类型，且每个元素是含role和content键的字典，role只能是"user"或"assistant"，content不能为空字符串。
方法二：用curl命令行快速验证结构——把请求体保存为body.json，执行curl -X POST "https://metaso.cn/api/mcp" -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d "@body.json"。若仍报错，说明body.json本身有语法错误，用在线JSON校验器打开检查逗号、引号、括号是否闭合。
修复常见参数陷阱
第一步：确认你没有在请求体里传入前端界面才支持的字段，例如enable_citation、max_tokens、format等——这些是CLI或Web端参数，API接口不识别，传了就报格式错误。
第二步：检查布尔值是否用了字符串。比如includeSummary字段要求boolean类型，若写成"includeSummary": "true"（带引号）就会失败，必须写成"includeSummary": true（不带引号）。
第三步：检查数组类字段是否误传为单个对象。例如context字段必须是列表，即使只有一轮对话也要写成"context": [{"role": "user", "content": "你好"}]，写成"context": {"role": "user", "content": "你好"}会直接触发400错误。
第四步：打开秘塔开发者平台文档页，对照最新版API Schema，逐字段比对你的请求体字段名是否全部小写、是否有多余下划线或驼峰命名——API严格区分大小写与命名规范，字段名错一位即格式错误。
