Qwen-Deep-Research API reference

import os
import dashscope

# China North 2 (Beijing). This model is available only in this region.
# API keys are region-specific. See https://docs.qwencloud.com/developer-guides/getting-started/regions
dashscope.base_http_api_url = "https://cn-beijing.maas.qwencloudapi.com/api/v1"

# Step 1: ask the model to clarify the research scope.
messages = [{'role': 'user', 'content': 'Research how artificial intelligence is used in education.'}]

responses = dashscope.Generation.call(
  api_key=os.getenv('DASHSCOPE_API_KEY'),
  model='qwen-deep-research',
  messages=messages,
  stream=True
)

# Collect the clarifying question.
step1_content = ''
for response in responses:
  if hasattr(response, 'output') and response.output:
    message = response.output.get('message', {})
    content = message.get('content', '')
    if content:
      step1_content += content
      print(content, end='', flush=True)

# Step 2: run the deep research with the full conversation.
messages = [
  {'role': 'user', 'content': 'Research how artificial intelligence is used in education.'},
  {'role': 'assistant', 'content': step1_content},
  {'role': 'user', 'content': 'I care mainly about personalized learning and automated assessment.'}
]

responses = dashscope.Generation.call(
  api_key=os.getenv('DASHSCOPE_API_KEY'),
  model='qwen-deep-research',
  messages=messages,
  stream=True
)

for response in responses:
  if hasattr(response, 'output') and response.output:
    message = response.output.get('message', {})
    content = message.get('content', '')
    if content:
      print(content, end='', flush=True)