让模型响应基于实时网络数据——查询天气、股票价格、近期新闻等训练数据截止日期后的内容。
由于训练数据的时效性限制,大模型无法准确回答股票价格、明日天气等实时问题,启用联网搜索后,模型将基于实时检索数据回复。
除基础搜索外,联网搜索还支持以下高级功能。DashScope 协议支持所有功能;OpenAI 兼容协议(Chat Completions)不支持返回搜索来源、角标标注等功能。
通过
默认情况下,模型会自行判断是否联网。设置
仅 DashScope 协议支持返回搜索来源和角标标注。
设置
通过
通过
支持的模型:qwen3-max、qwen3-max-preview、qwen3-max-2025-09-23、qwen-plus、qwen-flash 及角色扮演模型。
通过
仅支持 DashScope 流式调用(不支持 OpenAI 兼容协议和 Java SDK)。在流式场景下,从获取搜索结果到生成首个 token 通常有 0.5 秒以上的延迟。设置
设置
联网搜索可与深度思考模式结合使用,适合行业趋势分析、多源信息整合等复杂任务。模型获取检索内容后先推理再生成回复,用户可观察推理路径。
支持联网搜索的深度思考模型
计费涉及两个方面:
如果调用失败,请参阅错误信息。
调用 API 前,请先获取 API Key 并将其设置为环境变量。
快速开始
- OpenAI 兼容 - Chat Completions
- OpenAI 兼容 - Responses API
- DashScope
通过
enable_search: true 参数启用联网搜索。Python SDK 通过 extra_body 传入,Node.js SDK 作为顶层参数传入。支持的模型
中国内地
中国内地
千问系列
2025 年 7 月后发布的 Qwen Max、Qwen Plus、Qwen Flash 模型自动支持联网搜索。第三方模型
| 模型系列 | 可用模型 |
|---|---|
| Qwen3.6 Max | qwen3.6-max-preview |
| Qwen3 Max | qwen3-max、qwen3-max-2025-09-23 及之后版本、qwen3-max-preview |
| Qwen3.6 Plus | qwen3.6-plus、qwen3.6-plus-2026-04-02 及之后版本(仅 Responses API) |
| Qwen3.5 Plus | qwen3.5-plus、qwen3.5-plus-2026-02-15 及之后版本 |
| Qwen3.6 Flash | qwen3.6-flash、qwen3.6-flash-2026-04-16 及之后版本(仅 Responses API) |
| Qwen3.5 Flash | qwen3.5-flash、qwen3.5-flash-2026-02-23 及之后版本 |
| Qwen Max | qwen-max、qwen-max-latest、qwen-max-2024-09-19 及之后版本 |
| Qwen Plus | qwen-plus、qwen-plus-latest、qwen-plus-2025-07-14 及之后版本 |
| Qwen Flash | qwen-flash、qwen-flash-2025-07-28 及之后版本 |
| Qwen Turbo | qwen-turbo、qwen-turbo-latest、qwen-turbo-2025-07-15 |
| QwQ | qwq-plus |
| Qwen Omni | qwen3.5-omni-plus、qwen3.5-omni-plus-2026-03-15、qwen3.5-omni-flash、qwen3.5-omni-flash-2026-03-15 |
| Qwen Omni Realtime | qwen3.5-omni-plus-realtime、qwen3.5-omni-plus-realtime-2026-03-15、qwen3.5-omni-flash-realtime、qwen3.5-omni-flash-realtime-2026-03-15 |
| 角色扮演 | qwen-plus-character、qwen-flash-character、qwen-flash-character-2026-02-26 |
| 提供商 | 可用模型 |
|---|---|
| DeepSeek | deepseek-v4-pro、deepseek-v4-flash、deepseek-v3.2、deepseek-v3.2-exp、deepseek-v3.1、deepseek-r1-0528、deepseek-r1、deepseek-v3 |
| Kimi | Moonshot-Kimi-K2-Instruct |
| MiniMax | MiniMax-M2.1 |
全球 / 国际
全球 / 国际
Qwen Plus:qwen3.6-plus、qwen3.6-plus-2026-04-02 及之后版本(仅 Responses API);qwen3.5-plus、qwen3.5-plus-2026-02-15 及之后版本Qwen Flash:qwen3.5-flash、qwen3.5-flash-2026-02-23 及之后版本;qwen3.6-flash、qwen3.6-flash-2026-04-16 及之后版本(仅 Responses API)国际站 qwen3-max 和 qwen3-max-2026-01-23 需将
search_strategy 设为 agent(非思考模式)或 agent_max(思考模式)。核心能力
除基础搜索外,联网搜索还支持以下高级功能。DashScope 协议支持所有功能;OpenAI 兼容协议(Chat Completions)不支持返回搜索来源、角标标注等功能。
| 功能 | DashScope | OpenAI 兼容-Chat | OpenAI 兼容-Responses |
|---|---|---|---|
| 基础联网搜索 | 支持 | 支持 | 支持 |
| 强制联网搜索 | 支持 | 支持 | 不支持 |
| 设置搜索量级策略 | 支持 | 支持 | 不支持 |
| 垂域搜索 | 支持 | 支持 | 不支持 |
| 搜索时效性 | 支持 | 支持 | 不支持 |
| 限定来源站点 | 支持 | 支持 | 不支持 |
| 自然语言控制检索范围 | 支持 | 支持 | 不支持 |
| 返回搜索来源 | 支持 | 不支持 | 不支持 |
| 角标引用标注 | 支持 | 不支持 | 不支持 |
| 提前返回搜索来源 | 支持 | 不支持 | 不支持 |
| 图文混合输出 | 支持 | 支持 | 不支持 |
搜索量级策略
通过 search_options 中的 search_strategy 字段控制搜索行为:
turbo(默认):兼顾响应速度与搜索效果,适用于大多数场景。max:调用多源搜索引擎,结果更详尽,响应时间更长。agent:多轮信息检索与整合,模型自主决定搜索时机和频次,适合复杂查询和英文场景。启用时仅支持enable_source,其他联网搜索功能不可用,每次调用额外收费。agent_max:在agent基础上支持网页全文阅读。仅 qwen3-max、qwen3-max-2026-01-23 思考模式可用,每次调用额外收费。
- OpenAI 兼容
- DashScope
Python
强制联网搜索
默认情况下,模型会自行判断是否联网。设置 forced_search: true 可强制执行搜索,适用于强依赖实时信息的场景。
- OpenAI 兼容
- DashScope
Python
获取搜索来源与引用标注
仅 DashScope 协议支持返回搜索来源和角标标注。
- 返回搜索来源:设置
enable_source: true,响应的search_info.search_results包含来源列表,每项含index、title、url。 - 角标标注:在
enable_source: true的前提下,设置enable_citation: true,回复正文中出现[1]等角标。 - 角标样式:通过
citation_format设置,可选"[<number>]"(默认)或"[ref_<number>]"。
垂域搜索
设置 enable_search_extension: true 可为天气、股票等结构化查询检索垂直领域数据,比通用搜索结果更精准。DashScope Java SDK 不支持此参数。
| 领域 | 说明 | 示例 |
|---|---|---|
| 天气 | 实时、未来及历史天气 | 杭州天气 |
| 股票 | A 股、港股、美股实时/历史行情 | 沪指昨天收盘点数 |
| 汇率 | 多币种最新汇率 | 人民币与美元的汇率 |
| 油价 | 全国各地最新汽柴油价格 | 杭州油价 |
| 万年历 | 农历、节气、吉凶宜忌 | 今天是农历几号 |
| 金价 / 银价 | 最新及历史行情 | 金价多少钱了 |
| 彩票 | 双色球、大乐透等开奖结果 | 最新一期双色球开奖结果 |
| 电视剧 / 电影 | 主流平台最新资讯 | 近期热播电视剧 |
| 车牌限行 | 根据车牌号查询当日限行 | 浙Axxxxxx,今天是否在杭州限行 |
| 足球赛事 | 英超、西甲等赛程与积分榜 | 英超现在哪支球队排名第一 |
- OpenAI 兼容
- DashScope
Python
搜索时效性
通过 freshness 参数限制搜索来源的时间范围,过滤超出范围的历史网页。仅对 search_strategy: turbo 生效。
可选值:7、30、180、365(天数);不设置则不限制时间范围。
支持的模型:qwen3-max、qwen3-max-preview、qwen3-max-2025-09-23、qwen-plus、qwen-flash、qwen-plus-character、qwen-flash-character、qwen-flash-character-2026-02-26
- OpenAI 兼容
- DashScope
Python
限定来源站点
通过 assigned_site_list 将搜索限定在指定网站列表,最多配置 25 个站点。仅对 search_strategy: turbo 生效。当指定站点内无相关内容时,模型将使用自身知识回答。
DashScope Java SDK 不支持此参数。
- OpenAI 兼容
- DashScope
Python
自然语言控制检索范围
通过 prompt_intervene 参数用自然语言引导搜索方向,适用于限定主题或地域的场景。
支持的模型:qwen3-max、qwen3-max-preview、qwen3-max-2025-09-23、qwen-plus、qwen-flash 及角色扮演模型。DashScope Java SDK 不支持此参数。
- OpenAI 兼容
- DashScope
Python
提前返回搜索来源
仅支持 DashScope 流式调用(不支持 OpenAI 兼容协议和 Java SDK)。在流式场景下,从获取搜索结果到生成首个 token 通常有 0.5 秒以上的延迟。设置 prepend_search_result: true 可在获取到搜索结果后立刻将其作为首个数据包返回,降低首包延时。
Python
图文混合输出
设置 enable_text_image_mixed: true 可让模型在回复中嵌入相关图片(以 HTML <img> 标签形式)。此参数与 enable_search 相互独立,无需同时启用。DashScope Java SDK 不支持此参数。
支持的模型:qwen-max、qwen-plus-latest、qwen-flash
- OpenAI 兼容
- DashScope
Python
深度思考 + 联网搜索
联网搜索可与深度思考模式结合使用,适合行业趋势分析、多源信息整合等复杂任务。模型获取检索内容后先推理再生成回复,用户可观察推理路径。
支持联网搜索的深度思考模型
- 千问:qwen3-max、qwen3-max-2026-01-23、qwen3-max-preview、qwen-plus、qwen-plus-latest、qwen-flash、qwen-turbo、qwq-plus
- DeepSeek:deepseek-v4-pro、deepseek-v4-flash、deepseek-v3.2、deepseek-v3.2-exp、deepseek-v3.1、deepseek-r1-0528、deepseek-r1
计费
计费涉及两个方面:
- 模型调用费用:联网搜索获取的网页内容会追加到 prompt 中,增加输入 token 数量,按模型标准价格计费。详见计费说明。
-
搜索调用费用(每 1,000 次):
策略( search_strategy)功能 费用 turbo(默认)兼顾速度与效果 3元 max多源搜索,结果更全面 4元 agent多轮检索与信息整合 4元 agent_max搜索 + 网页提取器阅读全文 搜索 4元;网页抓取限时免费

