百度搜索
概述:可根据用户输入query搜索全网实时信息;
计费:每日免费额度为100次,支持按量后付费,默认优先抵扣免费资源,且每个账号每天最多使用100,000次;
如有更多调用需求请您联系我们进行开通。上限统计口径为免费+付费,费用详情请查看计费说明。
权限说明
调用本API,需使用API Key鉴权方式。Authorization的值为Bearer <API Key>。获取API Key流程,请查看授权。
请求参数
搜索输入;
array的长度需要是奇数, role必须是user-assistant-user交替,以user开始以user结束;在百度搜索时,仅支持单论输入,若传入多轮输入,则以用户传入最后的content为输入查询。
显示子属性
隐藏子属性
角色设定,可选值:
user:用户
assistant:模型
- 当content为文本时, 对应对话内容,说明:
1.1 不能为空
1.2 最后一个message对应的content不能为blank字符,如空格、"\n"、“\r”、“\f”等
使用的搜索引擎版本;
固定值:baidu_search_v2
单次搜索最大返回数量。
支持设置网页、视频搜索模态,网页top_k最大取值为50,视频top_k最大为10,默认值为:[{"type": "web","top_k": 20}
显示子属性
隐藏子属性
搜索资源类型。
可选值:
web:网页
video: 视频
指定模态最大返回个数
根据SearchFilter下的子条件做检索过滤,使用方式详见后文;
显示子属性
隐藏子属性
条件查询
显示子属性
隐藏子属性
支持设置指定站点的搜索条件,即仅在设置的站点中进行内容搜索。目前仅支持设置5个站点。
范围查询,更多内容可查看范围查询详情
显示子属性
隐藏子属性
假设下述的now时间是2024-07-16
显示子属性
隐藏子属性
时间查询参数,值为"now-1d/d",表示含义:大于2024-07-15 00:00:00,包含2024-07-15完整天
时间查询参数,值为"now-1d/d",表示含义:大于2024-07-15 23:59:59,不包含2024-07-15完整天
时间查询参数,值为"now-1d/d",表示含义:小于2024-07-15 23:59:00,包含2024-07-15完整天
时间查询参数,值为"now-1d/d",表示含义:小于2024-07-15 00:00:00,不包含2024-07-15完整天
根据网页发布时间进行筛选;
枚举值:
week:最近7天
month:最近30天
semiyear:最近180天
year:最近365天
支持设置基于站点的过滤条件,对搜索到的结果按指定站点进行筛选,仅返回来自所设站点的内容。例如:设置["baidu.com"],在搜索到的结果中仅返回来自 baidu.com 的搜索结果。
```
POST /v2/ai_search/chat/completions HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <AppBuilder API Key>
Content-Type: application/json
{
"messages": [
{
"content": "北京有哪些旅游景区",
"role": "user"
}
],
"search_source": "baidu_search_v2",
"resource_type_filter": [{"type": "web","top_k": 10}],
"search_filter": {
"match": {
"site": [
"www.weather.com.cn"
]
}
},
"search_recency_filter": "year"
}
```
示例代码
curl --location 'https://qianfan.baidubce.com/v2/ai_search/chat/completions' \
--header 'X-Appbuilder-Authorization: Bearer <AppBuilder API Key>' \
--header 'Content-Type: application/json' \
--data '{
"messages": [
{
"content": "河北各个城市最近的天气",
"role": "user"
}
],
"search_source": "baidu_search_v2",
"resource_type_filter": [{"type": "web","top_k": 20}],
"search_filter": {
"match": {
"site": [
"www.weather.com.cn"
]
}
},
"search_recency_filter": "year"
}'
返回响应
请求request_id
错误代码,当发生异常时返回
错误代码,当发生异常时返回
模型回答参考引用内容
显示子属性
隐藏子属性
站点图标
引用编号1、2、3
网页标题
网页地址
网站锚文本或网站标题
网站内容
网页日期
检索资源类型:
web:网页
image:图像内容
video:视频内容
图片详情
显示子属性
隐藏子属性
图片链接
图片高度
图片宽度
视频详情
显示子属性
隐藏子属性
视频链接
视频高度
视频宽度
视频大小,单位Bytes
视频长度,单位秒
视频封面图
```
{
"references": [
{
"content": "河北天气预报,及时准确发布中央气象台天气信息,便捷查询河北今日天气\u0004,河北周末天气,河北一周天气预报,河北蓝天预报,河北天气预报,河北40日天气预报,还\u0005提供河北的生活指数、健康指数、交通...",
"date": "2025-04-27 18:02:00",
"icon": null,
"id": 1,
"image": null,
"title": "【河北天气】河北天气预报,蓝天,蓝天预报,雾霾,雾霾...",
"type": "web",
"url": "https://www.weather.com.cn/html/weather/101031600.shtml",
"video": null,
"web_anchor": "【河北天气】河北天气预报,蓝天,蓝天预报,雾霾,雾霾..."
},
{
"content": "保定天气预报,及时准确发布中央气象台天气信息,便捷查询保定今日天气,保定周末天气,保定一周天气预报,保定蓝天预报,保定天气预报,保定40日天气预报,还提供保定的生活指数、健康指数、交通...",
"date": "2025-05-20 11:58:00",
"icon": null,
"id": 2,
"image": null,
"title": "保定天气预报,保定7天天气预报,保定15天天气预报,保定...",
"type": "web",
"url": "https://www.weather.com.cn/weather/101090201.shtml",
"video": null,
"web_anchor": "保定天气预报,保定7天天气预报,保定15天天气预报,保定..."
},
{
"content": "河北省气象台2025年05月23日11时发布天气预报: 今天下午到夜间,保定西部、石家庄西部、邢台西部阴有小雨或零星小雨转晴,其他地区阴转晴。最高气温,张家口、承德北部、保定西北部13~17...",
"date": "2025-05-23 00:00:00",
"icon": null,
"id": 3,
"image": null,
"title": "今天西部部分地区仍有降水 其它地区阴转晴-河北首页...",
"type": "web",
"url": "http://hebei.weather.com.cn/tqxs/4190923_m.shtml",
"video": null,
"web_anchor": "今天西部部分地区仍有降水 其它地区阴转晴-河北首页..."
},
{
"content": "河北省气象台2025年05月22日05时发布天气预报 今天白天,保定、廊坊及以北地区阴有小雨或阵雨,其中张家口、保定西北部有中到大雨;其他地区多云转阴有小雨或阵雨,其中邯郸大部有中雨。...",
"date": "2025-05-22 09:07:22",
"icon": null,
"id": 4,
"image": null,
"title": "今天白天到夜间,我省大部分地区有降水-河北首页-中国...",
"type": "web",
"url": "http://hebei.weather.com.cn/tqxs/4189523_m.shtml",
"video": null,
"web_anchor": "今天白天到夜间,我省大部分地区有降水-河北首页-中国..."
}
],
"request_id": "ca749cb1-26db-4ff6-9735-f7b472d59003"
}
```
```
{
"requestId": "00000000-0000-0000-0000-000000000000",
"code": 216003,
"message": "Authentication error: ( [Code: InvalidHTTPAuthHeader; Message: Fail to parse apikey authorization; RequestId: ea6ffeca-a136-401b-ba30-61c910c02ead] )"
}
```
错误码 | 描述 |
---|---|
400 | 客户端请求参数错误 |
500 | 服务端执行错误 |
501 | 调用模型服务超时 |
502 | 模型流式输出超时 |
其它 | 详见模型返回错误码 https://cloud.baidu.com/doc/WENXINWORKSHOP/s/tlmyncueh |