联网搜索

更新时间：2026-03-24

使用场景

对于需要获取实时信息或最新数据的场景，如新闻事件查询、文献检索、追踪政策变化。基于联网搜索能力，模型能获取实时数据和信息，更精确的回答用户在特定场景下的问题。

使用方式

ERNIE 模型内置搜索

在请求body中添加如下web_search参数，即可实现联网搜索，参数描述如下：

参数名称	类型	必填	默认值	描述
enable	boolean	否	否	是否启用联网搜索功能
enable_trace	boolean	否	false	是否返回溯源信息
enable_status	boolean	否	false	是否在响应中返回搜索触发信号，如果触发搜索，首包返回『正在搜索』，通过delta_tag:search_status表示这一包是信号包
enable_citation	boolean	否	false	是否在响应中包含引用来源角标。单个角标格式示例：`^[1]^`，多个角标格式示例：`^[1][2]^`
search_mode	string	否	"auto"	联网搜索模式： - `auto`:大模型基于query判断意图是否需要进行搜索。举例：用户query`1+1等于几`，默认不过联网搜索 - `required`:强制进行联网搜索，注意：ernie系列模型不支持强制搜索
search_number	integer	否	10	检索的文献数量，范围在[1~28]之间
reference_number	integer	否	10	用于给大模型总结的文献数量，范围在[1~28]之间（需≤search_number，若 reference_number > search_number 则将默认赋值 reference_number=search_number,如设置：search_number=6，reference_number=10，则search_number=10）
user_ip	string	否	空	用户ip，目前仅支持ernie系列模型

入参示例：

                JSON
                
            

                {
    "web_search": {
        "enable": true,
        "enable_citation": true,
        "enable_trace": true,
        "enable_status": true,
        "search_mode":"auto",
        "search_number": 10,
        "reference_number": 5
    }
}
            

开源模型使用搜索接口

针对针对开源模型，建议使用搜索接口，参考接口文档：https://cloud.baidu.com/doc/qianfan-api/s/Wmbq4z7e5

支持模型列表

ERNIE 5.0系列（含preview、日期版本）
- ernie-5.0-thinking-preview
ERNIE X系列（含preview、日期版本）
- ernie-x1.1-preview
- ernie-x1-turbo-32k
ERNIE 4.5系列（含preview、日期版本）
- ernie-4.5-turbo-32k
- ernie-4.5-turbo-128k
- ernie-4.5-21b-a3b

特别说明：

ernie-x1-turbo-32k 只支持web_search.enable参数，其他参数不支持

使用示例

ERNIE-X1-Turbo-32K

只支持enable入参，不支持角标、搜索信号提前返回等能力。
可以触发多次多次搜索，比如下面的示例当中，第一次会搜索当前黄金价格，第二次会搜索过去24小时黄金价格涨跌幅，最后给出总结答案。最大支持触发10次搜索，将按照实际触发搜索的次数计费。

请求

                Bash
                
            

                curl --location 'https://qianfan.bj.baidubce.com/v2/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer your-key' \
--data '{
    "model": "ernie-x1-turbo-32k",
    "messages": [
        {
            "role": "user",
            "content": "当前黄金价格和过去24小时涨跌幅"
        }
    ],
    "stream": true,
    "web_search": {
        "enable": true
    }
}'
            

                JSON
                
            

                data: {"id":"as-ypk4zzgdpt","object":"chat.completion.chunk","created":1750381709,"model":"ernie-x1-turbo-32k","choices":[{"index":0,"delta":{"content":null,"role":"assistant","reasoning_content":"用户"},"flag":0}]}

data: {"id":"as-ypk4zzgdpt","object":"chat.completion.chunk","created":1750381709,"model":"ernie-x1-turbo-32k","choices":[{"index":0,"delta":{"content":null,"reasoning_content":"希望"},"flag":0}]}

