智能搜索生成
概述:可根据用户输入query搜索全网实时信息后,并进行智能总结回答。
计费:每日免费额度为100次,支持按量后付费(为不影响使用体验,可先去开通后付费),默认优先抵扣免费资源。智能搜索生成的免费额度以及总调用上限,与百度搜索共享,且每个账号每天最多使用100,000次,如有更多调用需求请您联系我们进行开通,费用详情请查看计费说明。
使用方式:API、组件、MCP、SDK
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
搜索输入;
array的长度需要是奇数, role必须是user-assistant-user交替,以user开始以user结束;在百度搜索时,仅支持单论输入,若传入多轮输入,则以用户传入最后的content为输入查询。
显示子属性
隐藏子属性
角色设定,可选值:
user:用户
assistant:模型
- 当content为文本时, 对应对话内容,说明:
1.1 不能为空
1.2 最后一个message对应的content不能为blank字符,如空格、"\n"、“\r”、“\f”等
使用的搜索引擎版本;
可选值:baidu_search_v1、baidu_search_v2
智能搜索生成时均可输入,兼容性考虑默认为baidu_search_v1
V2相比于V1:提升了性能表现,提升了数据内容的丰富度,更适用于结合大模型使用的场景,建议默认使用V2。
单次搜索最大返回数量。
search_source为baidu_search_v1时:
默认为返回网页top 10搜索结果,{"type": "web","top_k": 10}],每种搜索类型支持返回的数量范围为:1~10
示例:
[{"type": "image","top_k": 4},
{"type": "video","top_k": 4},
{"type": "web","top_k": 4}]
当search_source为baidu_search_v2时:
仅支持设置网页、视频搜索模态,top_k最大取值为20.
[{"type": "web","top_k": 4},
{"type": "video","top_k": 4}]
特别的,如需单次返回更多链接,可在智能搜索生成中开启深度搜索
显示子属性
隐藏子属性
搜索资源类型。
baidu_search_v1时,可选值:
video: 视频
image: 图片
web:网页
baidu_search_v2时,可选值:
video: 视频
web:网页
指定模态最大返回个数
根据网页发布时间进行筛选;
枚举值:
week:最近7天
month:最近30天
semiyear:最近180天
year:最近365天
根据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完整天
使用的模型名。不传模型名称时,搜索模式为百度搜索,传入模型名称时则为智能搜索生成。
目前支持千帆官网开通的模型,详细列表内容见模型列表
常见模型选项如下:
1. ernie-3.5-8k等
2. ernie-4.0-turbo-8k(支持图文混排场景)
3. ernie-4.0-turbo-128k(支持图文混排场景)
4. ernie-4.0-8k-preview
5. deepseek-r1
6. deepseek-v3
7. ernie-4.5-turbo-32k
8. ernie-4.5-turbo-128k
模型调用appid
人设指令,用于设定输出风格等。
默认值:""
注意:字符长度需要小于等于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个搜索结果。
当开启深度搜索时,用于搜索的最大子query个数,默认为10
调用方提供的定制化知识内容集合,与公开的联网搜索结果构成合集,注入到模型中进行问答总结。知识注入的条数和长度, 与模型有关,限制最大10条。
可以配合 priority(优先级参数)使用,让本地搜索结果在能回答问题时优先被采用。当前支持三个优先级:-1、0、1,数值越小优先级越高,回答时会优先选择高优先级的内容。其中,百度搜索结果的优先级为 0。
显示子属性
隐藏子属性
搜索结果的优先级: 数字值越小,优先级越高。
取值范围【-1,1】
默认值为0;
举例:
-1是优先级最高,如果与百度搜索结果优先级相同,优先使用定制化知识点,默认值为0
数据类型
数据对象
显示子属性
隐藏子属性
知识点内容
知识点标题
知识点url地址
发布日期
query安全检查等级,可选值包括:standard、strict,默认为standard
standard:标准安全等级
strict:严格安全等级
是否开启网页安全检查,默认为true
输出内容样式。默认值 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;
指定使用该配置id下的领域知识注入、网页黑名单、问答干预策略等配置
是否开启划词搜索,默认为false,不开启。开启之后将自动针对大模型返回内容抽取实体,挂载百度百科词条链接。
是否启用切片重排策略,默认值为 None,表示不启用。启用后,将根据配置参数对搜索结果进行切片,并按相关性筛选出最优切片传递给大模型,以降低响应时延。
显示子属性
隐藏子属性
控制切片的大小,默认值400字符,推荐值[300-400]
控制下一个切片相对于上一个切片起始位置的偏移量,默认值300字符,推荐值[300-400]
用于大模型总结的最大切片个数,默认值4
POST /v2/ai_search/chat/completions HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <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 <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
}'
返回响应
请求ID。
错误码,当发生异常时返回。
错误消息,当发生异常时返回。
模型生成的 completion 的选择列表
显示子属性
隐藏子属性
模型停止生成token的原因。
返回值:
stop:模型自然停止生成。
length:输出长度达到了模型上下文长度限制。
该completion在选择列表中的索引。
非流式模型生成的completion消息。
显示子属性
隐藏子属性
completion内容
仅适用于deepseek思考系列模型。
内容为 assistant 消息中在最终答案之前的推理内容。
固定值assistant
流式返回的completion增量。
显示子属性
隐藏子属性
completion内容
仅适用于deepseek思考系列模型。
内容为assistant消息中在最终答案之前的推理内容。
固定值assistant。
执行状态。
显示子属性
隐藏子属性
执行动作。返回值如下,对应description参数的描述。 1.query_understanding 2.search_begin 3.search_finish
执行动作描述。 1.正在理解问题 2.正在搜索网页 3.已搜索X个网页
token开销
显示子属性
隐藏子属性
prompt(输入)token数
completion(输出)token数
总token数
用户输入query是否涉及安全问题。
模型回答参考引用内容
显示子属性
隐藏子属性
网站图标地址
引用编号1、2、3
网页标题
网页地址
网站锚文本或网站标题
站点名称
网页内容,显示200字以内的相关信息原文片段。
网页日期
检索资源类型。返回值如下:
web:网页
image:图像
video:视频
图片详情
显示子属性
隐藏子属性
图片链接
图片高度
图片宽度
视频详情
显示子属性
隐藏子属性
视频链接
视频高度
视频宽度
视频大小,单位Bytes
视频长度,单位秒
视频封面图
追问问题
显示子属性
隐藏子属性
实体百科词条信息,只有当请求参数word_selection_search=true并且识别到返回文本内容中出现了对应实体之后,才会返回该内容。
显示子属性
隐藏子属性
实体名称
实体首字偏移量,实体的第一个字符相对于整个回答的偏移量。
实体字数
百度词条名称
百度词条链接
百度词条ID
{
"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 | 模型流式输出超时 |
| 其它 | 详见模型返回错误码 |
