Mengotomatisasi penelitian kompleks melalui perencanaan, beberapa putaran pencarian web, dan pembuatan laporan terstruktur, serta mengumpulkan dan mensintesis informasi tanpa upaya manual.
Dokumen ini hanya berlaku untuk wilayah Tiongkok daratan (Beijing). Untuk menggunakan model ini, gunakan API key dari wilayah Tiongkok daratan (Beijing).
Memulai
Dapatkan API key dan ekspor API key sebagai Variabel lingkungan. Jika Anda menggunakan SDK untuk melakukan panggilan, instal DashScope SDK.
Model ini menggunakan alur kerja dua langkah: langkah pertanyaan lanjutan (model mengklarifikasi cakupan penelitian Anda) dan langkah deep research (model melakukan pencarian, analisis, dan menghasilkan laporan). Pertanyaan lanjutan memungkinkan model memahami secara tepat apa yang harus diteliti sebelum memulai proses penelitian yang panjang.
Saat ini, model tidak mendukung DashScope SDK untuk Java atau panggilan API yang kompatibel dengan OpenAI.
Spesifikasi
Model | Jendela konteks (token) | Input maksimum (token) | Output maksimum (token) |
|---|---|---|---|
qwen-deep-research | 1.000.000 | 997.952 | 32.768 |
qwen-deep-research-2025-12-15 |
qwen-deep-research: model mainline yang terus diperbarui. qwen-deep-research-2025-12-15: versi snapshot dengan kedalaman, kualitas, dan MCP tool calling yang ditingkatkan. Keduanya mendukung image input dan ditagih secara terpisah.Kemampuan inti
Lacak kemajuan melalui phase (tugas saat ini) dan status (kemajuan tugas).
Pertanyaan lanjutan dan pembuatan laporan (phase: "answer")
Menganalisis kueri Anda, mengajukan pertanyaan klarifikasi untuk menentukan cakupan, dan menghasilkan laporan penelitian akhir.
Nilai status:
typing: Menghasilkan konten teksfinished: Pembuatan konten teks selesai
typing: Menghasilkan rencana penelitianfinished: Rencana penelitian selesai
WebResultFinished menandakan akhir setiap putaran. finished menandakan akhir fase.
Nilai status:
streamingThinking: Mendekomposisi tugas penelitian dan meringkas konten web (khusus untukqwen-deep-research-2025-12-15, menggantikanstreamingQueriesdanstreamingWebResult)streamingQueries: Menghasilkan kueri pencarian (hanya untukqwen-deep-research)streamingWebResult: Melakukan pencarian web dan menganalisis konten web (hanya untukqwen-deep-research)WebResultFinished: Putaran pencarian selesaifinished: Fase pencarian web selesai
Image input
Kedua model mendukung image input. Model menganalisis gambar dan memasukkan konten tersebut ke dalam penelitiannya. Gunakan format array untuk bidang content, dengan melewatkan objek image dan text bersamaan.
- Format yang didukung: JPEG, PNG, BMP, WEBP. Maksimal 10 MB per gambar.
- Maksimal 5 gambar per permintaan. Mendukung URL publik dan encoding Base64.
- Format respons identik dengan permintaan teks saja. Model menghasilkan laporan berdasarkan konten gambar.
MCP tool calling
MCP tool calling hanya didukung oleh
qwen-deep-research-2025-12-15. qwen-deep-research tidak mendukung fitur ini.qwen-deep-research-2025-12-15 mengambil data dari sumber data privat atau spesifik domain selama fase WebResearch—seperti basis pengetahuan, dokumen internal, atau database proprietary—bersamaan dengan pencarian web standar. Teruskan konfigurasi server MCP melalui parameter research_tools. Format respons identik dengan panggilan standar.
Untuk detail tentang research_tools dan spesifikasi alat MCP, lihat Qwen-Deep-Research.
Contoh permintaan
Penagihan
Model | Biaya input (per 1K token) | Biaya output (per 1K token) | Kuota gratis |
|---|---|---|---|
qwen-deep-research | $0,007742 | $0,023367 | Tidak ada kuota gratis |
qwen-deep-research-2025-12-15 | Akan ditentukan | Akan ditentukan | Tidak ada kuota gratis |
Mulai produksi
Gunakan keluaran streaming
Model hanya mendukung keluaran streaming (stream=True). Satu tugas penelitian dapat berjalan selama beberapa menit melalui puluhan siklus pencarian-dan-baca iteratif, yang melebihi timeout permintaan sinkron. Gunakan streaming untuk menjaga koneksi tetap terbuka dan lacak kemajuan melalui bidang phase dan status.
Atasi error
Periksa kode status respons pada setiap chunk. Untuk kode status selain 200, baca bidang code dan message dan tangani sesuai kebutuhan.
Monitor penggunaan token
Saat status bernilai finished, ambil penggunaan token dari response.usage (token input, token output, dan ID permintaan).
Atasi keepalive koneksi
Fase KeepAlive mempertahankan koneksi antara tugas-tugas berdurasi panjang. Abaikan fase ini dan lanjutkan pemrosesan aliran.
FAQ
- Mengapa bidang output kosong untuk beberapa chunk respons? Chunk awal hanya membawa metadata. Konten tiba di chunk berikutnya saat model menghasilkannya.
-
Bagaimana cara menentukan apakah suatu fase telah selesai?
Fase selesai ketika
statusberubah menjadifinished. - Apakah model mendukung panggilan API yang kompatibel dengan OpenAI? Tidak. Panggilan API yang kompatibel dengan OpenAI tidak didukung.
- Bagaimana perhitungan token input dan output? Token input mencakup pesan pengguna dan prompt sistem. Token output mencakup pertanyaan lanjutan, rencana penelitian, tujuan, kueri pencarian, dan laporan akhir.
-
Apa perbedaan antara qwen-deep-research dan qwen-deep-research-2025-12-15?
qwen-deep-research: model mainline yang terus diperbarui.qwen-deep-research-2025-12-15: versi snapshot dengan kedalaman, kualitas, dan dukungan MCP yang ditingkatkan. Keduanya mendukung image input dan ditagih secara terpisah. -
Bagaimana cara melewatkan gambar untuk penelitian?
Gunakan format array untuk
content: lewatkan{"image": "URL"}dan{"text": "deskripsi"}sebagai objek dalam array. Kedua model mendukung image input. -
Bagaimana cara melewati pertanyaan lanjutan dan langsung ke penelitian?
Setel
enable_feedbackkefalsedalamparameters. Model akan melewati pertanyaan lanjutan dan langsung memulai penelitian.