......
//第一次触发搜索
data: {"id":"as-ypk4zzgdpt","object":"chat.completion.chunk","created":1750381709,"model":"ernie-x1-turbo-32k","choices":null,"search_results":[{"index":0,"url":"https://www.baidu.com/s?wd=%E5%BD%93%E5%89%8D%E9%BB%84%E9%87%91%E4%BB%B7%E6%A0%BC","title":"当前黄金价格"}]}
......
//第二次触发搜索
data: {"id":"as-ypk4zzgdpt","object":"chat.completion.chunk","created":1750381709,"model":"ernie-x1-turbo-32k","choices":null,"search_results":[{"index":0,"url":"https://www.baidu.com/s?wd=%E8%BF%87%E5%8E%BB24%E5%B0%8F%E6%97%B6%E9%BB%84%E9%87%91%E4%BB%B7%E6%A0%BC%E6%B6%A8%E8%B7%8C%E5%B9%85","title":"过去24小时黄金价格涨跌幅"}]}
......
//最后一包汇总全量搜索记录
data: {"id":"as-ypk4zzgdpt","object":"chat.completion.chunk","created":1750381709,"model":"ernie-x1-turbo-32k","choices":[{"index":0,"delta":{"content":""},"finish_reason":"stop","flag":0}],"usage":{"prompt_tokens":8,"completion_tokens":845,"total_tokens":853,"completion_tokens_details":{"reasoning_tokens":470}},"search_results":[{"index":0,"url":"https://www.baidu.com/s?wd=%E5%BD%93%E5%89%8D%E9%BB%84%E9%87%91%E4%BB%B7%E6%A0%BC","title":"当前黄金价格"},{"index":1,"url":"https://www.baidu.com/s?wd=%E8%BF%87%E5%8E%BB24%E5%B0%8F%E6%97%B6%E9%BB%84%E9%87%91%E4%BB%B7%E6%A0%BC%E6%B6%A8%E8%B7%8C%E5%B9%85","title":"过去24小时黄金价格涨跌幅"}]}

data: [DONE]
            

ERNIE-4.5-Turbo-32k模型

只支持意图识别搜索，即是否触发搜索，由大模型意图识别判定。

请求

                Bash
                
            

                curl --location 'https://qianfan.baidubce.com/v2/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer your-key' \
--data '{
    "messages": [
        {
            "role": "user",
            "content": "今日足球赛况"
        }
    ],
    "stream": true,
    "model": "ernie-4.5-turbo-32k",
    "web_search": {
        "enable": true,
        "enable_trace": true,
        "enable_status":true,
        "enable_citation": true,
        "search_number": 10,
        "reference_number": 5
    }
}'
            

                JSON
                
                data: {"id":"as-yufms3fs7m","object":"chat.completion.chunk","created":1745507336,"model":"ernie-4.5-turbo-32k","choices":[{"index":0,"delta":{"content":"正在搜索","role":"assistant"},"delta_tag":"search_status"}]}

data: {"id":"as-yufms3fs7m","object":"chat.completion.chunk","created":1745507336,"model":"ernie-4.5-turbo-32k","choices":[{"index":0,"delta":{"content":"今天是2","role":"assistant"},"flag":0}],"search_results":[{"index":1,"url":"https://live.nowscore.com/analysis/2607195.html","title":"2025年04月24日足球让球分析:都灵 VS 乌迪内斯 - 捷报比分网"},{"index":2,"url":"https://sports.163.com/world/?_=1498278879","title":"国际足球"},{"index":3,"url":"https://live.500.com/index.php图片","title":"足球比分直播_竞彩足球比分直播_足彩即时比分直播网-500彩票网"},{"index":4,"url":"https://sports.sohu.com/a/888368570_120693275","title":"4月24日足球赛前比分预测 进球数 半全场 二串一 竞彩足球赛事赛前分析预测"},{"index":5,"url":"https://m.titan007.com/indexnew.shtml\u0026wd=\u0026eqid=9761e11200059a7e0000000464709b01","title":"即时比分_比分直播_足球比分直播-新球体育-球探体育"},{"index":6,"url":"https://live.500.com/zucai.php","title":"【足彩比分直播】_足球彩票比分直播_胜负彩即时比分直播网-500彩票网"},{"index":7,"url":"https://m.sports.ydniu.com/news/detail/927441964","title":"2025年04月24日法女甲南特女足vs里昂女足历史战绩,交战记录,比分预测"},{"index":8,"url":"https://m.titan007.com/odds.htm","title":"即时比分_比分直播_足球比分直播-新球体育-球探体育"},{"index":9,"url":"https://www.vipc.cn/results/jczq?in=lotteryInfo","title":"竞彩足球开奖"},{"index":10,"url":"https://live.nowscore.com/analysis/2718294cn.html","title":"2025年04月24日足球让球分析:塞那乔其 VS 奥卢 - 捷报比分网"}]}

data: {"id":"as-yufms3fs7m","object":"chat.completion.chunk","created":1745507336,"model":"ernie-4.5-turbo-32k","choices":[{"index":0,"delta":{"content":"02"},"flag":0}]}

data: {"id":"as-yufms3fs7m","object":"chat.completion.chunk","created":1745507336,"model":"ernie-4.5-turbo-32k","choices":[{"index":0,"delta":{"content":"5年"},"flag":0}]}

