用Postman调试秘塔AI搜索API需先获取API_KEY与BASE_URL并正确配置请求头，否则返回401或404；上传文档须选form-data或JSON远程URL方式，且知识库必须active；搜索时search_range填错将静默返回空数组。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用Postman调试秘塔AI搜索API，必须先获取合法凭证并构造符合签名规范的请求头，否则会返回401错误且不提示具体原因。
获取API_KEY与BASE_URL
登录秘塔开发者平台（https://developer.metaso.cn），进入「我的应用」→点击「创建应用」→填写名称后提交。系统自动生成API_KEY和BASE_URL（形如https://api.metaso.cn/v1）。【API_KEY必须通过环境变量注入，禁止硬编码在Postman的请求体或预请求脚本中】
复制API_KEY时注意末尾无空格；BASE_URL末尾不能带斜杠，否则后续所有接口调用都会报404。
配置Postman请求头
新建一个POST请求，在Headers标签页中添加两行：
Authorization → Bearer YOUR_API_KEY（将YOUR_API_KEY替换成上一步复制的真实密钥）
Content-Type → multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
这一步漏掉Authorization，Postman会直接返回{"code":401,"message":"Unauthorized"}，连错误详情都不会展开——不是接口问题，是认证没过。
上传文档调试（/document/upload）
方法一：使用Body → form-data模式
key填file，type选File，点击Select File选择本地PDF；再新增一行key为kb_id，value填你已创建的知识库ID（如kb_xxx123）；第三行key为filename，value填原始文件名（如report.pdf）。
方法二：用raw + JSON（仅限远程URL拉取）
切换Body为raw → JSON，输入：{"kb_id":"kb_xxx123","url":"https://example.com/doc.pdf"}。注意：此方式不支持本地文件，且url必须可被秘塔服务器直连访问，内网地址或需鉴权的链接会失败。
【上传前务必确认知识库已存在且状态为active，否则返回500错误但提示语是“Internal Server Error”，实际是kb_id无效】
发起搜索请求调试（/search）
第一步：设置请求URL为{{base_url}}/search
第二步：Headers中确保Authorization和Content-Type已正确配置
第三步：Body → raw → JSON，粘贴如下结构：
{"query":"量子计算最新进展","search_range":"academic","max_results":5}
其中search_range可选值为all（全网）、academic（学术）、wenku（文库）、podcast（播客），填错任意一个会导致整个请求被静默丢弃，响应为空数组且HTTP状态码仍是200。
第四步：点击Send，查看Response面板中的JSON结果。若看到data字段含多个item且每个item有title、url、snippet，则调试成功。
