Tambahkan pencarian web real-time ke model Qwen melalui API - Model Studio

Karena model bahasa besar dilatih pada dataset statis, model tersebut tidak dapat menjawab pertanyaan real-time—seperti harga saham atau cuaca besok—secara akurat. Saat Anda mengaktifkan fitur pencarian web, model akan mengambil dan merespons menggunakan informasi terkini dari web.

Penggunaan

Fitur pencarian web mendukung tiga metode pemanggilan, masing-masing dengan parameter berbeda untuk mengaktifkannya:

Kompatibel dengan OpenAI—API Responses

Untuk mengaktifkan fitur pencarian web, tambahkan tool web_search ke parameter tools.

API Responses hanya mendukung Qwen3.5, qwen3-max, qwen3-max-2026-01-23.

Untuk respons optimal, aktifkan tool web_search, web_extractor, dan code_interpreter secara bersamaan.

# Impor dependensi dan buat klien...
response = client.responses.create(
    model="qwen3-max-2026-01-23",
    input="Hangzhou weather",
    tools=[
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    extra_body={"enable_thinking": True}
)

Kompatibel dengan OpenAI—API Chat Completions

Teruskan parameter enable_search: true untuk mengaktifkan pencarian web.

# Impor dependensi dan buat klien...
completion = client.chat.completions.create(
    # Gunakan model yang mendukung pencarian web
    model="qwen3-max",
    messages=[{"role": "user", "content": "What will Hangzhou's weather be like tomorrow?"}],
    # Karena enable_search bukan parameter standar OpenAI, gunakan extra_body dengan Python SDK (gunakan parameter tingkat atas dengan Node.js SDK)
    extra_body={"enable_search": True}
)

DashScope

Teruskan parameter enable_search: true untuk mengaktifkan pencarian web.

# Impor dependensi...
response = dashscope.Generation.call(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Gunakan model yang mendukung pencarian web
    model="qwen3-max",
    messages=[{"role": "user", "content": "What will Hangzhou's weather be like tomorrow?"}],
    # Aktifkan pencarian web melalui parameter enable_search
    enable_search=True,
    result_format="message"
)

Model yang didukung

Internasional

Qwen Plus: qwen3.5-plus, qwen3.5-plus-2026-02-15 dan snapshot selanjutnya
Kedua mode thinking dan non-thinking mendukung strategi pencarian agent dan agent_max.
Qwen Flash: qwen3.5-flash, qwen3.5-flash-2026-02-23 dan snapshot selanjutnya
Kedua mode thinking dan non-thinking mendukung strategi pencarian agent dan agent_max.
qwen3-max dan qwen3-max-2026-01-23:
- Mode non-thinking: Atur strategi pencarian ke agent.
- Mode thinking: Atur strategi pencarian ke agent atau agent_max. Strategi agent_max mendukung web extractor selain strategi agent.
qwen3-max-2025-09-23: Atur strategi pencarian ke agent.

Global

Qwen Plus: qwen3.5-plus, qwen3.5-plus-2026-02-15 dan snapshot selanjutnya
Qwen Flash: qwen3.5-flash, qwen3.5-flash-2026-02-23 dan snapshot selanjutnya

Model-model di atas mendukung strategi pencarian agent dan agent_max dalam kedua mode thinking dan non-thinking.

Tiongkok daratan

Qwen Plus: qwen3.5-plus, qwen3.5-plus-2026-02-15 dan snapshot selanjutnya
Kedua mode thinking dan non-thinking mendukung strategi pencarian agent dan agent_max.
Qwen Flash: qwen3.5-flash, qwen3.5-flash-2026-02-23 dan snapshot selanjutnya
Kedua mode thinking dan non-thinking mendukung strategi pencarian agent dan agent_max.
qwen3-max dan qwen3-max-2026-01-23:
- Mode non-thinking: Atur strategi pencarian ke agent.
- Mode thinking: Atur strategi pencarian ke agent atau agent_max. Strategi agent_max mendukung web extractor selain strategi agent.
qwen3-max-2025-09-23: Atur strategi pencarian ke agent.

Mulai cepat

Jalankan kode berikut untuk langsung menanyakan informasi saham menggunakan layanan pencarian web.

Kompatibel dengan OpenAI

Protokol kompatibel dengan OpenAI tidak mendukung pengembalian sumber pencarian dalam respons.

Python

import os
from openai import OpenAI

client = OpenAI(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)
completion = client.chat.completions.create(
    model="qwen3-max",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "How is Alibaba's stock price?"},
    ],
    extra_body={
        "enable_search": True,
        "search_options": {
            # Strategi pencarian web; hanya agent yang didukung
            "search_strategy": "agent"
        }
    }
)
print(completion.choices[0].message.content)

