必须绕过SDK直连HTTP接口调用秘塔AI搜索API；需配置OkHttp依赖、严格按规范构造请求体与请求头，并注意各接口的参数限制与使用约束。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Java项目中调用秘塔AI搜索API实现网页搜索、内容读取或智能问答，必须绕过SDK直连HTTP接口，因为当前spring-ai-alibaba的MCP集成尚未支持带鉴权的秘塔MCP服务。
准备API密钥与基础依赖
登录 https://www.php.cn/link/022e5a923458991fab6f695c0c4def33 → 进入「API管理」页面 → 创建应用并复制生成的 【YOUR_API_KEY】；该密钥需严格保密，不可硬编码进源码。
在 Maven 的 pom.xml 中添加 OkHttp 依赖（不推荐 HttpURLConnection：它默认不复用连接，高并发下易触发秘塔API限流）：
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
<version>4.12.0</version>
</dependency>
立即学习“Java免费学习笔记（深入）”；
调用 metaso_web_search 实现关键词搜索
第一步：构造 JSON 请求体，【q 字段为必填项，缺省将返回 400 错误】，scope 若不指定则默认全类型混合搜索：
{"q": "大模型推理优化技术", "scope": "paper", "size": 3}
第二步：设置请求头，Authorization 值必须为 Bearer YOUR_API_KEY，注意 Bearer 后有且仅有一个空格；若少写空格或写成 bearer 小写，秘塔后端直接拒绝并返回 401。
第三步：用 OkHttp 发起 POST 请求到 https://www.php.cn/link/022e5a923458991fab6f695c0c4def33api/mcp，路径末尾不能多加斜杠，否则 404。
调用 metaso_web_reader 提取网页正文
方法一：直接传 URL 和 format 参数
发送 POST 请求，Body 为：
{"url": "https://arxiv.org/abs/2406.12345", "format": "markdown"}
方法二：若目标网页含反爬 JS 渲染逻辑，metaso_web_reader 会返回空 content 或解析失败；此时应先用 headless 浏览器预渲染，再把静态 HTML 丢给秘塔——但注意，该工具不接受 HTML 字符串输入，只认原始 URL。
这一步操作起来很简单，直接把文件拖进去就行。
调用 metaso_chat 进行上下文问答
① 构造最小可用请求体：
{"message": "请对比 Mamba 和 RWKV 的状态空间建模差异"}
② 不要手动拼接 model 字段：默认 fast 模型已足够响应常规问题；若强行指定不存在的 model 名（如 "pro"），API 返回 422 且无错误提示，只会卡住等待超时。
③ 该接口不维护对话历史，每次请求都是独立会话；如需多轮，必须由 Java 端自行缓存上一轮 response.content 并拼入下一轮 message 开头。