data: {"id":"as-yufms3fs7m","object":"chat.completion.chunk","created":1745507336,"model":"ernie-4.5-turbo-32k","choices":[{"index":0,"delta":{"content":"4月"},"flag":0}]}
......

data: {"id":"as-yufms3fs7m","object":"chat.completion.chunk","created":1745507336,"model":"ernie-4.5-turbo-32k","choices":[{"index":0,"delta":{"content":"。"},"flag":0}]}

data: {"id":"as-yufms3fs7m","object":"chat.completion.chunk","created":1745507336,"model":"ernie-4.5-turbo-32k","choices":[{"index":0,"delta":{"content":"\n"},"flag":0}]}

data: {"id":"as-yufms3fs7m","object":"chat.completion.chunk","created":1745507336,"model":"ernie-4.5-turbo-32k","choices":[{"index":0,"delta":{"content":"\n"},"flag":0}]}

data: {"id":"as-yufms3fs7m","object":"chat.completion.chunk","created":1745507336,"model":"ernie-4.5-turbo-32k","choices":[{"index":0,"delta":{"content":"---"},"finish_reason":"stop","flag":0}],"search_results":[{"index":1,"url":"https://live.nowscore.com/analysis/2607195.html","title":"2025年04月24日足球让球分析:都灵 VS 乌迪内斯 - 捷报比分网"},{"index":2,"url":"https://sports.163.com/world/?_=1498278879","title":"国际足球"},{"index":3,"url":"https://live.500.com/index.php图片","title":"足球比分直播_竞彩足球比分直播_足彩即时比分直播网-500彩票网"},{"index":4,"url":"https://sports.sohu.com/a/888368570_120693275","title":"4月24日足球赛前比分预测 进球数 半全场 二串一 竞彩足球赛事赛前分析预测"},{"index":5,"url":"https://m.titan007.com/indexnew.shtml\u0026wd=\u0026eqid=9761e11200059a7e0000000464709b01","title":"即时比分_比分直播_足球比分直播-新球体育-球探体育"},{"index":6,"url":"https://live.500.com/zucai.php","title":"【足彩比分直播】_足球彩票比分直播_胜负彩即时比分直播网-500彩票网"},{"index":7,"url":"https://m.sports.ydniu.com/news/detail/927441964","title":"2025年04月24日法女甲南特女足vs里昂女足历史战绩,交战记录,比分预测"},{"index":8,"url":"https://m.titan007.com/odds.htm","title":"即时比分_比分直播_足球比分直播-新球体育-球探体育"},{"index":9,"url":"https://www.vipc.cn/results/jczq?in=lotteryInfo","title":"竞彩足球开奖"},{"index":10,"url":"https://live.nowscore.com/analysis/2718294cn.html","title":"2025年04月24日足球让球分析:塞那乔其 VS 奥卢 - 捷报比分网"}]}

data: [DONE]

OpenAI SDK使用联网搜索

下面是基于 OpenAI 库使用联网搜索的例子：

                Python
                
            

                from openai import OpenAI

client = OpenAI(
    api_key="your-key",  # 
    base_url="https://qianfan.baidubce.com/v2",  # 
)

web_search={
    "enable":True,
    "enable_trace":True
}
extra_data={
    "web_search":web_search
}

completion = client.chat.completions.create(
  model="ernie-4.5-turbo-32k",
  messages=[
    {"role": "user", "content": "今天上海天气怎么样"}
  ],
  stream=True,
  extra_body=extra_data
)

for chunk in completion:
  if chunk.choices[0].delta.content is not None:
    print(chunk.choices[0].delta.content, end="")
            

评价此篇文章

有帮助没帮助

结构化输出

时延优化

百度智能云

千帆AI应用开发者中心-开始使用 qianfan-docs

千帆AI应用开发者中心-开始使用 qianfan-docs

联网搜索

使用场景

使用方式

ERNIE 模型内置搜索

开源模型使用搜索接口

支持模型列表

使用示例

ERNIE-X1-Turbo-32K

请求

返回

ERNIE-4.5-Turbo-32k模型

请求

返回

OpenAI SDK使用联网搜索

千帆AI应用开发者中心-开始使用 qianfan-docs

联网搜索

使用场景

​使用方式

ERNIE 模型内置搜索

开源模型使用搜索接口

​支持模型列表

使用示例

ERNIE-X1-Turbo-32K

请求

返回

ERNIE-4.5-Turbo-32k模型

请求

返回

OpenAI SDK使用联网搜索

使用方式

支持模型列表