Contoh respons

Menurut data pasar terbaru, harga saham Alibaba di berbagai pasar adalah sebagai berikut:

*   **Saham AS (BABA)**: Harga terbaru sekitar **$159,84**.
*   **Saham HK (09988.HK)**: Harga terbaru sekitar **HK$158,00**.

Perlu diperhatikan bahwa harga saham berfluktuasi secara real-time, dan informasi ini hanya untuk referensi. Menurut data pasar terbaru, harga saham Alibaba di berbagai pasar adalah sebagai berikut:

*   **Saham AS (BABA)**: Harga terbaru sekitar **$159,84**.
*   **Saham HK (09988.HK)**: Harga terbaru sekitar **HK$158,00**.

Perlu diperhatikan bahwa harga saham berfluktuasi secara real-time, dan informasi ini hanya untuk referensi.

Node.js

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: process.env.DASHSCOPE_API_KEY,
    baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    const completion = await openai.chat.completions.create({
        model: "qwen3-max",
        messages: [
            { role: "user", content: "How is Alibaba's stock price?" }
        ],
        enable_search: true,
        search_options: {
            // Strategi pencarian web; hanya agent yang didukung
            search_strategy: "agent"
        }
    });
    console.log(completion.choices[0].message.content);
}

main();

Contoh respons

Menurut data pasar terbaru, harga saham Alibaba di berbagai pasar adalah sebagai berikut:

*   **Saham AS (BABA)**: Harga terbaru sekitar **$159,84**.
*   **Saham HK (09988.HK)**: Harga terbaru sekitar **HK$158,00**.

Perlu diperhatikan bahwa harga saham berfluktuasi secara real-time, dan informasi ini hanya untuk referensi. Menurut data pasar terbaru, harga saham Alibaba di berbagai pasar adalah sebagai berikut:

*   **Saham AS (BABA)**: Harga terbaru sekitar **$159,84**.
*   **Saham HK (09988.HK)**: Harga terbaru sekitar **HK$158,00**.

Perlu diperhatikan bahwa harga saham berfluktuasi secara real-time, dan informasi ini hanya untuk referensi.

curl

curl -X POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3-max",
    "messages": [
        {
            "role": "user", 
            "content": "How is Alibaba's stock price?"
        }
    ],
    "enable_search": true,
    "search_options": {
        "search_strategy": "agent"
    }
}'

DashScope

Protokol DashScope mendukung pengaturan enable_source ke true untuk menyertakan sumber pencarian dalam respons.

Python

import os
import dashscope
dashscope.base_http_api_url = "https://dashscope-intl.aliyuncs.com/api/v1"

response = dashscope.Generation.call(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    model="qwen3-max",
    messages=[{"role": "user", "content": "Alibaba stock price"}],
    enable_search=True,
    search_options={
        # Strategi pencarian web; saat ini hanya agent yang didukung: mengaktifkan beberapa putaran pencarian web dan panggilan LLM untuk pengambilan dan integrasi informasi secara iteratif
        "search_strategy": "agent",
        "enable_source": True # Apakah akan mengembalikan sumber pencarian
    },
    result_format="message",
)
print("="*20 + "Hasil pencarian" + "="*20)
for web in response.output.search_info["search_results"]:
    print(f"[{web['index']}]: [{web['title']}]({web['url']})")
