大模型如何連網搜尋 - Alibaba Cloud Model Studio

大模型的訓練資料存在知識到期日，無法回答即時問題。啟用連網搜尋後，模型可從網路擷取即時資料，準確回答股票價格、天氣預報、最新新聞等時效性問題。

使用方式

連網搜尋支援以下三種API調用方式，啟用參數各有不同：

OpenAI 相容-Responses API

通過 tools 參數添加 web_search 工具即可啟用連網搜尋。

Responses API 僅支援部分模型，支援的模型請參見Responses API的連網搜尋。

# 匯入依賴與建立用戶端...
response = client.responses.create(
    model="qwen3.8-max",
    input="杭州天氣",
    tools=[
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    extra_body={"enable_thinking": True}
)

OpenAI 相容-Chat Completions API

設定 enable_search: true 即可啟用連網搜尋。

# 匯入依賴與建立用戶端...
completion = client.chat.completions.create(
    # 需使用支援連網搜尋的模型
    model="qwen-plus",
    messages=[{"role": "user", "content": "杭州明天天氣如何"}],
    # 由於 enable_search 非 OpenAI 標準參數，使用 Python SDK 需要通過 extra_body 傳入（使用Node.js SDK 需作為頂層參數傳入）
    extra_body={"enable_search": True}
)

DashScope

設定 enable_search: true 即可啟用連網搜尋。

# 匯入依賴...
response = dashscope.Generation.call(
    # 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 需使用支援連網搜尋的模型
    model="qwen-plus",
    messages=[{"role": "user", "content": "杭州明天天氣如何"}],
    # 通過 enable_search 參數開啟連網搜尋
    enable_search=True,
    result_format="message"
)

多模態模型的連網搜尋

Qwen3.8 系列、Qwen3.7-Flash、Qwen3.7-Plus、Qwen3.6 系列、Qwen3.5 系列（含 qwen3.5-plus、qwen3.5-flash、qwen3.5-omni 系列與千問開源模型）等模型支援圖片、視頻等多模態輸入，屬於多模態模型。

搜尋策略因系列而異：qwen3.5-omni 系列僅支援 agent 策略；Qwen3.8 系列不支援 agent 策略（使用預設的 turbo 或 max）；其餘模型支援 turbo、max、agent 策略。這類模型需通過多模態介面（multimodal-generation 端點）調用：Python 與 Java 使用 MultiModalConversation，而不能使用面向純文字模型的 Generation（text-generation 端點）。多模態模型的基礎調用方式可參見《視覺推理》《映像與視頻理解》文檔。

若使用 Generation（text-generation 端點）調用上述多模態模型，會返回 400 url error, please check url，請改用 MultiModalConversation（multimodal-generation 端點）。Java SDK 的 MultiModalConversationParam 提供 enableSearch(true) 用於開啟連網搜尋，但未提供 searchOptions() 方法，需通過通用參數 parameter("search_options", ...) 注入搜尋策略等配置；Python 的 MultiModalConversation.call 可直接傳入 search_options。多模態模型開啟連網搜尋時需使用流式調用（Java 使用 streamCall，Python 設定 stream=True），否則會返回 Non-streaming mode does not support Web Search 報錯。

Python

import os
import dashscope
from dashscope import MultiModalConversation
# 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
dashscope.base_http_api_url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"
responses = MultiModalConversation.call(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 需使用支援連網搜尋的多模態模型
    model="qwen3.5-plus",
    messages=[{"role": "user", "content": [{"text": "杭州今天天氣如何"}]}],
    # 多模態介面可直接傳入 enable_search 與 search_options
    enable_search=True,
    search_options={
        # qwen3.5-omni 系列需設為 agent；Qwen3.8 系列不支援 agent，保持預設即可
        "search_strategy": "agent",
        "enable_source": True,
    },
    # 多模態模型開啟連網搜尋時需使用流式調用
    stream=True,
    incremental_output=True,
)
for response in responses:
    print(response.output.choices[0].message.content)

Java

// dashscope SDK 版本 >= 2.19.0
import java.util.Arrays;
import java.util.Collections;
import io.reactivex.Flowable;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversation;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationParam;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationResult;
import com.alibaba.dashscope.aigc.generation.SearchOptions;
import com.alibaba.dashscope.common.MultiModalMessage;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.utils.Constants;

public class Main {
    // 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
    static { Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"; }
    public static void main(String[] args) throws Exception {
        MultiModalConversation conv = new MultiModalConversation();
        MultiModalMessage userMsg = MultiModalMessage.builder()
                .role(Role.USER.getValue())
                .content(Arrays.asList(Collections.singletonMap("text", "杭州今天天氣如何")))
                .build();
        SearchOptions searchOptions = SearchOptions.builder()
                // 多模態模型的連網搜尋策略需設為 agent
                .searchStrategy("agent")
                .enableSource(true)
                .build();
        MultiModalConversationParam param = MultiModalConversationParam.builder()
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // 需使用支援連網搜尋的多模態模型
                .model("qwen3.5-plus")
                .messages(Arrays.asList(userMsg))
                // 原生方法：開啟連網搜尋
                .enableSearch(true)
                // MultiModalConversationParam 未提供 searchOptions() 方法，需通過通用 parameter() 注入 search_options
                .parameter("search_options", searchOptions)
                .incrementalOutput(true)
                .build();
        // 多模態模型開啟連網搜尋時需使用流式調用
        Flowable<MultiModalConversationResult> result = conv.streamCall(param);
        result.blockingForEach(message ->
                System.out.print(message.getOutput().getChoices().get(0).getMessage().getContent()));
    }
}

支援的模型

支援連網搜尋的模型如下。支援多模態輸入的模型（Qwen3.8 系列、Qwen3.7-Flash/Plus、Qwen3.6 系列、Qwen3.5 系列及千問開源模型等）需透過多模態介面調用，參見多模態模型的連網搜尋。

新加坡

千問
- Qwen3.8 系列：qwen3.8-max、qwen3.8-max-0902、qwen3.8-flash、qwen3.8-2.4t-a95b、qwen3.8-27b（不支援 agent 策略）
- Qwen3.7 系列：qwen3.7-max、qwen3.7-max-preview、qwen3.7-max-2026-05-17及之後的快照版本、qwen3.7-plus、qwen3.7-plus-2026-05-26及之後的快照版本、qwen3.7-flash、qwen3.7-flash-2026-07-15及之後的快照版本
- Qwen3.6 系列：qwen3.6-max-preview、qwen3.6-plus、qwen3.6-plus-2026-04-02及之後的快照版本、qwen3.6-flash、qwen3.6-flash-2026-04-16及之後的快照版本、qwen3.6-27b、qwen3.6-35b-a3b
- Qwen3.5 系列：qwen3.5-plus、qwen3.5-plus-2026-02-15及之後的快照版本、qwen3.5-flash、qwen3.5-flash-2026-02-23及之後的快照版本、qwen3.5-27b、qwen3.5-35b-a3b、qwen3.5-122b-a10b、qwen3.5-397b-a17b
- Qwen3-Max：qwen3-max、qwen3-max-2025-09-23及之後的快照版本
- 千问Omni：qwen3.5-omni-plus、qwen3.5-omni-plus-2026-03-15、qwen3.5-omni-flash、qwen3.5-omni-flash-2026-03-15（搜尋策略需設為 agent）
- 千问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（搜尋策略需設為 agent）
第三方模型
- DeepSeek：deepseek-v4-pro、deepseek-v4-pro-0813、deepseek-v4-flash、deepseek-v4-flash-0731、deepseek-v3.2（其中 deepseek-v4 系列同時支援Responses API）
- GLM：glm-5.2（僅支援透過Responses API連網搜尋）
- Kimi：kimi-k3（僅支援透過Responses API連網搜尋）

華北2（北京）

千問
- Qwen3.8 系列：qwen3.8-max、qwen3.8-max-0902、qwen3.8-flash、qwen3.8-2.4t-a95b、qwen3.8-27b（不支援 agent 策略）
- Qwen3.7 系列：qwen3.7-max、qwen3.7-max-2026-05-20及之後的快照版本、qwen3.7-plus、qwen3.7-plus-2026-05-26及之後的快照版本、qwen3.7-flash、qwen3.7-flash-2026-07-15及之後的快照版本
- Qwen3.6 系列：qwen3.6-max-preview、qwen3.6-plus、qwen3.6-plus-2026-04-02及之後的快照版本、qwen3.6-flash、qwen3.6-flash-2026-04-16及之後的快照版本、qwen3.6-27b、qwen3.6-35b-a3b
- Qwen3.5 系列：qwen3.5-plus、qwen3.5-plus-2026-02-15及之後的快照版本、qwen3.5-flash、qwen3.5-flash-2026-02-23及之後的快照版本、qwen3.5-27b、qwen3.5-35b-a3b、qwen3.5-122b-a10b、qwen3.5-397b-a17b
- Qwen3-Max：qwen3-max、qwen3-max-2025-09-23及之後的快照版本
- Qwen-Max：qwen-max及之後的快照版本
- 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
- QwQ：qwq-plus（僅支援預設搜尋策略，不能設定 search_strategy）
- 千问Omni：qwen3.5-omni-plus、qwen3.5-omni-plus-2026-03-15、qwen3.5-omni-flash、qwen3.5-omni-flash-2026-03-15（搜尋策略需設為 agent）
- 千问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（搜尋策略需設為 agent）
- 角色扮演：qwen-plus-character、qwen-flash-character（不支援 agent 策略）
2025 年 7 月後發布的千問Max、千問Plus、千問Flash 模型都自動支援連網搜尋。
第三方模型
- DeepSeek：deepseek-v4-pro、deepseek-v4-pro-0813、deepseek-v4-flash、deepseek-v4-flash-0731、deepseek-v3.2、deepseek-v3.2-exp、deepseek-v3.1、deepseek-r1-0528、deepseek-r1、deepseek-v3（其中 deepseek-v4 系列同時支援Responses API）
- GLM：glm-5.2（僅支援透過Responses API連網搜尋）
- Kimi：Moonshot-Kimi-K2-Instruct、kimi-k3（kimi-k3 僅支援透過Responses API連網搜尋）

快速開始

以下樣本通過連網搜尋查詢股票資訊。

OpenAI 相容

OpenAI 相容協議不支援在響應中返回搜尋來源。

Python

import os
from openai import OpenAI

client = OpenAI(
    # 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)
completion = client.chat.completions.create(
    model="qwen-plus",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "阿里巴巴股價如何"},
    ],
    extra_body={
        "enable_search": True,
        "search_options": {
            # 連網搜尋策略，僅支援配置為 agent
            "search_strategy": "agent"
        }
    }
)
print(completion.choices[0].message.content)

響應樣本

根據最新的市場資料，阿里巴巴的股價在不同市場表現如下：

*   **美股 (BABA)**：最新股價約為 **159.84 美元**。
*   **港股 (09988.HK)**：最新股價約為 **158.00 港元**。

請注意，股價會即時波動，以上資訊僅供參考。根據最新的市場資料，阿里巴巴的股價在不同市場表現如下：

*   **美股 (BABA)**：最新股價約為 **159.84 美元**。
*   **港股 (09988.HK)**：最新股價約為 **158.00 港元**。

請注意，股價會即時波動，以上資訊僅供參考。

Node.js

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: process.env.DASHSCOPE_API_KEY,
    // 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
    baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    const completion = await openai.chat.completions.create({
        model: "qwen-plus",
        messages: [
            { role: "user", content: "阿里巴巴股價如何" }
        ],
        enable_search: true,
        search_options: {
            // 連網搜尋策略，僅支援配置為 agent
            search_strategy: "agent"
        }
    });
    console.log(completion.choices[0].message.content);
}

