资讯 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

智能搜索生成

接口描述

概述:可根据用户输入query搜索全网实时信息后,并进行智能总结回答;
计费:每日免费额度为100次,支持按量后付费,默认优先抵扣免费资源。智能搜索生成的免费额度以及总调用上限,与百度搜索共享,且每个账号每天最多使用100,000次,如有更多调用需求请您联系我们进行开通,费用详情请查看计费说明

在线调试

百度智能云千帆提供了 API在线调试平台-示例代码 ,用于帮助开发者调试接口,平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能,简单易用。

接口定义

URL /v2/ai_search/chat/completions
Method POST
Content-Type application/json
Authorization 请求签名(Bearer <AppBuilder API Key>)

请求结构

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
}

请求参数

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语法的图片内容。 比如: ...北京美食包括北京烤鸭等![北京烤鸭](image_url)。
选择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)详情

  • 可以用于数值型、日期型的字段。使用语法如下:
"range": {
     "{field}": {
          "gte": "{lowerBound}",
          "gt": "{lowerBound}",
          "lte": "{upperBound}",
          "lt": "{upperBound}"
       }
  }

实体(field)

  • pageTime:发布时间的实体名,表示针对pageTime做范围查询。此处pageTime对应响应数据中的page_time字段。(网页发布时间的筛选功能只适用于可利用与可展现库,其他结果如视频等不召回

查询范围(lowerBound\upperBound)

- "now"表示当前时间,在now后 可以选择跟数学表达式:
- -1d:减1天;
- -1w:减1周;
- -1M:减1月;
- -1y:减1年;
- /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天(不含当天)发布的网页结果

"query": {
    "filter": { 
         "range": {
             "page_time": {
                 "gte": "now-1w/d"
                 "lt": "now/d"
              }
         }
     }
 }

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 示例

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
}'

正确响应示例

{
    "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] )"
}

OpenAI SDK调用百度AI搜索

百度AI搜索V2版本使用与 OpenAI 兼容的 API 格式,通过修改配置,您可以使用 OpenAI SDK 来访问百度AI搜索。

前提条件

确保已安装最新版OpenAI SDK。

调用示例

# Please install OpenAI SDK first: `pip3 install openai`

from openai import OpenAI

client = OpenAI(api_key="bce-v3/ALTAK***Altc/051c6***d238ce", # 千帆AppBuilder平台的ApiKey      
base_url="https://qianfan.baidubce.com/v2/ai_search") # 百度AI搜索V2版本接口

response = client.chat.completions.create(
    model="deepseek-r1",
    messages=[
        {"role": "user", "content": "今天有哪些体育新闻"}
    ],
    stream=False
)

print(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,确定即可
图片1 图片2

第二步:在Cursor中添加Server

  • Cursor设置界面-> MCP-> Add new MCP Server -> 填写server信息。
图片1 图片2

注意,Cursor最新版本需要通过配置json来添加MCP Server。 核心代码示例:

{
  "mcpServers": {
    "AISearch": {
      "url": "百度AI搜索Server URL"
    }
  }
}

第三步:在Cursor中使用百度AI搜索组件

  • 前往Cursor新版本的chat、旧版本的composer中,即可与agent对话。

效果展示:

在Cursor中,我们向Agent提问:今天有哪些体育新闻?这时百度AI搜索将为用户搜索今天最新的体育新闻,并在Cursor中将总结好的内容返回给用户。

image (6).png

错误码

错误码 描述
400 客户端请求参数错误
500 服务端执行错误
501 调用模型服务超时
502 模型流式输出超时
其它 详见模型返回错误码
https://cloud.baidu.com/doc/WENXINWORKSHOP/s/tlmyncueh
上一篇
探索广场
下一篇
百度搜索