print("="*20 + "Konten respons" + "="*20)
print(response.output.choices[0].message.content)

Contoh respons

====================Hasil pencarian====================
[1]: [Harga Saham Alibaba (BABA), Kutipan, Grafik - East Money](https://wap.eastmoney.com/quote/stock/106.BABA.html)
[2]: [Kutipan Saham Alibaba (BABA) AS Hari Ini, Harga dan Grafik - Sina Finance](https://gu.sina.cn/quotes/us/BABA)
[3]: [Harga Saham Terbaru Alibaba (BABA), Grafik Real-time, Analisis dan Prediksi](https://cn.investing.com/equities/alibaba)
[4]: [Harga Saham Alibaba-W (9988.HK), Berita, Kutipan dan Catatan - Yahoo Finance](https://hk.finance.yahoo.com/quote/9988.HK/)
[5]: [Harga Saham Alibaba (BABA), Kutipan, Diskusi - Xueqiu](https://xueqiu.com/S/BABA)
[6]: [Harga Saham Alibaba (BABA), Kapitalisasi Pasar, Kutipan Real-time, Grafik, Laporan Keuangan - Moomoo](https://www.moomoo.com/hans/stock/BABA-US)
[7]: [Harga Saham Alibaba Group Holding Limited (BABA), Berita, Kutipan ...](https://finance.yahoo.com/quote/BABA/)
[8]: [Alibaba - Sekuritas Tencent](https://gu.qq.com/usBABA.N)
[9]: [Harga Saham W(09988), Kapitalisasi Pasar, Kutipan Real-time, Grafik, Laporan Keuangan - Alibaba - Moomoo](https://www.moomoo.com/hans/stock/09988-HK)
====================Konten respons====================
Menurut data pasar terbaru, informasi harga saham Alibaba adalah sebagai berikut:

*   **Saham AS (BABA)**:
    *   Harga pembukaan hari ini: $160,98
    *   Harga penutupan kemarin: $160,80
    *   Tertinggi hari ini: $161,19
    *   Terendah hari ini: $156,20

*   **Saham HK (09988.HK)**:
    *   Kutipan terbaru: sekitar HK$158,00 - 158,10
    *   Harga pembukaan hari ini: HK$156,50
    *   Harga penutupan hari perdagangan sebelumnya: HK$162,00
    *   Kisaran hari ini: HK$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 {
    static {Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";}
    public static void main(String[] args) {
        Generation gen = new Generation();
        Message userMsg = Message.builder()
                .role(Role.USER.getValue())
                .content("Alibaba stock price")
                .build();

        SearchOptions searchOptions = SearchOptions.builder()
                // Strategi pencarian web; hanya agent yang didukung
                .searchStrategy("agent")
                // Mengembalikan sumber pencarian
                .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)+"Hasil pencarian"+"=".repeat(20));
            System.out.println(result.getOutput().getSearchInfo().getSearchResults());
            System.out.println("=".repeat(20)+"Konten respons"+"=".repeat(20));
            System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent());
        } catch (Exception e) {
            System.out.println("Kesalahan: " + e.getMessage());
        }
    }
}

Contoh respons

====================Hasil pencarian====================
[SearchInfo.SearchResult(siteName=null, icon=null, index=1, title=Harga Saham Alibaba(BABA), Kutipan, Grafik - East Money, url=https://wap.eastmoney.com/quote/stock/106.BABA.html), SearchInfo.SearchResult(siteName=null, icon=null, index=2, title=Kutipan Saham Alibaba(BABA)_AS Hari Ini, Harga dan Grafik_Sina Finance, url=https://gu.sina.cn/quotes/us/BABA), SearchInfo.SearchResult(siteName=null, icon=null, index=3, title=Harga Saham Terbaru Alibaba(BABA), Grafik Real-time, Analisis dan Prediksi, url=https://cn.investing.com/equities/alibaba), SearchInfo.SearchResult(siteName=null, icon=null, index=4, title=Harga Saham Alibaba(BABA), Kutipan, Diskusi - Xueqiu, url=https://xueqiu.com/S/BABA), SearchInfo.SearchResult(siteName=null, icon=null, index=5, title=Harga Saham Alibaba-W (9988.HK), Berita, Kutipan dan Catatan - Yahoo Finance, url=https://hk.finance.yahoo.com/quote/9988.HK/), SearchInfo.SearchResult(siteName=null, icon=null, index=6, title=Harga Saham Alibaba(BABA), Kapitalisasi Pasar, Kutipan Real-time, Grafik, Laporan Keuangan- 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=Alibaba - Sekuritas Tencent, url=https://gu.qq.com/usBABA.N), SearchInfo.SearchResult(siteName=null, icon=null, index=9, title=W(09988) Harga Saham, Kapitalisasi Pasar, Kutipan Real-time, Grafik, Laporan Keuangan- Alibaba - Moomoo, url=https://www.moomoo.com/hans/stock/09988-HK)]
====================Konten respons====================
Menurut data pasar terbaru, harga saham Alibaba adalah sebagai berikut:

*   **Saham AS (BABA)**: Harga terbaru sekitar **$159,84**.
*   **Saham HK (09988.HK)**: Harga terbaru sekitar **HK$158,00**.

Perlu diperhatikan bahwa harga saham berfluktuasi secara real-time seiring perdagangan pasar, dan informasi ini hanya untuk referensi.

curl

curl -X POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3-max",
    "input":{
        "messages":[      
            {
                "role": "user",
                "content": "Alibaba stock price"
            }
        ]
    },
    "parameters": {
        "enable_search": true,
        "search_options": {
            "search_strategy": "agent",
            "enable_source": true
        },
        "result_format": "message"
    }
}'

Contoh respons

{
  "output": {
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "content": "Menurut data pasar terbaru, harga saham Alibaba berbeda antara listing AS dan HK:\n\n*   **Saham AS (BABA)**: Harga terbaru sekitar **$160,40**.\n    *   Harga pembukaan hari ini: $160,98\n    *   Kisaran hari ini: $156,20 - 161,19\n\n*   **Saham HK (09988.HK)**: Harga terbaru sekitar **HK$158,10**.\n    *   Harga pembukaan hari ini: HK$156,50\n    *   Kisaran hari ini: HK$156,30 - 158,40\n\nPerlu diperhatikan bahwa harga saham berubah secara real-time seiring perdagangan pasar, dan informasi ini hanya untuk referensi.",
          "role": "assistant"
        }
      }
    ],
    "search_info": {
      "search_results": [
        {
          "index": 1,
          "title": "Harga Saham Alibaba(BABA), Kutipan, Grafik - East Money",
          "url": "https://wap.eastmoney.com/quote/stock/106.BABA.html"
        },
        {
          "index": 2,
          "title": "Kutipan Saham Alibaba(BABA)_AS Hari Ini, Harga dan Grafik_Sina Finance",
          "url": "https://gu.sina.cn/quotes/us/BABA"
        },
        {
          "index": 3,
          "title": "Harga Saham Alibaba-W (9988.HK), Berita, Kutipan dan Catatan - Yahoo Finance",
          "url": "https://hk.finance.yahoo.com/quote/9988.HK/"
        },
        {
          "index": 4,
          "title": "Harga Saham Terbaru Alibaba(BABA), Grafik Real-time, Analisis dan Prediksi",
          "url": "https://cn.investing.com/equities/alibaba"
        },
        {
          "index": 5,
          "title": "Harga Saham Alibaba(BABA), Kutipan, Diskusi - Xueqiu",
          "url": "https://xueqiu.com/S/BABA"
        },
        {
          "index": 6,
          "title": "Harga Saham Alibaba(BABA), Kapitalisasi Pasar, Kutipan Real-time, Grafik, Laporan Keuangan- Moomoo",
          "url": "https://www.moomoo.com/hans/stock/BABA-US"
        },
        {
          "index": 7,
          "title": "W(09988) Harga Saham, Kapitalisasi Pasar, Kutipan Real-time, Grafik, Laporan Keuangan- Alibaba - Moomoo",
          "url": "https://www.moomoo.com/hans/stock/09988-HK"
        },
        {
          "index": 8,
          "title": "Harga Saham Alibaba Group Holding Limited (BABA), Berita, Kutipan dan Catatan",
          "url": "https://hk.finance.yahoo.com/quote/BABA/"
        },
        {
          "index": 9,
          "title": "Alibaba - Sekuritas Tencent",
          "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"
}

Pencarian web dengan API Responses

Untuk mengaktifkan fitur web extractor dengan parameter tools, tambahkan tool web_search ke array tools.

Hanya didukung oleh qwen3.5-plus, qwen3.5-plus-2026-02-15, qwen3.5-flash, qwen3.5-flash-2026-02-23, ; dan qwen3-max, qwen3-max-2026-01-23 dalam mode thinking.

Untuk respons optimal, aktifkan tool web_search, web_extractor, dan code_interpreter secara bersamaan.

Python

from openai import OpenAI
import os

client = OpenAI(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1"
)

response = client.responses.create(
    model="qwen3-max-2026-01-23",
    input="Singapore weather",
    tools=[
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    extra_body={"enable_thinking": True}
)

print("="*20 + "Konten respons" + "="*20)
print(response.output_text)

print("="*20 + "Jumlah pemanggilan tool" + "="*20)
usage = response.usage
if hasattr(usage, 'x_tools') and usage.x_tools:
    print(f"Jumlah pencarian web: {usage.x_tools.get('web_search', {}).get('count', 0)}")
# Hapus komentar baris berikut untuk melihat output antara
# for r in response.output:
#     print(r.model_dump_json())

Node.js

import OpenAI from "openai";

const openai = new OpenAI({
    // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: apiKey: "sk-xxx",
    apiKey: process.env.DASHSCOPE_API_KEY,
    baseURL: "https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1"
});

async function main() {
    const response = await openai.responses.create({
        model: "qwen3-max-2026-01-23",
        input: "Singapore weather",
        tools: [
            { type: "web_search" },
            { type: "web_extractor" },
            { type: "code_interpreter" }
        ],
        enable_thinking: true
    });

    console.log("====================Konten respons====================");
    console.log(response.output_text);
Atur strategi skala pencarian
    console.log("====================Jumlah pemanggilan tool====================");
Atur strategi skala pencarian berdasarkan kebutuhan biaya, efektivitas, dan kecepatan respons melalui search_strategy.
        console.log(`Jumlah pencarian web: ${response.usage.x_tools.web_search?.count || 0}`);

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

main();

curl

curl -X POST https://dashscope-intl.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1/responses \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3-max-2026-01-23",
    "input": "Singapore weather",
    "tools": [
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"}
    ],
    "enable_thinking": true
}'

Penagihan

Penagihan melibatkan dua aspek:

Biaya panggilan model: Konten web dari pencarian web ditambahkan ke prompt, yang meningkatkan jumlah token input untuk model. Anda dikenakan biaya berdasarkan harga standar model. Untuk informasi lebih lanjut tentang harga, lihat Daftar model.
Biaya strategi pencarian:
- strategi agen:
  - Biaya per 1.000 panggilan:
    - Mode penyebaran Tiongkok daratan dan global: USD 0,573411
    - Mode penyebaran internasional: USD 10,00.
- Strategi agent_max (penawaran terbatas):
  Ini mencakup biaya untuk pencarian web dan web extractor.
  - Biaya per 1.000 panggilan ke tool pencarian web adalah:
    - Mode penyebaran Tiongkok daratan: USD 0,573411.
    - Mode penyebaran internasional: USD 10,00.
  - Tool web extractor gratis untuk waktu terbatas.

Pesan kesalahan

Jika Anda mengalami kesalahan, lihat Pesan kesalahan untuk solusi.