智能搜索生成
概述:可根据用户输入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”等
2. 当content为数组时,如果只传入ImageContentBlock对象,则对图片内容进行理解
3. 当content为数组时,如果同时传入ImageContentBlock对象、TextContentBlock对象
TextContentBlock中包括对图片内容的提问,目前仅支持传入一个图片
以下分别为纯文本问答、纯图内容理解、图文多模理解场景下,content参数的示例值:
# 1. 纯文本问答
"今天最新新闻"。
# 2. 纯图内容理解
[{
"type": "image_url",
"image_url"{
"url":"https://img0.baidu.com/it/u=589029460,3453668126&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=599"
}
}
]
# 3. 图文多模理解场景下
[{
"type": "text",
"text": "图中的食物怎么做"
},
{
"type": "image_url",
"image_url": {
"url":"https://pic.rmb.bdstatic.com/bjh/240306/events/6eb350bfb9a7c34bf73907507676075b256.jpeg@h_1280"
}
}]
显示子属性
隐藏子属性
显示子属性
隐藏子属性
值固定为text
文本内容
显示子属性
隐藏子属性
图片地址,支持图片格式包括jpeg、 jpg、 png、 webp
显示子属性
隐藏子属性
图片可下载url地址或base64编码后的图片内容
值固定为image_url
使用的搜索引擎版本;
可选值:baidu_search_v1、baidu_search_v2
智能搜索生成时均可输入,兼容性考虑默认为baidu_search_v1
V2相比于V1:提升了性能表现,提升了数据内容的丰富度,更适用于结合大模型使用的场景,建议默认使用V2。
根据SearchFilter下的子条件做检索过滤,使用方式详见后文;
仅search_source为baidu_search_v2时生效
显示子属性
隐藏子属性
条件查询
显示子属性
隐藏子属性
支持设置指定站点的搜索条件,即仅在设置的站点中进行内容搜索。目前仅支持设置一个站点。
范围查询,更多内容可查看范围查询详情
显示子属性
隐藏子属性
假设下述的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 的搜索结果。
显示子属性
隐藏子属性
人设指令,用于设定输出风格等。
默认值:""
注意:字符长度需要小于等于4000
模型采样参数。较高的数值会使输出更加随机,而较低的数值会使其更加集中和确定。
值范围:(0, 1]
默认值:1e-10
注意:该值越大,模型输出越多样,也越不稳定
模型采样参数。
影响输出文本的多样性,取值越大,生成文本的多样性越强。
值范围:(0, 1]
默认值:1e-10
注意:该值越大,模型输出越多样,也越不稳定
面向高阶用户开放自定义prompt模版,普通用户不需要设置,支持添加的变量包括:
query:经过改写等处理后的query
original_query:用户原始query
history:对话历史
context_out:搜索结果(如果传入个性化知识,则是个性化知识 + 搜索结果)
instruction:人设
time:当前时间
其中变量query或original_query(至少一个)、context_out必须出现在prompt_template中,其他变量可选。
样例:"搜索结果:
{{context_out}}
用户query:
{{query}} "。
控制是否进行智能联网搜索。默认为 auto。
可选值:
auto:自动判断是否需要搜索
required: 必须执行搜索
disabled: 禁用搜索功能仅模型回答
是否开启深度思考,仅对DeepSeek-R1、文心X1模型生效,开启后,在总结前会进行模型推理和思考并输出相关内容。
默认值:默认值:true
可选值:
true:开启
false:不开启
是否开启深搜索。
- 深搜索会产生10次以内的智能搜索生成服务调用
默认值:false
可选值:
true:开启,每种搜索类型最多返回100个搜索结果。
false:不开启,每种搜索类型最多返回10个搜索结果。
调用方提供的定制化知识内容集合,与公开的联网搜索结果构成合集,注入到模型中进行问答总结。知识注入的条数和长度, 与模型有关,限制最大10条。
可以配合 priority(优先级参数)使用,让本地搜索结果在能回答问题时优先被采用。当前支持三个优先级:-1、0、1,数值越小优先级越高,回答时会优先选择高优先级的内容。其中,百度搜索结果的优先级为 0。
显示子属性
隐藏子属性
搜索结果的优先级: 数字值越小,优先级越高。
取值范围【-1,1】
默认值为0;
举例:
-1是优先级最高,如果与百度搜索结果优先级相同,优先使用定制化知识点,默认值为0
数据类型
数据对象
显示子属性
隐藏子属性
知识点内容
知识点标题
知识点url地址
发布日期
默认2048,不同模型支持的最大输出token不一样,具体参考:https://cloud.baidu.com/doc/WENXINWORKSHOP/s/Fm2vrveyu#支持模型列表
输出内容样式。默认值 auto。可选值:
auto:智能判断是纯文本输出还是图文混排输出。
text:文本输出。
rich_text: 图文混排输出。如:在美食和旅游两个场景下,输出文本中嵌入markdown语法的图片内容。 比如: ...北京美食包括北京烤鸭等。
选择rich_text时推荐使用ernie-4.0-turbo-128k、ernie-4.0-turbo-8k模型
用于设置在最后生成的总结内容正文时,是否返回角标用于标记模型输出内容的参考来源。
值含义:
true:开启角标
false:隐藏角标
默认值:true
针对用户问题和大模型回答结果,给出推荐的追问。
默认为false
可选值:true: 开启追问
false:不开启追问
是否为流式请求。
值含义:
true:使用HTTP SSE流式响应
false:以非流式结果返回
默认值为false;
安全等级,可选值包括:
standard:默认安全等级
strict:严格安全等级
调节用于模型问答总结的最大搜索条数,默认是全部搜索结果。
指定使用该配置id下的领域知识注入、网页黑名单、问答干预策略等配置
模型调用appid
当开启深度搜索时,用于搜索的最大子query个数,默认为10
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"
}
],
"stream": false,
"model": "ernie-3.5-8k",
"instruction": "##",
"enable_corner_markers": true,
"enable_deep_search": true
}
示例代码
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_v1",
"resource_type_filter": [
{"type": "image","top_k": 4},
{"type": "video","top_k": 4},
{"type": "web","top_k": 4}
],
"search_recency_filter": "year",
"stream": false,
"model": "ernie-3.5-8k",
"enable_deep_search": false,
"enable_followup_query": false,
"temperature": 0.11,
"top_p": 0.55,
"search_mode": "auto",
"enable_reasoning": true
}'
返回响应
请求request_id
错误代码,当发生异常时返回 message string 否
错误代码,当发生异常时返回
模型生成的 completion 的选择列表
显示子属性
隐藏子属性
模型停止生成token的原因。
可选值:
stop: 模型自然停止生成
length: 输出长度达到了模型上下文长度限制
该completion在选择列表中的索引
非流式模型生成的completion消息
显示子属性
隐藏子属性
completion内容
仅适用于 deepseek思考系列模型。
内容为 assistant 消息中在最终答案之前的推理内容
固定值assistant
流式返回的completion增量
显示子属性
隐藏子属性
completion内容
仅适用于 deepseek思考系列模型。
内容为 assistant 消息中在最终答案之前的推理内容
固定值assistant
oken开销
显示子属性
隐藏子属性
prompt(输入)token数
completion(输出)token数
总token数
query是否安全
模型回答参考引用内容
显示子属性
隐藏子属性
站点图标
引用编号1、2、3
网页标题
网页地址
网站锚文本或网站标题
网站内容
网页日期
检索资源类型:
web:网页
image:图像内容
video:视频内容
图片详情
显示子属性
隐藏子属性
图片链接
图片高度
图片宽度
视频详情
显示子属性
隐藏子属性
视频链接
视频高度
视频宽度
视频大小,单位Bytes
视频长度,单位秒
视频封面图
追问问题
显示子属性
隐藏子属性
{
"choices": [
{
"finish_reason": "stop",
"index": 0,
"message": {
"content": "北京的景点非常丰富,其中包括:\n1. 故宫博物院(紫禁城):是世界上现存规模最大、保存最为完整的木质结构古建筑群之一,也是明清两代的皇家宫殿。\n2. 八达岭长城:是万里长城的重要组成部分,也是明长城的一个隘口,雄伟壮观,历史底蕴深厚。\n3. 颐和园:是清朝时期的皇家园林,以昆明湖、万寿山为基址,以杭州西湖为蓝本,汲取江南园林的设计手法而建成的一座大型山水园林,被誉为“皇家园林博物馆”。\n4. 北京天安门广场:是世界最大的城市广场,见证了许多重大历史时刻。\n5. 天坛公园:是明清皇帝祭天的地方,建筑独特,寓意“天圆地方”。\n6. 圆明园:是清代大型皇家园林,虽遭破坏,但仍能感受到昔日的辉煌与沧桑。\n7. 香山公园:是北京西郊的山林公园,景色秀丽,秋季红叶更是美不胜收。\n8. 恭王府:是规模宏大的王府建筑群,建筑精美。\n9. 什刹海:包括前海、后海等,有老北京的韵味,可乘船赏景。\n10. 奥林匹克公园:体现了“科技、绿色、人文”的理念,有鸟巢、水立方等标志性建筑。\n\n除了这些,北京还有许多其他值得一游的景点,如法海寺、龙庆峡、古北水镇、红螺寺等。",
"role": "assistant"
}
}
],
"is_safe": true,
"references": [
{
"content": "1. 故宫(紫禁城)地址:东城区景山前街4号。门票:60元(旺季)/40元(淡季)开放时间:8:30-17:00(周一闭馆)。 为什么必去?故宫是世界现存最大、最完整的木质结构古建筑群,600年明清皇家历史的见证者,每一砖一瓦都藏着故事。必玩体验:中轴线游览(太和殿、乾清宫、御花园)感受皇家气派。打卡网红角落:延禧宫的西洋楼、红墙拍照(建议穿汉服)。珍宝馆+钟表馆(另收费),...",
"date": "2025-4-24",
"icon": "https://pic.rmb.bdstatic.com/bjh/user/f1c77bf4fc9f3651df29e52acde36e94.jpeg",
"id": 1,
"image": null,
"title": "北京必玩景点TOP10|2025最新攻略,带你玩转帝都!",
"type": "web",
"url": "https://baijiahao.baidu.com/s?id=1830291819430711070&wfr=spider&for=pc",
"video": null,
"web_anchor": "老六爱玩"
},
{
"content": "北京景点攻略 如果你是第一次去北京旅游可要千万要收藏好了",
"date": "2024-06-01 03:18",
"icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
"id": 2,
"image": {
"height": "674",
"url": "http://img0.baidu.com/it/u=1145656209,2145532403&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=674",
"width": "500"
},
"title": "北京景点攻略 如果你是第一次去北京旅游可要千万要收藏好了",
"type": "image",
"url": "http://mbd.baidu.com/newspage/data/dtlandingsuper?nid=dt_5388334462984511033",
"video": null,
"web_anchor": "全网资源"
},
{
"content": "哪些北京京郊的景点 外地同学值得自驾车去 跟着UP主出行看世界 /生活/出行/北京旅游避坑指南/北京去哪玩好/干货实用攻略/自驾游北京攻略/亲子游/周边游/周末去哪玩/北京旅游攻略/保姆级攻略 哪些北京京郊景点值得外地同学自驾车去 北京公义 大八山面 北京京郊大部分景点都在六环外 办理六环外的进京证就行 当然您要办理六环内的更好一些 下面就给您推荐一些京郊自驾游 外地同学值得去的景点(北京同学也值...",
"date": "2025-5-23",
"icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/bilibili.ico",
"id": 3,
"image": null,
"title": "哪些北京京郊的景点 外地同学值得自驾车去",
"type": "web",
"url": "https://www.bilibili.com/video/BV1hE421K7K1",
"video": null,
"web_anchor": "哔哩哔哩"
},
{
"content": "北京旅游必去的十大景点推荐",
"date": "2024-06-19 13:00",
"icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
"id": 4,
"image": {
"height": "1067",
"url": "http://img2.baidu.com/it/u=80406124,3208002747&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1067",
"width": "800"
},
"title": "北京旅游必去的十大景点推荐",
"type": "image",
"url": "http://www.douyin.com/note/7382074689126010131",
"video": null,
"web_anchor": "全网资源"
},
{
"content": "北京景区排名必玩十大景点?有世界最大城市广场,有大型皇家园林 北京景区排名必玩十大景点?有世界最大城市广场,有大型皇家园林 北京景区 城市广场 旅游攻略 旅游资讯 皇家园林 北京有很多值得一去的景点推荐10个:1.故宫: 位于北京中心明清皇宫建筑辉煌藏品丰富 尽显皇家风范 2.颐和园 清朝皇家园林有山有水融合江南园林风格 风景如画 3.八达岭长城:在延庆万里长城重要部分 雄伟壮观历史底蕴深厚 4....",
"date": "2025-5-22",
"icon": "https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=76251347,1123177279&fm=195&app=88&f=PNG?w=200&h=200",
"id": 5,
"image": null,
"title": "北京景区排名必玩十大景点?有世界最大城市广场,有大型...",
"type": "web",
"url": "https://haokan.baidu.com/v?pd=wisenatural&vid=14103857872992752240",
"video": null,
"web_anchor": "好看视频"
},
{
"content": "北京必去十大景点 新手必看‼️附旅游攻略.熬夜整理出来的必打",
"date": "2024-06-15 20:25",
"icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
"id": 6,
"image": {
"height": "1342",
"url": "http://img1.baidu.com/it/u=17130128,3218194790&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1342",
"width": "800"
},
"title": "北京必去十大景点 新手必看‼附旅游攻略.熬夜整理出来的必打",
"type": "image",
"url": "http://www.douyin.com/note/7380319151006436646",
"video": null,
"web_anchor": "全网资源"
},
{
"content": "揭秘!北京好玩的十大景点排行榜,你去过几个?北京,这座古老又现代的城市,藏着无数好玩的地方。想知道哪些景点能跻身北京好玩的地方排行榜前十名吗?接下来,我们就为你揭开谜底,带你领略京城最值得一去的精华景点,让你的北京之行不留遗憾。1. 故宫博物院 故宫,旧称紫禁城,是中国明清两代的皇家宫殿,也是世界上现存规模最大、保存最为完整的木质结构古建筑群之一。走进故宫,仿佛穿越回了古代,红墙黄瓦、飞檐斗拱,处...",
"date": "2025-5-4",
"icon": "https://pic.rmb.bdstatic.com/bjh/user/84f5641182eb2b574909828a3fa8f9b0.jpeg",
"id": 7,
"image": null,
"title": "揭秘!北京好玩的十大景点排行榜,你去过几个?",
"type": "web",
"url": "https://baijiahao.baidu.com/s?id=1830726637146162329&wfr=spider&for=pc",
"video": null,
"web_anchor": "炫拍客旅途志"
},
{
"content": "北京必去十大景点新手必看.亲亲记滴点赞收藏! 1 no.1",
"date": "2024-08-17 11:00",
"icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
"id": 8,
"image": {
"height": "1067",
"url": "http://img0.baidu.com/it/u=3343386837,4291065808&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1067",
"width": "800"
},
"title": "北京必去十大景点新手必看.亲亲记滴点赞收藏! 1 no.1",
"type": "image",
"url": "http://www.douyin.com/note/7403937889005882650",
"video": null,
"web_anchor": "全网资源"
}
],
"request_id": "ad524989-be46-48fd-b2ec-344683b28305",
"usage": {
"completion_tokens": 295,
"prompt_tokens": 1919,
"total_tokens": 2214
}
}
{
"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 |