Data pelatihan model bahasa besar memiliki tanggal cutoff pengetahuan, sehingga tidak dapat menjawab pertanyaan real-time. Dengan mengaktifkan web search, model dapat mengambil data real-time dan memberikan jawaban akurat untuk pertanyaan yang sensitif terhadap waktu, seperti harga saham, prakiraan cuaca, dan berita terkini.
Penggunaan
Anda dapat mengaktifkan web search melalui tiga panggilan API berikut, masing-masing memerlukan parameter yang berbeda.
Untuk web search dengan model seperti qwen3.7-max, gunakan fitur web search dari Responses API.
- Kompatibel dengan OpenAI: Responses API
- Kompatibel dengan OpenAI: Chat Completions API
- DashScope
Tambahkan tool
web_search ke parameter tools untuk mengaktifkan web search.Responses API hanya mendukung sebagian model. Untuk model yang didukung, lihat Web search dengan Responses API.
Web search dengan model multimodal
Seri Qwen4-Max, seri Qwen3.8, Qwen3.7-Flash, Qwen3.7-Plus, seri Qwen3.6, dan seri Qwen3.5 (termasuk qwen3.5-plus, qwen3.5-flash, seri qwen3.5-omni, dan model open-source Qwen) menerima input multimodal (gambar, video) dan merupakan model multimodal.
Dukungan strategi pencarian bervariasi menurut seri: seri qwen3.5-omni hanya mendukung strategi agent; qwen4-max dan seri Qwen3.8 tidak mendukung strategi agent (gunakan turbo atau max default); model lainnya mendukung strategi turbo, max, dan agent. Panggil model ini melalui API multimodal (endpoint multimodal-generation): Python SDK 2.0 menggunakan client.multimodal.chat.create, Java menggunakan MultiModalConversation, dan tidak dapat menggunakan endpoint text-generation yang ditujukan untuk model teks saja. Untuk dasar-dasar pemanggilan model multimodal, lihat topik Visual reasoning dan Image and video understanding.
Memanggil model multimodal di atas melalui endpointtext-generationmengembalikan400 url error, please check url. Gunakan API multimodal sebagai gantinya (endpointmultimodal-generation; di Python gunakanclient.multimodal.chat.create, di Java gunakanMultiModalConversation). Di SDK Java,MultiModalConversationParammenyediakanenableSearch(true)untuk mengaktifkan web search, tetapi tidak menyediakan metodesearchOptions(). Suntikkan strategi pencarian dan opsi lainnya melalui metode generikparameter("search_options", ...). Di Python,client.multimodal.chat.createmenerimasearch_optionssecara langsung. Web search pada model multimodal memerlukan panggilan streaming (gunakanstreamCalldi Java, atau aturstream=Truedi Python); jika tidak, permintaan akan mengembalikan errorNon-streaming mode does not support Web Search.
Python
Model yang didukung
Model berikut mendukung web search. Model dengan input multimodal (seri Qwen4-Max, seri Qwen3.8, Qwen3.7-Flash/Plus, seri Qwen3.6, seri Qwen3.5, dan model open-source Qwen) harus dipanggil melalui API multimodal. Lihat Web search dengan model multimodal.
- Singapura
- Tiongkok (Beijing)
-
Qwen
- Qwen4 series: qwen4-max (strategi
agenttidak didukung; untuk pencarian gaya agent, gunakan alatweb_searchmelalui Responses API) - Qwen3.8 series: qwen3.8-max, qwen3.8-max-0902, qwen3.8-flash, qwen3.8-2.4t-a95b, qwen3.8-27b (strategi
agenttidak didukung) - Qwen3.7 series: qwen3.7-max, qwen3.7-max-preview, qwen3.7-max-2026-05-17 dan snapshot setelahnya, qwen3.7-plus, qwen3.7-plus-2026-05-26 dan snapshot setelahnya, qwen3.7-flash, qwen3.7-flash-2026-07-15 dan snapshot setelahnya
- Qwen3.6 series: qwen3.6-plus, qwen3.6-plus-2026-04-02 dan snapshot setelahnya, qwen3.6-flash, qwen3.6-flash-2026-04-16 dan snapshot setelahnya, qwen3.6-27b, qwen3.6-35b-a3b
- Qwen3.5 series: qwen3.5-plus, qwen3.5-plus-2026-02-15 dan snapshot setelahnya, qwen3.5-flash, qwen3.5-flash-2026-02-23 dan snapshot setelahnya, qwen3.5-27b, qwen3.5-35b-a3b, qwen3.5-122b-a10b, qwen3.5-397b-a17b
- Qwen-Omni: qwen3.5-omni-plus, qwen3.5-omni-plus-2026-03-15, qwen3.5-omni-flash, qwen3.5-omni-flash-2026-03-15 (strategi pencarian harus diatur ke
agent) - 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 (strategi pencarian harus diatur ke
agent)
- Qwen4 series: qwen4-max (strategi
-
Model pihak ketiga
- DeepSeek: deepseek-v4-pro, deepseek-v4-pro-0813, deepseek-v4-flash-0731,
deepseek-v4.1-flash-1017(seri deepseek-v4 juga mendukung Responses API) - GLM: glm-5.2 (hanya didukung oleh Responses API)
- Kimi: kimi-k3.1-pro (mendukung
web_searchdi Responses dan Anthropic, tetapi tidak mendukungenable_searchdi Chat Completions); kimi-k3 (hanya didukung oleh Responses API)
- DeepSeek: deepseek-v4-pro, deepseek-v4-pro-0813, deepseek-v4-flash-0731,
qwen4-max mendukung pencarian web dalam cakupan penerapan layanan Virginia di wilayah AS (Virginia).
kimi-k3.1-pro (diterapkan di Alibaba Cloud Model Studio) mendukung web_search di Responses dan Anthropic, tetapi tidak mendukung enable_search di Chat Completions, di keempat wilayah: AS (Virginia), China (Hong Kong), Jepang (Tokyo), dan Jerman (Frankfurt).
deepseek-v4.1-flash-1017 mendukung pencarian web native model serta alat bawaan web_search di Responses API dan API kompatibel Anthropic di Tiongkok (Beijing), Singapura (cakupan deployment International), serta AS (Virginia), Jerman (Frankfurt), Jepang (Tokyo), dan Tiongkok (Hong Kong) (cakupan deployment Global).
Quick start
Contoh berikut menunjukkan cara melakukan kueri informasi saham menggunakan web search.
- Kompatibel dengan OpenAI
- DashScope
Protokol kompatibel dengan OpenAI tidak mendukung pengembalian sumber pencarian dalam respons.
- Python
- Node.js
- curl
Contoh respons
Web search dengan Responses API
Anda dapat mengaktifkan web search dengan menambahkan tool web_search ke array tools dari parameter tools.
Fitur ini hanya didukung untuk model berikut: model seri Qwen3.8, Qwen3.7, dan Qwen3.5 (termasuk model open-source, tetapi tidak termasuk model Omni), seri Qwen3.6-Plus dan Qwen3.6-Flash, serta qwen3.6-35b-a3b; deepseek-v4-flash-0731, deepseek-v4.1-flash-1017, deepseek-v4-pro, deepseek-v4-pro-0813; glm-5.2; dan kimi-k3, kimi-k3.1-pro.
Untuk hasil terbaik, kami merekomendasikan mengaktifkan toolweb_search,web_extractor, dancode_interpretersecara bersamaan.
Untuk petunjuk penggunaan, contoh kode, dan panduan migrasi untuk Responses API, lihat Kompatibel dengan OpenAI - Responses.
python
Dapatkan sumber pencarian
Setelah web search dijalankan, sumber pencarian dikembalikan dalam respons. Sumber tersebut muncul dalam elemen yang type-nya adalah web_search_call dalam array output, dan bidang action.sources-nya adalah daftar tautan sumber. Anda dapat mengekstraknya dari response pada contoh di atas sebagai berikut:
Responses API tidak mendukung parameterenable_source,enable_citation, ataucitation_format, dan tidak menyisipkan penanda sitasi[1]ke dalam konten respons. Untuk menggunakan penanda sitasi, gunakan API DashScope.
Penagihan
Biaya untuk web search terdiri dari dua komponen:
- biaya panggilan model: Fitur web search menambahkan konten web yang diambil ke prompt, sehingga meningkatkan jumlah token input. Token ini ditagih sesuai tarif standar model. Untuk detail harga, lihat konsol Model Studio. Saat Anda menggunakan Responses API, tool web search ditagih dengan tarif yang sama seperti kebijakan agen.
-
biaya kebijakan pencarian:
-
Kebijakan agen:
-
Biaya per 1.000 panggilan adalah sebagai berikut:
- Untuk wilayah Tiongkok (Beijing): $0.573411.
- Untuk wilayah Singapura: $10.00.
-
Biaya per 1.000 panggilan adalah sebagai berikut:
-
Kebijakan agen: