调用秘塔AI搜索API需严格配置请求头：Authorization为Bearer+空格+API Key（大小写及空格敏感）；Content-Type按JSON或文件上传选application/json或multipart/form-data；IP白名单需配X-Client-IP；敏感接口建议加UUID格式X-Request-ID；调试可启用X-Debug，模型版本可指定X-Model-Version。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用秘塔AI搜索API时，请求头字段配置错误会导致401未授权或403禁止访问，必须严格按官方要求设置，不能遗漏或拼写错误。
基础认证字段
Authorization字段是唯一必需的认证头，值为Bearer后接空格再加你的API Key。注意Bearer首字母大写、中间有空格、末尾无换行或空格——【少一个空格或大小写错误都会返回401】。
Content-Type字段根据请求体格式选择：POST提交JSON数据时设为application/json；上传文件时必须改为multipart/form-data，且不能手动设置boundary，由客户端库自动生成。
企业级安全增强字段
若API Key已绑定IP白名单，需在请求头中显式添加X-Client-IP字段，值为你发起请求的真实公网IP地址。该IP必须与控制台配置的白名单完全一致，不支持CIDR网段匹配。
当调用/knowledge_base/create等敏感接口时，建议额外添加X-Request-ID字段，值为UUID v4格式字符串（如550e8400-e29b-41d4-a716-446655440000）。该字段用于审计日志追踪，缺失时企业版后台将标记为“匿名高危操作”。
开发者调试字段
方法一：启用详细错误定位
添加X-Debug字段并设为true，响应体中会包含具体失败原因（如“API_KEY格式非法”“IP不在白名单”），但仅限测试环境使用，生产环境禁用。
方法二：强制指定模型版本
对metaso_chat接口，可添加X-Model-Version字段，值为fast、balanced或precise。不加此头时默认走fast，但某些企业策略可能覆盖该默认值，显式声明可避免意外降级。
这一步操作起来很简单，直接把字段写进headers字典就行。