main();

響應樣本

根據最新的市場資料，阿里巴巴的股價在不同市場表現如下：

*   **美股 (BABA)**：最新股價約為 **159.84 美元**。
*   **港股 (09988.HK)**：最新股價約為 **158.00 港元**。

請注意，股價會即時波動，以上資訊僅供參考。根據最新的市場資料，阿里巴巴的股價在不同市場表現如下：

*   **美股 (BABA)**：最新股價約為 **159.84 美元**。
*   **港股 (09988.HK)**：最新股價約為 **158.00 港元**。

請注意，股價會即時波動，以上資訊僅供參考。

curl

# 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-plus",
    "messages": [
        {
            "role": "user",
            "content": "阿里巴巴股價如何"
        }
    ],
    "enable_search": true,
    "search_options": {
        "search_strategy": "agent"
    }
}'

DashScope

DashScope 協議支援設定 enable_source 為 true ，使返回資料中包含搜尋來源。

Python

import os
import dashscope
# 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
dashscope.base_http_api_url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"

response = dashscope.Generation.call(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    model="qwen-plus",
    messages=[{"role": "user", "content": "阿里巴巴股價"}],
    enable_search=True,
    search_options={
        # 連網搜尋策略，目前僅支援 agent 策略：可多次調用連網搜尋工具與大模型，實現多輪資訊檢索與內容整合
        "search_strategy": "agent",
        "enable_source": True # 是否返回搜尋來源
    },
    result_format="message",
)
print("="*20 + "搜尋結果" + "="*20)
for web in response.output.search_info["search_results"]:
    print(f"[{web['index']}]: [{web['title']}]({web['url']})")
