应使用curl或Python requests直接调用秘塔AI搜索API，通过健康检查接口验证连通性，再构造搜索请求确认功能正常，注意密钥前缀、IP白名单及HTTPS证书问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在本地开发环境快速验证秘塔AI搜索API能否正常调用、返回结构是否符合预期，又不想污染生产密钥或触发配额限制——但直接用curl发请求发现401，用Python跑示例代码却卡在“connection timeout”，根本没法确认是网络问题还是参数写错了。
准备测试环境与最小依赖
新建一个空目录，执行：python -m venv .venv && source .venv/bin/activate（Mac/Linux）或 .venv\Scripts\activate.bat（Windows）。
只安装最精简依赖：pip install requests python-dotenv。不要装metaso-sdk或任何封装库——它们会掩盖底层HTTP错误，而你此刻需要看清原始响应头和状态码。
创建.env文件，写入：METASO_API_KEY=sk-xxxMETASO_BASE_URL=https://api.metaso.cn/v1。【API_KEY必须以sk-开头，且不能带空格或换行；若用错前缀（如ak-），秘塔后端直接拒绝解析，返回400而非401】
用curl验证基础连通性
方法一：直连健康检查接口curl -X GET "$METASO_BASE_URL/health" -H "Authorization: Bearer $METASO_API_KEY"。成功返回{"status":"ok","version":"2026.09"}即说明域名、密钥格式、网络通路全部正常。
方法二：强制跳过SSL验证（仅限内网实验室）curl -k -X GET "$METASO_BASE_URL/health" -H "Authorization: Bearer $METASO_API_KEY"。若方法一失败但方法二成功，说明本地CA证书过期或代理劫持了HTTPS流量——这在高校实验室防火墙下极常见。
注意：不要用浏览器访问/health，浏览器会自动加Accept: text/html头，秘塔API只接受application/json，返回406错误。
构造真实搜索请求并解析响应
第一步：创建测试脚本test_search.py
第二步：粘贴以下代码（逐字核对，尤其注意引号和缩进）：
import os, requests, json<br>from dotenv import load_dotenv<br>load_dotenv()<br>url = f"{os.getenv('METASO_BASE_URL')}/search"<br>headers = {"Authorization": f"Bearer {os.getenv('METASO_API_KEY')}", "Content-Type": "application/json"}<br>data = {"query": "秘塔AI搜索 企业知识库 API接入", "top_k": 3}<br>res = requests.post(url, headers=headers, json=data, timeout=15)<br>print(f"Status: {res.status_code}")<br>if res.status_code == 200:<br> print(json.dumps(res.json(), indent=2, ensure_ascii=False))<br>else:<br> print(res.text)
第三步：执行python test_search.py。若返回Status: 200且输出含"results"字段，说明API已可投入功能测试；若卡住超15秒，检查实验室出口IP是否在秘塔控制台配置的白名单中——【未配置IP白名单时，企业版API默认拒绝所有非白名单IP请求，且不返回任何错误提示，只静默超时】。
