AI 联网搜索

接口标识: websearch 价格: 0.15 元/次 VIP免费

接口介绍
接口文档
在线测试

接口简介

AI 联网搜索接口，基于阿里云百炼官方搜索 MCP，为大模型与应用提供实时联网检索能力。支持标准档（standard）与增强档（pro，大模型优化+多数据源融合）两种深度，用 depth 参数切换。输入搜索问题 query，返回标题、原文链接、摘要片段与来源站点名，可指定返回条数。适用于 AI 问答联网增强、实时资讯检索、RAG 召回、热点查证等场景。

详细介绍

## 接口介绍

AI 联网搜索接口基于阿里云百炼官方搜索 MCP，为大模型与应用提供实时联网检索能力。支持标准档（standard，走 WebSearch）与增强档（pro，走 EnhancedSearch，官方「大模型优化 + 多数据源融合的增强搜索」）两种深度，用 `depth` 参数切换。

## 使用场景

- **AI 问答联网增强**：为大模型补充实时网络信息，减少幻觉
- **RAG 召回**：检索相关网页作为知识库召回源
- **实时资讯检索**：查询热点事件、最新进展
- **事实查证**：核对时效性强的信息

## 使用教程

### 1. 发起请求

向 `/api/websearch` 发送 POST 请求：

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| query | string | 是 | 搜索问题，非空，最多 500 字 |
| count | int | 否 | 返回结果条数，默认 5，上限 20 |
| depth | string | 否 | standard（标准档，默认）/ pro（增强档，大模型优化+多数据源融合） |

### 2. 响应示例

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "total": 3,
    "depth": "standard",
    "results": [
      {"title": "示例标题", "url": "https://example.com/a", "snippet": "摘要片段……", "site_name": "示例站点", "published_time": ""}
    ]
  },
  "request_id": "a1b2c3d4e5f6"
}
```

### 3. 响应字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| total | int | 实际返回的结果条数 |
| results | array | 搜索结果数组 |
| results[].title | string | 结果标题 |
| results[].url | string | 结果原文链接 |
| results[].snippet | string | 摘要片段 |
| results[].site_name | string | 来源站点名（上游未返回时置空） |
| results[].published_time | string | 发布时间（上游未提供时为空） |
| depth | string | 本次实际使用的搜索档位，便于计费核对 |

### 4. 错误码

| code | 说明 |
|------|------|
| 0 | 请求成功（无结果时 total=0） |
| 40002 | 参数错误（query 缺失/超长、depth 非法） |
| 40101 | 鉴权失败 |
| 50001 | 上游搜索服务调用失败 |

## 注意事项

- 标准档 0.029 元/次、增强档 0.03 元/次，本站统一计费单价 0.15 元/次，两档同价。
- 上游平均耗时约 2 秒，是站内较慢的同步接口之一，请合理设置客户端超时。
- 上游未提供发布时间字段时 published_time 置空，本站不编造时间。
- 搜索结果与内容版权归第三方站点，本站仅返回公开检索结果链接。

接口地址： https://www.phpwc.cn/api/websearch

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`query`	string	必填	-	搜索问题，非空，最多 500 字
`count`	int	选填	`5`	返回结果条数，默认 5，上限 20
`depth`	string	选填	`standard`	搜索档位：standard（标准档，默认）/ pro（增强档，大模型优化+多数据源融合）

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`total`	int	实际返回的结果条数
`depth`	string	本次实际使用的搜索档位
`results`−	array	搜索结果数组
`title`	string	结果标题
`url`	string	结果原文链接
`snippet`	string	摘要片段
`site_name`	string	来源站点名（上游未返回时置空）
`published_time`	string	发布时间（上游未提供时为空）
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试