智能搜索生成
接口描述
概述:可根据用户输入query搜索全网实时信息后,并进行智能总结回答;
计费:每日免费额度为100次,支持按量后付费,默认优先抵扣免费资源。智能搜索生成的免费额度以及总调用上限,与百度搜索共享,且每个账号每天最多使用100,000次,如有更多调用需求请您联系我们进行开通,费用详情请查看计费说明。
在线调试
百度智能云千帆提供了 API在线调试平台-示例代码 ,用于帮助开发者调试接口,平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能,简单易用。
接口定义
URL | /v2/ai_search/chat/completions |
---|---|
Method | POST |
Content-Type | application/json |
Authorization | 请求签名(Bearer <AppBuilder API Key>) |
请求结构
1POST /v2/ai_search/chat/completions HTTP/1.1
2HOST: qianfan.baidubce.com
3Authorization: Bearer <AppBuilder API Key>
4Content-Type: application/json
5{
6 "messages": [
7 {
8 "content": "近日油价调整消息。",
9 "role": "user"
10 }
11 ],
12 "stream": false,
13 "model": "ernie-3.5-8k",
14 "instruction": "##",
15 "enable_corner_markers": true,
16 "enable_deep_search": true
17}
请求参数
header参数
除公共头域外,无其它特殊头域。
body参数
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
messages | array | 是 | 搜索输入; array的长度需要是奇数, role必须是user-assistant-user交替,以user开始以user结束;在百度搜索时,仅支持单论输入,若传入多轮输入,则以用户传入最后的content为输入查询。 |
search_source | string | 否 | 使用的搜索引擎版本; 可选值:baidu_search_v1、baidu_search_v2 智能搜索生成时均可输入,兼容性考虑默认为baidu_search_v1 V2相比于V1:提升了性能表现,提升了数据内容的丰富度,更适用于结合大模型使用的场景,建议默认使用V2。 |
resource_type_filter | array<SearchResource> | 否 | 单次搜索最大返回数量。 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}] 特别的,如需单次返回更多链接,可在智能搜索生成中开启深度搜索 |
search_filter | SearchFilter | 否 | 根据SearchFilter下的子条件做检索过滤,使用方式详见后文; 仅search_source为baidu_search_v2时生效 |
search_recency_filter | string | 否 | 根据网页发布时间进行筛选; 枚举值: week:最近7天 month:最近30天 semiyear:最近180天 year:最近365天 |
search_domain_filter | list<string> | 否 | 支持设置基于站点的过滤条件,对搜索到的结果按指定站点进行筛选,仅返回来自所设站点的内容。例如:设置["baidu.com"] ,在搜索到的结果中仅返回来自 baidu.com 的搜索结果。 |
model | string | 否 | 使用的模型名。不传模型名称时,搜索模式为百度搜索,传入模型名称时则为智能搜索生成。 目前支持从千帆ModelBuilder官网开通的模型,详细列表内容见可选模型列表 常见模型选项如下: 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 |
instruction | string | 否 | 人设指令,用于设定输出风格等。 默认值:"" 注意:字符长度需要小于等于2000 |
temperature | float | 否 | 模型采样参数。较高的数值会使输出更加随机,而较低的数值会使其更加集中和确定。 值范围:(0, 1] 默认值:1e-10 注意:该值越大,模型输出越多样,也越不稳定 |
top_p | float | 否 | 模型采样参数。 影响输出文本的多样性,取值越大,生成文本的多样性越强。 值范围:(0, 1] 默认值:1e-10 注意:该值越大,模型输出越多样,也越不稳定 |
prompt_template | string | 否 | 面向高阶用户开放自定义prompt模版,普通用户不需要设置,支持添加的变量包括: query:经过改写等处理后的query original_query:用户原始query history:对话历史 context_out:搜索结果(如果传入个性化知识,则是个性化知识 + 搜索结果) instruction:人设 time:当前时间 其中变量query或original_query(至少一个)、context_out必须出现在prompt_template中,其他变量可选。 样例:"搜索结果: {{context_out}} 用户query: {{query}} "。 |
search_mode | string | 否 | 控制是否进行智能联网搜索。默认为 auto。 可选值: auto:自动判断是否需要搜索 required: 必须执行搜索 disabled: 禁用搜索功能仅模型回答 |
enable_reasoning | boolean | 否 | 是否开启深度思考,仅对DeepSeek-R1、文心X1模型生效,开启后,在总结前会进行模型推理和思考并输出相关内容。 默认值:默认值:true 可选值: true:开启 false:不开启 |
enable_deep_search | boolean | 否 | 是否开启深搜索。- 深搜索会产生10次以内的智能搜索生成服务调用 默认值:false 可选值: true:开启,每种搜索类型最多返回100个搜索结果。 false:不开启,每种搜索类型最多返回10个搜索结果。 |
additional_knowledge | array<Knowledge> | 否 | 调用方提供的定制化知识内容集合,与公开的联网搜索结果构成合集,注入到模型中进行问答总结。知识注入的条数和长度, 与模型有关,限制最大10条。 可以配合 priority(优先级参数)使用,让本地搜索结果在能回答问题时优先被采用。当前支持三个优先级:-1、0、1,数值越小优先级越高,回答时会优先选择高优先级的内容。其中,百度搜索结果的优先级为 0。 |
max_completion_tokens | int | 否 | 默认2048,不同模型支持的最大输出token不一样,具体参考:https://cloud.baidu.com/doc/WENXINWORKSHOP/s/Fm2vrveyu#%E6%94%AF%E6%8C%81%E6%A8%A1%E5%9E%8B%E5%88%97%E8%A1%A8 |
response_format | string | 否 | 输出内容样式。默认值 auto。可选值: auto:智能判断是纯文本输出还是图文混排输出。 text:文本输出。 rich_text: 图文混排输出。如:在美食和旅游两个场景下,输出文本中嵌入markdown语法的图片内容。 比如: ...北京美食包括北京烤鸭等。 选择rich_text时推荐使用ernie-4.0-turbo-128k、ernie-4.0-turbo-8k模型 |
enable_corner_markers | bool | 否 | 用于设置在最后生成的总结内容正文时,是否返回角标用于标记模型输出内容的参考来源。 值含义: true:开启角标 false:隐藏角标 默认值:true |
enable_followup_queries | boolean | 否 | 针对用户问题和大模型回答结果,给出推荐的追问。 默认为false 可选值:true: 开启追问 false:不开启追问 |
stream | bool | 否 | 是否为流式请求。 值含义: true:使用HTTP SSE流式响应 false:以非流式结果返回 默认值为false; |
safety_level | string | 否 | 安全等级,可选值包括:standard:默认安全等级strict:严格安全等级 |
max_refer_search_items | int | 否 | 调节用于模型问答总结的最大搜索条数,默认是全部搜索结果。 |
config_id | string | 否 | 指定使用该配置id下的领域知识注入、网页黑名单、问答干预策略等配置,详细说明 |
model_appid | string | 否 | 模型调用appid |
max_search_query_num | int | 否 | 当开启深度搜索时,用于搜索的最大子query个数,默认为10 |
Message对象
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
role | string | 是 | 角色设定,可选值: user:用户 assistant:模型 |
content | string或array<union< TextContentBlock, ImageContentBlock>> |
是 | 1. 当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" } }] |
SearchFilter
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
match | object | 否 | 条件查询 |
+site | array<string> | 否 | 支持设置指定站点的搜索条件,即仅在设置的站点中进行内容搜索。目前仅支持设置一个站点。 |
range | object | 否 | 范围查询,更多内容可查看范围查询详情 |
+page_time | object | 否 | 假设下述的now时间是2024-07-16 |
++gth | string | 否 | 时间查询参数,值为"now-1d/d",表示含义:大于2024-07-15 00:00:00,包含2024-07-15完整天 |
++gt | string | 否 | 时间查询参数,值为"now-1d/d",表示含义:大于2024-07-15 23:59:59,不包含2024-07-15完整天 |
++lth | string | 否 | 时间查询参数,值为"now-1d/d",表示含义:小于2024-07-15 23:59:00,包含2024-07-15完整天 |
++lt | string | 否 | 时间查询参数,值为"now-1d/d",表示含义:小于2024-07-15 00:00:00,不包含2024-07-15完整天 |
范围查询(range)详情
- 可以用于数值型、日期型的字段。使用语法如下:
1"range": {
2 "{field}": {
3 "gte": "{lowerBound}",
4 "gt": "{lowerBound}",
5 "lte": "{upperBound}",
6 "lt": "{upperBound}"
7 }
8 }
实体(field)
- pageTime:发布时间的实体名,表示针对pageTime做范围查询。此处pageTime对应响应数据中的page_time字段。(网页发布时间的筛选功能只适用于可利用与可展现库,其他结果如视频等不召回)
查询范围(lowerBound\upperBound)
1- "now"表示当前时间,在now后 可以选择跟数学表达式:
2- -1d:减1天;
3- -1w:减1周;
4- -1M:减1月;
5- -1y:减1年;
6- /d: 归一化到当前天的起始\结束时间
支持的时间单位
单位 | 含义 |
---|---|
y | 年 |
M | 月 |
w | 星期 |
d | 天 |
注意:目前提供固定套餐,其他值非法
now/d
now-1w/d:一周
now-2w/d:两周
now-1M/d:一个月
now-3M/d:三个月
now-6M/d:六个月
now-1y/d:一年
条件选项
eg:now=2024-07-16 12:00
条件 | 释义 | 用例 |
---|---|---|
gte | 大于或等于 | "now-1d/d",2024-07-16前一天、向下做舍入,即大于2024-07-15 00:00:00,包含2024-07-15完整天 |
gt | 大于 | "now-1d/d",2024-07-16前一天、向上做舍入,即大于2024-07-15 23:59:59,不包含2024-07-15完整天 |
lte | 小于 | "now-1d/d",2024-07-16前一天、向上做舍入,即小于2024-07-15 23:59:00,包含2024-07-15完整天 |
lt | 小于 | "now-1d/d",2024-07-16前一天、向下做舍入,即小于2024-07-15 00:00:00,不包含2024-07-15完整天 |
注意:
1、lte使用注意:range范围会参与检索系统的cache key计算,lte在做向上归一舍入后,由于cache可能导致结果时效性落后于match指定的lte值;
2、起始(lowerBound)和截止(upperBound)时间必需同时存在,否则该功能不生效;
3、gte和gt只传其中一个即可,都传只生效gt;lte和lt只传其中一个即可,都传只生效lt
用例
查询当天前7天(不含当天)发布的网页结果
1"query": {
2 "filter": {
3 "range": {
4 "page_time": {
5 "gte": "now-1w/d"
6 "lt": "now/d"
7 }
8 }
9 }
10 }
ImageContentBlock对象
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
type | string | 是 | 值固定为image_url |
image_url | URL | 是 | 图片地址,支持图片格式包括jpeg、 jpg、 png、 webp |
ImageContentBlock.URL对象
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
url | string | 是 | 图片可下载url地址或base64编码后的图片内容 |
TextContentBlock对象
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
type | string | 是 | 值固定为text |
text | string | 是 | 文本内容 |
SearchResource对象
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
type | string | 是 | 搜索资源类型。 可选值: video: 视频 image: 图片 web:网页 |
top_k | int | 是 | 指定模态最大返回个数 |
Knowledge对象
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
priority | int | 否 | 搜索结果的优先级: 数字值越小,优先级越高。 取值范围【-1,1】 默认值为0; 举例: -1是优先级最高,如果与百度搜索结果优先级相同,优先使用定制化知识点,默认值为0 |
data_type | string | 否 | 数据类型 |
data | Data | 是 | 数据对象 |
Knowledge.Data对象
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
content | string | 是 | 知识点内容 |
title | string | 否 | 知识点标题 |
url | string | 否 | 知识点url地址 |
release_date | string | 否 | 发布日期 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
字段 | 类型 | 必然存在 | 说明 |
---|---|---|---|
requestId | string | 是 | 请求request_id |
code | string | 否 | 错误代码,当发生异常时返回 |
message | string | 否 | 错误代码,当发生异常时返回 |
choices | array<Choice> | 是 | 模型生成的 completion 的选择列表 |
usage | Usage | 否 | token开销 |
is_safe | bool | 是 | query是否安全 |
references | array<Reference> | 否 | 模型回答参考引用内容 |
followup_queries | array<str> | 否 | 追问问题 |
Choice对象
字段 | 类型 | 必然存在 | 说明 |
---|---|---|---|
finish_reason | string | 否 | 模型停止生成token的原因。 可选值: stop: 模型自然停止生成 length: 输出长度达到了模型上下文长度限制 |
index | int | 是 | 该completion在选择列表中的索引 |
message | Message | 否 | 非流式模型生成的completion消息 |
delta | Delta | 否 | 流式返回的completion增量 |
Choice.Message对象
字段 | 类型 | 必然存在 | 说明 |
---|---|---|---|
content | string | 是 | completion内容 |
reasoning_content | string | 否 | 仅适用于 deepseek思考系列模型。 内容为 assistant 消息中在最终答案之前的推理内容 |
role | string | 是 | 固定值assistant |
Choice.Delta对象
字段 | 类型 | 必然存在 | 说明 |
---|---|---|---|
content | string | 是 | completion内容 |
reasoning_content | string | 否 | 仅适用于 deepseek思考系列模型。 内容为 assistant 消息中在最终答案之前的推理内容 |
role | string | 是 | 固定值assistant |
Reference对象
字段 | 类型 | 必然存在 | 说明 |
---|---|---|---|
icon | string | 否 | 站点图标 |
id | int | 是 | 引用编号1、2、3 |
title | string | 是 | 网页标题 |
url | string | 是 | 网页地址 |
web_anchor | string | 是 | 网站锚文本或网站标题 |
content | string | 否 | 网站内容 |
date | string | 否 | 网页日期 |
type | string | 否 | 检索资源类型: web:网页 image:图像内容 video:视频内容 |
image | ImageDetail | 否 | 图片详情 |
video | VideoDetail | 否 | 视频详情 |
Reference.ImageDetail对象
字段 | 类型 | 必然存在 | 说明 |
---|---|---|---|
url | string | 否 | 图片链接 |
height | string | 否 | 图片高度 |
width | string | 否 | 图片宽度 |
Reference.VideoDetail对象
字段 | 类型 | 必然存在 | 说明 |
---|---|---|---|
url | string | 否 | 视频链接 |
height | string | 否 | 视频高度 |
width | string | 否 | 视频宽度 |
size | string | 否 | 视频大小,单位Bytes |
duration | string | 否 | 视频长度,单位秒 |
hover_pic | string | 否 | 视频封面图 |
Usage对象
字段 | 类型 | 必然存在 | 说明 |
---|---|---|---|
prompt_tokens | int | 否 | prompt(输入)token数 |
completion_tokens | int | 否 | completion(输出)token数 |
total_tokens | int | 否 | 总token数 |
请求curl 示例
1curl --location 'https://qianfan.baidubce.com/v2/ai_search/chat/completions' \
2--header 'X-Appbuilder-Authorization: Bearer <AppBuilder API Key>' \
3--header 'Content-Type: application/json' \
4--data '{
5 "messages": [
6 {
7 "content": "北京有哪些景点",
8 "role": "user"
9 }
10 ],
11 "search_source": "baidu_search_v1",
12 "resource_type_filter": [
13 {"type": "image","top_k": 4},
14 {"type": "video","top_k": 4},
15 {"type": "web","top_k": 4}
16 ],
17 "search_recency_filter": "year",
18 "stream": false,
19 "model": "ernie-3.5-8k",
20 "enable_deep_search": false,
21 "enable_followup_query": false,
22 "temperature": 0.11,
23 "top_p": 0.55,
24 "search_mode": "auto",
25 "enable_reasoning": true
26}'
正确响应示例
1{
2 "choices": [
3 {
4 "finish_reason": "stop",
5 "index": 0,
6 "message": {
7 "content": "北京的景点非常丰富,其中包括:\n1. 故宫博物院(紫禁城):是世界上现存规模最大、保存最为完整的木质结构古建筑群之一,也是明清两代的皇家宫殿。\n2. 八达岭长城:是万里长城的重要组成部分,也是明长城的一个隘口,雄伟壮观,历史底蕴深厚。\n3. 颐和园:是清朝时期的皇家园林,以昆明湖、万寿山为基址,以杭州西湖为蓝本,汲取江南园林的设计手法而建成的一座大型山水园林,被誉为“皇家园林博物馆”。\n4. 北京天安门广场:是世界最大的城市广场,见证了许多重大历史时刻。\n5. 天坛公园:是明清皇帝祭天的地方,建筑独特,寓意“天圆地方”。\n6. 圆明园:是清代大型皇家园林,虽遭破坏,但仍能感受到昔日的辉煌与沧桑。\n7. 香山公园:是北京西郊的山林公园,景色秀丽,秋季红叶更是美不胜收。\n8. 恭王府:是规模宏大的王府建筑群,建筑精美。\n9. 什刹海:包括前海、后海等,有老北京的韵味,可乘船赏景。\n10. 奥林匹克公园:体现了“科技、绿色、人文”的理念,有鸟巢、水立方等标志性建筑。\n\n除了这些,北京还有许多其他值得一游的景点,如法海寺、龙庆峡、古北水镇、红螺寺等。",
8 "role": "assistant"
9 }
10 }
11 ],
12 "is_safe": true,
13 "references": [
14 {
15 "content": "1. 故宫(紫禁城)地址:东城区景山前街4号。门票:60元(旺季)/40元(淡季)开放时间:8:30-17:00(周一闭馆)。 为什么必去?故宫是世界现存最大、最完整的木质结构古建筑群,600年明清皇家历史的见证者,每一砖一瓦都藏着故事。必玩体验:中轴线游览(太和殿、乾清宫、御花园)感受皇家气派。打卡网红角落:延禧宫的西洋楼、红墙拍照(建议穿汉服)。珍宝馆+钟表馆(另收费),...",
16 "date": "2025-4-24",
17 "icon": "https://pic.rmb.bdstatic.com/bjh/user/f1c77bf4fc9f3651df29e52acde36e94.jpeg",
18 "id": 1,
19 "image": null,
20 "title": "北京必玩景点TOP10|2025最新攻略,带你玩转帝都!",
21 "type": "web",
22 "url": "https://baijiahao.baidu.com/s?id=1830291819430711070&wfr=spider&for=pc",
23 "video": null,
24 "web_anchor": "老六爱玩"
25 },
26 {
27 "content": "北京景点攻略 如果你是第一次去北京旅游可要千万要收藏好了",
28 "date": "2024-06-01 03:18",
29 "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
30 "id": 2,
31 "image": {
32 "height": "674",
33 "url": "http://img0.baidu.com/it/u=1145656209,2145532403&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=674",
34 "width": "500"
35 },
36 "title": "北京景点攻略 如果你是第一次去北京旅游可要千万要收藏好了",
37 "type": "image",
38 "url": "http://mbd.baidu.com/newspage/data/dtlandingsuper?nid=dt_5388334462984511033",
39 "video": null,
40 "web_anchor": "全网资源"
41 },
42 {
43 "content": "哪些北京京郊的景点 外地同学值得自驾车去 跟着UP主出行看世界 /生活/出行/北京旅游避坑指南/北京去哪玩好/干货实用攻略/自驾游北京攻略/亲子游/周边游/周末去哪玩/北京旅游攻略/保姆级攻略 哪些北京京郊景点值得外地同学自驾车去 北京公义 大八山面 北京京郊大部分景点都在六环外 办理六环外的进京证就行 当然您要办理六环内的更好一些 下面就给您推荐一些京郊自驾游 外地同学值得去的景点(北京同学也值...",
44 "date": "2025-5-23",
45 "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/bilibili.ico",
46 "id": 3,
47 "image": null,
48 "title": "哪些北京京郊的景点 外地同学值得自驾车去",
49 "type": "web",
50 "url": "https://www.bilibili.com/video/BV1hE421K7K1",
51 "video": null,
52 "web_anchor": "哔哩哔哩"
53 },
54 {
55 "content": "北京旅游必去的十大景点推荐",
56 "date": "2024-06-19 13:00",
57 "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
58 "id": 4,
59 "image": {
60 "height": "1067",
61 "url": "http://img2.baidu.com/it/u=80406124,3208002747&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1067",
62 "width": "800"
63 },
64 "title": "北京旅游必去的十大景点推荐",
65 "type": "image",
66 "url": "http://www.douyin.com/note/7382074689126010131",
67 "video": null,
68 "web_anchor": "全网资源"
69 },
70 {
71 "content": "北京景区排名必玩十大景点?有世界最大城市广场,有大型皇家园林 北京景区排名必玩十大景点?有世界最大城市广场,有大型皇家园林 北京景区 城市广场 旅游攻略 旅游资讯 皇家园林 北京有很多值得一去的景点推荐10个:1.故宫: 位于北京中心明清皇宫建筑辉煌藏品丰富 尽显皇家风范 2.颐和园 清朝皇家园林有山有水融合江南园林风格 风景如画 3.八达岭长城:在延庆万里长城重要部分 雄伟壮观历史底蕴深厚 4....",
72 "date": "2025-5-22",
73 "icon": "https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=76251347,1123177279&fm=195&app=88&f=PNG?w=200&h=200",
74 "id": 5,
75 "image": null,
76 "title": "北京景区排名必玩十大景点?有世界最大城市广场,有大型...",
77 "type": "web",
78 "url": "https://haokan.baidu.com/v?pd=wisenatural&vid=14103857872992752240",
79 "video": null,
80 "web_anchor": "好看视频"
81 },
82 {
83 "content": "北京必去十大景点 新手必看‼️附旅游攻略.熬夜整理出来的必打",
84 "date": "2024-06-15 20:25",
85 "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
86 "id": 6,
87 "image": {
88 "height": "1342",
89 "url": "http://img1.baidu.com/it/u=17130128,3218194790&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1342",
90 "width": "800"
91 },
92 "title": "北京必去十大景点 新手必看‼附旅游攻略.熬夜整理出来的必打",
93 "type": "image",
94 "url": "http://www.douyin.com/note/7380319151006436646",
95 "video": null,
96 "web_anchor": "全网资源"
97 },
98 {
99 "content": "揭秘!北京好玩的十大景点排行榜,你去过几个?北京,这座古老又现代的城市,藏着无数好玩的地方。想知道哪些景点能跻身北京好玩的地方排行榜前十名吗?接下来,我们就为你揭开谜底,带你领略京城最值得一去的精华景点,让你的北京之行不留遗憾。1. 故宫博物院 故宫,旧称紫禁城,是中国明清两代的皇家宫殿,也是世界上现存规模最大、保存最为完整的木质结构古建筑群之一。走进故宫,仿佛穿越回了古代,红墙黄瓦、飞檐斗拱,处...",
100 "date": "2025-5-4",
101 "icon": "https://pic.rmb.bdstatic.com/bjh/user/84f5641182eb2b574909828a3fa8f9b0.jpeg",
102 "id": 7,
103 "image": null,
104 "title": "揭秘!北京好玩的十大景点排行榜,你去过几个?",
105 "type": "web",
106 "url": "https://baijiahao.baidu.com/s?id=1830726637146162329&wfr=spider&for=pc",
107 "video": null,
108 "web_anchor": "炫拍客旅途志"
109 },
110 {
111 "content": "北京必去十大景点新手必看.亲亲记滴点赞收藏! 1 no.1",
112 "date": "2024-08-17 11:00",
113 "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
114 "id": 8,
115 "image": {
116 "height": "1067",
117 "url": "http://img0.baidu.com/it/u=3343386837,4291065808&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1067",
118 "width": "800"
119 },
120 "title": "北京必去十大景点新手必看.亲亲记滴点赞收藏! 1 no.1",
121 "type": "image",
122 "url": "http://www.douyin.com/note/7403937889005882650",
123 "video": null,
124 "web_anchor": "全网资源"
125 }
126 ],
127 "request_id": "ad524989-be46-48fd-b2ec-344683b28305",
128 "usage": {
129 "completion_tokens": 295,
130 "prompt_tokens": 1919,
131 "total_tokens": 2214
132 }
133}
错误响应示例
1{
2 "requestId": "00000000-0000-0000-0000-000000000000",
3 "code": 216003,
4 "message": "Authentication error: ( [Code: InvalidHTTPAuthHeader; Message: Fail to parse apikey authorization; RequestId: ea6ffeca-a136-401b-ba30-61c910c02ead] )"
5}
OpenAI SDK调用百度AI搜索
百度AI搜索V2版本使用与 OpenAI 兼容的 API 格式,通过修改配置,您可以使用 OpenAI SDK 来访问百度AI搜索。
前提条件
确保已安装最新版OpenAI SDK。
调用示例
1# Please install OpenAI SDK first: `pip3 install openai`
2
3from openai import OpenAI
4
5client = OpenAI(api_key="bce-v3/ALTAK***Altc/051c6***d238ce", # 千帆AppBuilder平台的ApiKey
6base_url="https://qianfan.baidubce.com/v2/ai_search") # 百度AI搜索V2版本接口
7
8response = client.chat.completions.create(
9 model="deepseek-r1",
10 messages=[
11 {"role": "user", "content": "今天有哪些体育新闻"}
12 ],
13 stream=False
14)
15
16print(response.choices[0].message.content)
Cursor中使用百度AI搜索MCP组件
通过Cursor Chat直接使用
- 可在Cursor中直接体验百度AI搜索组件的深度搜索与智能总结能力,高效准确地获取答案。
操作步骤
第一步:获取百度AI搜索Server URL
-
百度AI搜索Server URL:
http://appbuilder.baidu.com/v2/ai_search/mcp/sse?api_key=xxx - 其中,api_key的格式为"Bearer+<AppBuilder API Key>",注意保留中间“+”,示例:Bearer+bce-v3/ALTAK-xuZRMCVTC9######
- AppBuilder API Key获取方式:控制台点击API Key进行创建,服务选择千帆AppBuilder,确定即可


第二步:在Cursor中添加Server
- Cursor设置界面-> MCP-> Add new MCP Server -> 填写server信息。


注意,Cursor最新版本需要通过配置json来添加MCP Server。 核心代码示例:
1{
2 "mcpServers": {
3 "AISearch": {
4 "url": "百度AI搜索Server URL"
5 }
6 }
7}
第三步:在Cursor中使用百度AI搜索组件
- 前往Cursor新版本的chat、旧版本的composer中,即可与agent对话。
效果展示:
在Cursor中,我们向Agent提问:今天有哪些体育新闻?这时百度AI搜索将为用户搜索今天最新的体育新闻,并在Cursor中将总结好的内容返回给用户。
错误码
错误码 | 描述 |
---|---|
400 | 客户端请求参数错误 |
500 | 服务端执行错误 |
501 | 调用模型服务超时 |
502 | 模型流式输出超时 |
其它 | 详见模型返回错误码https://cloud.baidu.com/doc/WENXINWORKSHOP/s/tlmyncueh |