#16. API（开发者接口）

秘塔AI搜索面向开发者开放了搜索、网页解析、问答三大接口能力，可以将秘塔的 搜索与推理能力直接接入自己的产品或工作流中，并已原生支持 MCP 协议， 方便与 Claude、Cursor 等支持 MCP 的AI客户端直接对接。

提示：这部分面向有编程基础的开发者，普通用户日常使用秘塔AI搜索 网页/App即可，无需关注本节内容。

#入口位置

点击首页对话框上方快捷入口栏的「API」按钮（位于"事实核验"和"···更多" 之间）即可进入开发者控制台，控制台内分为「实验室」「信息统计」「API Keys」 三个标签页。

#实验室：三大接口能力

「实验室」标签页可以直接在网页上填写参数、在线调试并获取真实调用结果， 每种接口都会同步生成对应的 cURL 代码，方便直接复制到自己的项目中。

1. 搜索接口 /api/v1/search（POST）

根据问题或关键词，返回网页等数据源的实时搜索结果。可配置参数包括：

• q（查询）：搜索的问题或关键词
• scope（搜索范围）：如"网页"
• size（结果数量）：如10条
• page（页码）
• 「返回精简的原文匹配信息」「通过网页的摘要信息进行召回增强」 「抓取所有来源网页原文」等开关选项，可按需开启

调用示例：

curl --location 'https://metaso.cn/api/v1/search' \
--header 'Authorization: Bearer mk-你的APIKey' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"q":"谁是这个世界上最美丽的女人","scope":"webpage","includeSummary":false,"size":"10"}'

2. 读取网页接口 /api/v1/reader（POST）

根据输入的网址，抓取对应网页的全文信息，以Markdown格式返回，适合把网页 内容清洗成干净的文本供大模型进一步处理。可配置参数：

• url：需要抓取的网页地址
• format（返回格式）：如"Markdown"

调用示例：

curl --location 'https://metaso.cn/api/v1/reader' \
--header 'Authorization: Bearer mk-你的APIKey' \
--header 'Accept: text/plain' \
--header 'Content-Type: application/json' \
--data '{"url":"https://www.163.com/news/article/K56809DQ000189FH.html"}'

3. 问答接口 /api/v1/chat/completions（POST）

根据查询的问题，直接返回AI整合后的解答，接口格式风格与OpenAI的 chat/completions 类似，便于已有代码快速迁移接入。可配置参数：

• q（查询）/ messages（对话消息）
• scope（搜索范围）：如"网页"
• model（模型）：如"极速"（fast），也可切换为其他档位模型
• stream（开启流式输出）：开启后可实现打字机式逐字返回
• 「返回精简的原文匹配信息」等开关选项

调用示例：

curl --location 'https://metaso.cn/api/v1/chat/completions' \
--header 'Authorization: Bearer mk-你的APIKey' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"model":"fast","stream":true,"messages":[{"role":"user","content":"谁是这个世界上最美丽的女人"}]}'

#认证方式

三个接口均通过HTTP请求头中的 Authorization: Bearer <你的API Key> 进行身份验证，请求体统一为JSON格式。

#信息统计：用量与限额

「信息统计」标签页可以查看：

• 剩余积分：当前账户可用的调用额度（点），点击「充值」可购买更多积分
• 速度限额：接口调用频率上限（如200/QPM，即每分钟最多200次请求）
• 用量图表：可按"积分/一周内/所有接口类型/所有Keys"等维度筛选， 以柱状图形式查看历史调用量走势，帮助排查异常消耗

#API Keys：密钥管理

「API Keys」标签页用于管理调用密钥：

• 默认会有一个名为"Default"的密钥，密钥内容默认隐藏显示为圆点，可点击 眼睛图标查看、点击复制图标一键复制
• 支持点击「创建新的Key」新增多个密钥，便于给不同项目分别授权、单独统计 用量
• 每个密钥支持「重置」（刷新生成新密钥）和「删除」操作
• 官网特别提示："请妥善保存，防止泄露，请勿在浏览器或其他客户端代码中 公开该密钥"，建议将密钥保存在服务端环境变量中，避免暴露在前端代码里

#适用场景

• 将秘塔的实时搜索能力集成进自己开发的AI应用、浏览器插件或工作流机器人
• 批量抓取网页正文，用于知识库构建、RAG（检索增强生成）系统的数据源
• 在Claude、Cursor等支持MCP协议的AI客户端中，直接把秘塔搜索接入作为 外部工具调用
• 用OpenAI兼容的chat/completions接口风格，快速把秘塔AI搜索接入已有的 聊天类项目中，替代或补充其他搜索引擎接口