联网搜索

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

所有文档
menu
没有找到结果，请重新输入

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

联网搜索

更新时间：2025-04-24

使用场景

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

​使用方式

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

参数名称 类型 必填 默认值 描述 生效范围
enable boolean 否 否 是否启用联网搜索功能
enable_trace boolean 否 true 是否返回溯源信息
enable_status boolean 否 true 是否在响应中返回搜索触发信号，如果触发搜索，首包返回『正在搜索』，通过delta_tag:search_status表示这一包是信号包
enable_citation boolean 否 true 是否在响应中包含引用来源脚本 仅ERNIE系列
search_num integer 否 10 检索的文献数量，范围在[1~28]之间 仅ERNIE系列
reference_num integer 否 10 用于给大模型总结的文献数量，范围在[1~28]之间（需≤search_num） 仅ERNIE系列

入参示例：

{
    "web_search": {
        "enable": true,
        "enable_citation": true,
        "enable_trace": true,
        "enable_status": true,
        "search_num": 10,
        "reference_num": 5
    }
}

​支持模型列表

  • ernie-4.5
  • ernie-4.5-turbo
  • ernie-4.0
  • ernie-4.0-turbo
  • ernie-3.5
  • deepseek-v3
  • deepseek-r1

说明：deepseek-v3/deepseek-r1支持联网搜索以白名单形式开放，如需体验，请提交工单申请。

使用示例

ERNIE系列模型

请求

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_num": 10,
        "reference_num": 5
    }
}'

返回

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]

Deepseek系列模型

请求

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": "deepseek-v3",
    "web_search": {
    
        "enable_status":true,
        "enable": true,
        "enable_trace": true

    }
}'

返回

data: {"id":"as-njfdmmgvar","object":"chat.completion.chunk","created":1745505802,"model":"deepseek-v3","choices":[{"index":0,"delta":{"content":"正在搜索","role":"assistant"},"delta_tag":"search_status"}]}

data: {"id":"as-njfdmmgvar","object":"chat.completion.chunk","created":1745505802,"model":"deepseek-v3","choices":[{"index":0,"delta":{"content":"根据"},"flag":0}],"search_results":[{"index":1,"url":"http://www.bilibili.com/video/BV1UXq2YCENz","title":"今日足球比赛分析分享 希望视频对您有帮助 晚点会把详细数据发给大家"},{"index":2,"url":"http://www.bilibili.com/video/BV1bJBLYfEVt","title":"深度干货足球分析--今日比赛全解析,以及各种疑惑点的提醒"},{"index":3,"url":"http://tieba.baidu.com/p/9502614592","title":"今日足球看点"},{"index":4,"url":"http://weibo.com/tv/show/1034:5133355776409671","title":"今日足球:亚冠 欧冠、赛事前瞻!"},{"index":5,"url":"http://weibo.com/tv/show/1034:5133582331478031","title":"今日足球欧罗巴 欧会杯、赛事前瞻!"}]}

data: {"id":"as-njfdmmgvar","object":"chat.completion.chunk","created":1745505802,"model":"deepseek-v3","choices":[{"index":0,"delta":{"content":"搜索结果"},"flag":0}]}

data: {"id":"as-njfdmmgvar","object":"chat.completion.chunk","created":1745505802,"model":"deepseek-v3","choices":[{"index":0,"delta":{"content":"，以下是"},"flag":0}]}

data: {"id":"as-njfdmmgvar","object":"chat.completion.chunk","created":1745505802,"model":"deepseek-v3","choices":[{"index":0,"delta":{"content":"2025"},"flag":0}]}

data: {"id":"as-njfdmmgvar","object":"chat.completion.chunk","created":1745505802,"model":"deepseek-v3","choices":[{"index":0,"delta":{"content":"年4"},"flag":0}]}

data: {"id":"as-njfdmmgvar","object":"chat.completion.chunk","created":1745505802,"model":"deepseek-v3","choices":[{"index":0,"delta":{"content":"月24"},"flag":0}]}
......

data: {"id":"as-njfdmmgvar","object":"chat.completion.chunk","created":1745505802,"model":"deepseek-v3","choices":[{"index":0,"delta":{"content":"名称查询"},"flag":0}]}

data: {"id":"as-njfdmmgvar","object":"chat.completion.chunk","created":1745505802,"model":"deepseek-v3","choices":[{"index":0,"delta":{"content":"。"},"flag":0}]}

data: {"id":"as-njfdmmgvar","object":"chat.completion.chunk","created":1745505802,"model":"deepseek-v3","choices":[{"index":0,"delta":{"content":""},"finish_reason":"stop","flag":0}],"search_results":[{"index":1,"url":"http://www.bilibili.com/video/BV1UXq2YCENz","title":"今日足球比赛分析分享 希望视频对您有帮助 晚点会把详细数据发给大家"},{"index":2,"url":"http://www.bilibili.com/video/BV1bJBLYfEVt","title":"深度干货足球分析--今日比赛全解析,以及各种疑惑点的提醒"},{"index":3,"url":"http://tieba.baidu.com/p/9502614592","title":"今日足球看点"},{"index":4,"url":"http://weibo.com/tv/show/1034:5133355776409671","title":"今日足球:亚冠 欧冠、赛事前瞻!"},{"index":5,"url":"http://weibo.com/tv/show/1034:5133582331478031","title":"今日足球欧罗巴 欧会杯、赛事前瞻!"}]}

data: [DONE]

OpenAI SDK使用联网搜索

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

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={
    "safety":safety,
    "web_search":web_search
}

completion = client.chat.completions.create(
  model="ernie-3.5-8k",
  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="")
上一篇
结构化输出
下一篇
阅读助手插件

推荐文档

云服务器千帆大模型平台文字识别人脸识别实名认证介绍备案介绍财务功能概述