print("="*20 + "回複內容" + "="*20)
print(response.output.choices[0].message.content)

響應樣本

====================搜尋結果====================
[1]: [阿里巴巴(BABA)股票價格_行情_走勢圖 - 東方財富](https://wap.eastmoney.com/quote/stock/106.BABA.html)
[2]: [阿里巴巴(BABA)_美股行情_今日股價與走勢圖_新浪財經](https://gu.sina.cn/quotes/us/BABA)
[3]: [阿里巴巴(BABA)股票最新價格行情,即時走勢圖,股價分析預測](https://cn.investing.com/equities/alibaba)
[4]: [阿里巴巴－W (9988.HK) 股價、新聞、報價和記錄 - Yahoo 財經](https://hk.finance.yahoo.com/quote/9988.HK/)
[5]: [阿里巴巴(BABA)股票股價_股價行情_討論 - 雪球](https://xueqiu.com/S/BABA)
[6]: [阿里巴巴(BABA)股票股價, 市值, 即時行情, 走勢圖, 財報- Moomoo](https://www.moomoo.com/hans/stock/BABA-US)
[7]: [Alibaba Group Holding Limited (BABA) Stock Price, News, Quote ...](https://finance.yahoo.com/quote/BABA/)
[8]: [阿里巴巴 - 騰訊證券](https://gu.qq.com/usBABA.N)
[9]: [W(09988)股票股價, 市值, 即時行情, 走勢圖, 財報- 阿里巴巴 - Moomoo](https://www.moomoo.com/hans/stock/09988-HK)
====================回複內容====================
根據最新的市場資料，阿里巴巴的股價資訊如下：

*   **美股 (BABA)**：
    *   今日開盤價：160.98美元
    *   昨日收盤價：160.80美元
    *   今日最高價：161.19美元
    *   今日最低價：156.20美元

*   **港股 (09988.HK)**：
    *   最新報價約為：158.00 - 158.10港元
    *   今日開盤價：156.50港元
    *   前一交易日收盤價：162.00港元
    *   今日波動範圍：156.30 - 158.40港元

Java

import com.alibaba.dashscope.aigc.generation.Generation;
import com.alibaba.dashscope.aigc.generation.GenerationParam;
import com.alibaba.dashscope.aigc.generation.GenerationResult;
import com.alibaba.dashscope.aigc.generation.SearchOptions;
import com.alibaba.dashscope.common.Message;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.common.Role;
import java.util.Arrays;

public class Main {
    // 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
    static {Constants.baseHttpApiUrl="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";}
    public static void main(String[] args) {
        Generation gen = new Generation();
        Message userMsg = Message.builder()
                .role(Role.USER.getValue())
                .content("阿里巴巴的股價")
                .build();

        SearchOptions searchOptions = SearchOptions.builder()
                // 連網搜尋策略，僅支援配置為 agent
                .searchStrategy("agent")
                // 返回搜尋來源
                .enableSource(true)
                .build();

        GenerationParam param = GenerationParam.builder()
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .model("qwen3-max")
                .messages(Arrays.asList(userMsg))
                .resultFormat(GenerationParam.ResultFormat.MESSAGE)
                .enableSearch(true)
                .searchOptions(searchOptions)
                .build();
        try {
            GenerationResult result = gen.call(param);
            System.out.println("=".repeat(20)+"搜尋結果"+"=".repeat(20));
            System.out.println(result.getOutput().getSearchInfo().getSearchResults());
            System.out.println("=".repeat(20)+"回複內容"+"=".repeat(20));
            System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent());
        } catch (Exception e) {
            System.out.println("Error: " + e.getMessage());
        }
    }
}

響應樣本

====================搜尋結果====================
[SearchInfo.SearchResult(siteName=null, icon=null, index=1, title=阿里巴巴(BABA)股票價格_行情_走勢圖 - 東方財富, url=https://wap.eastmoney.com/quote/stock/106.BABA.html), SearchInfo.SearchResult(siteName=null, icon=null, index=2, title=阿里巴巴(BABA)_美股行情_今日股價與走勢圖_新浪財經, url=https://gu.sina.cn/quotes/us/BABA), SearchInfo.SearchResult(siteName=null, icon=null, index=3, title=阿里巴巴(BABA)股票最新價格行情,即時走勢圖,股價分析預測, url=https://cn.investing.com/equities/alibaba), SearchInfo.SearchResult(siteName=null, icon=null, index=4, title=阿里巴巴(BABA)股票股價_股價行情_討論 - 雪球, url=https://xueqiu.com/S/BABA), SearchInfo.SearchResult(siteName=null, icon=null, index=5, title=阿里巴巴－W (9988.HK) 股價、新聞、報價和記錄 - Yahoo 財經, url=https://hk.finance.yahoo.com/quote/9988.HK/), SearchInfo.SearchResult(siteName=null, icon=null, index=6, title=阿里巴巴(BABA)股票股價, 市值, 即時行情, 走勢圖, 財報- Moomoo, url=https://www.moomoo.com/hans/stock/BABA-US), SearchInfo.SearchResult(siteName=null, icon=null, index=7, title=Alibaba Group Holding Limited (BABA) - Yahoo Finance, url=https://finance.yahoo.com/quote/BABA/), SearchInfo.SearchResult(siteName=null, icon=null, index=8, title=阿里巴巴 - 騰訊證券, url=https://gu.qq.com/usBABA.N), SearchInfo.SearchResult(siteName=null, icon=null, index=9, title=W(09988)股票股價, 市值, 即時行情, 走勢圖, 財報- 阿里巴巴 - Moomoo, url=https://www.moomoo.com/hans/stock/09988-HK)]
====================回複內容====================
根據最新的市場資料，阿里巴巴的股價如下：

*   **美股 (BABA)**：最新股價約為 **159.84 美元**。
*   **港股 (09988.HK)**：最新股價約為 **158.00 港元**。

請注意，股價會隨市場交易即時波動，以上資訊僅供參考。

curl

# 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-plus",
    "input":{
        "messages":[
            {
                "role": "user",
                "content": "阿里巴巴的股價"
            }
        ]
    },
    "parameters": {
        "enable_search": true,
        "search_options": {
            "search_strategy": "agent",
            "enable_source": true
        },
        "result_format": "message"
    }
}'

響應樣本

{
  "output": {
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "content": "根據最新的市場資料，阿里巴巴的股價因其在美股和港股同時上市而有所不同：\n\n*   **美股 (BABA)**：最新股價約為 **160.40 美元**。\n    *   今日開盤價：160.98 美元\n    *   今日波動範圍：156.20 - 161.19 美元\n\n*   **港股 (09988.HK)**：最新股價約為 **158.10 港元**。\n    *   今日開盤價：156.50 港元\n    *   今日波動範圍：156.30 - 158.40 港元\n\n請注意，股價會隨市場交易即時變動，以上資訊僅供參考。",
          "role": "assistant"
        }
      }
    ],
    "search_info": {
      "search_results": [
        {
          "index": 1,
          "title": "阿里巴巴(BABA)股票價格_行情_走勢圖 - 東方財富",
          "url": "https://wap.eastmoney.com/quote/stock/106.BABA.html"
        },
        {
          "index": 2,
          "title": "阿里巴巴(BABA)_美股行情_今日股價與走勢圖_新浪財經",
          "url": "https://gu.sina.cn/quotes/us/BABA"
        },
        {
          "index": 3,
          "title": "阿里巴巴－W (9988.HK) 股價、新聞、報價和記錄 - Yahoo 財經",
          "url": "https://hk.finance.yahoo.com/quote/9988.HK/"
        },
        {
          "index": 4,
          "title": "阿里巴巴(BABA)股票最新價格行情,即時走勢圖,股價分析預測",
          "url": "https://cn.investing.com/equities/alibaba"
        },
        {
          "index": 5,
          "title": "阿里巴巴(BABA)股票股價_股價行情_討論 - 雪球",
          "url": "https://xueqiu.com/S/BABA"
        },
        {
          "index": 6,
          "title": "阿里巴巴(BABA)股票股價, 市值, 即時行情, 走勢圖, 財報- Moomoo",
          "url": "https://www.moomoo.com/hans/stock/BABA-US"
        },
        {
          "index": 7,
          "title": "W(09988)股票股價, 市值, 即時行情, 走勢圖, 財報- 阿里巴巴 - Moomoo",
          "url": "https://www.moomoo.com/hans/stock/09988-HK"
        },
        {
          "index": 8,
          "title": "Alibaba Group Holding Limited (BABA) 股價、新聞、報價和記錄",
          "url": "https://hk.finance.yahoo.com/quote/BABA/"
        },
        {
          "index": 9,
          "title": "阿里巴巴 - 騰訊證券",
          "url": "https://gu.qq.com/usBABA.N"
        }
      ]
    }
  },
  "usage": {
    "input_tokens": 2004,
    "output_tokens": 203,
    "plugins": {
      "search": {
        "count": 1,
        "strategy": "agent"
      }
    },
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "total_tokens": 2207
  },
  "request_id": "45c231d2-811e-4e04-a361-f2c1909f1dd9"
}

Responses API的連網搜尋

通過 tools 參數的tools數組中添加 web_search 工具即可啟用連網搜尋。

支援以下模型：Qwen3.8、Qwen3.7、Qwen3.5 系列模型（含開源模型，不含Omni）、Qwen3.6-Plus、Qwen3.6-Flash 系列及 qwen3.6-35b-a3b；qwen3-max、qwen3-max-2026-01-23；deepseek-v4-flash、deepseek-v4-flash-0731、deepseek-v4-pro、deepseek-v4-pro-0813；glm-5.2；kimi-k3。

為了獲得最佳回複效果，建議同時開啟 web_search 、 web_extractor 和 code_interpreter 工具。

關於Responses API的使用說明、程式碼範例和遷移指南，請參見 OpenAI相容-Responses 。

python

from openai import OpenAI
import os

client = OpenAI(
    # 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)

response = client.responses.create(
    model="qwen3.7-max",
    input="新加坡天氣",
    tools=[
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    extra_body={"enable_thinking": True}
)

print("="*20 + "回複內容" + "="*20)
print(response.output_text)

print("="*20 + "工具調用次數" + "="*20)
usage = response.usage
if hasattr(usage, 'x_tools') and usage.x_tools:
    print(f"連網搜尋次數: {usage.x_tools.get('web_search', {}).get('count', 0)}")
# 取消以下注釋查看中間過程的輸出
# for r in response.output:
#     print(r.model_dump_json())

javascript

import OpenAI from "openai";

const openai = new OpenAI({
    // 若沒有配置環境變數，請用百鍊API Key將下行替換為：apiKey: "sk-xxx",
    apiKey: process.env.DASHSCOPE_API_KEY,
    // 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
    baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    const response = await openai.responses.create({
        model: "qwen3.7-max",
        input: "新加坡天氣",
        tools: [
            { type: "web_search" },
            { type: "web_extractor" },
            { type: "code_interpreter" }
        ],
        enable_thinking: true
    });

    console.log("====================回複內容====================");
    console.log(response.output_text);

    console.log("====================工具調用次數====================");
    console.log(`連網搜尋次數: ${response.usage?.x_tools?.web_search?.count || 0}`);

    // console.log(JSON.stringify(response.output[0], null, 2));
}

main();

bash

# 以下為新加坡地區配置，調用時請將 {WorkspaceId} 替換為真實的業務空間ID，各地區的配置不同。
curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/responses \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3.7-max",
    "input": "新加坡天氣",
    "tools": [
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    "enable_thinking": true
}'

擷取搜尋來源

執行連網搜尋後，搜尋來源會在響應的 output 數組中 type 為 web_search_call 的元素內返回，其 action.sources 欄位為搜尋來源連結清單。可在上述樣本的 response 基礎上按如下方式提取：

Responses API 暫不支援 enable_source、enable_citation、citation_format 參數，不會在回複內容中自動插入 [1] 角標。如需角標標註，請使用 DashScope 調用方式。

# 在上述 response 的基礎上提取搜尋來源
print("=" * 20 + "搜尋來源" + "=" * 20)
for item in response.output:
    if item.type == "web_search_call":
        for i, source in enumerate(item.action.sources, start=1):
            print(f"[{i}] {source.url}")

計費說明

說明本文所述“連網搜尋”為模型內建的連網搜尋功能，其計費如下方所示，本身不提供免費調用額度。它與百鍊 MCP 廣場提供的“連網搜尋 MCP”服務是相互獨立的兩個功能，計費也相互獨立：連網搜尋 MCP 全部使用者前 2000 次調用免費，免費額度用盡後按 29 元/千次計費，詳情請參見添加連網搜尋MCP。

連網搜尋的費用包含兩部分：

模型調用費用：連網搜尋的網頁內容會拼接到提示詞中，增加模型的輸入 Token，按照模型的標準價格計費。價格詳情請參考百鍊控制台。使用 Responses API方式時，連網搜尋工具的計費和agent 策略相同。
搜尋策略費用：
- agent 策略：
  - 每調用 1000 次的費用為：
    - 華北2（北京）地區：$0.573411
    - 新加坡地區 $10.00。
- agent_max 策略（限時優惠）：
  包含連網搜尋與網頁抓取的費用。
  - 連網搜尋工具每 1000 次調用費用：
    - 華北2（北京）地區：$0.573411。
    - 新加坡地區：$10.00。
  - 網頁抓取工具限時免費。

Q：連網搜尋後模型返回“無法回答”或無響應？

A：連網搜尋結果可能包含管控資訊，觸發Alibaba Content Security Service規則，導致模型返回 DataInspectionFailed 錯誤 (HTTP 400)，響應內容為“抱歉，我無法回答這個問題”。排查方法：關閉連網搜尋後重新發送相同查詢，若模型正常回複，則確認是搜尋返回的內容觸發了攔截。Alibaba Content Security Service攔截為非確定性行為，取決於搜尋返回的具體內容，並非所有敏感話題查詢都會觸發。

錯誤資訊

如果執行報錯，請參見錯誤碼進行解決。