Automatiza investigaciones complejas mediante planificación, múltiples rondas de búsquedas web y generación estructurada de informes. Recopila y sintetiza información sin esfuerzo manual.
Este documento se aplica únicamente a la región de China continental (Beijing). Para utilizar el modelo, debe emplear una clave de API de la región de China continental (Beijing).
Introducción
Obtenga una clave API y exporte la clave API como variable de entorno. Si utiliza un SDK para realizar las llamadas, instale el SDK de DashScope.
El modelo utiliza un flujo de trabajo de dos pasos: un paso de pregunta de seguimiento (el modelo aclara el alcance de su investigación) y un paso de investigación profunda (el modelo busca, analiza y genera un informe). La pregunta de seguimiento permite al modelo comprender exactamente qué investigar antes de iniciar una ejecución de investigación prolongada.
Actualmente, el modelo no es compatible con el SDK de DashScope para Java ni con llamadas a la API compatible con OpenAI.
Especificaciones
Modelo | Ventana de contexto (tokens) | Entrada máxima (tokens) | Salida máxima (tokens) |
|---|---|---|---|
qwen-deep-research | 1,000,000 | 997,952 | 32,768 |
qwen-deep-research-2025-12-15 |
qwen-deep-research: modelo principal, actualizado continuamente. qwen-deep-research-2025-12-15: versión instantánea con mayor profundidad, calidad y llamada a herramientas MCP. Ambos admiten entrada de imágenes y se facturan por separado.Capacidades principales
Rastree el progreso mediante phase (tarea actual) y status (progreso de la tarea).
Generación de preguntas de seguimiento e informe (fase: "answer")
Analiza su consulta, formula preguntas aclaratorias para definir el alcance y genera el informe final de investigación.
Valores de estado:
typing: Generando contenido de textofinished: Generación de contenido de texto completada
typing: Generando el plan de investigaciónfinished: Plan de investigación completado
WebResultFinished señala el final de cada ronda. finished señala el final de la fase.
Valores de estado:
streamingThinking: Descomposición de tareas de investigación y resumen de contenido web (específico deqwen-deep-research-2025-12-15, reemplaza astreamingQueriesystreamingWebResult)streamingQueries: Generando consultas de búsqueda (solo paraqwen-deep-research)streamingWebResult: Realizando búsquedas web y analizando contenido web (solo paraqwen-deep-research)WebResultFinished: Ronda de búsqueda completadafinished: Fase de búsqueda web completada
Entrada de imagen
Ambos modelos admiten entrada de imágenes. El modelo analiza la imagen e incorpora ese contenido a su investigación. Utilice el formato de matriz para el campo content, pasando juntos los objetos image y text.
- Formatos admitidos: JPEG, PNG, BMP, WEBP. Máximo de 10 MB por imagen.
- Hasta 5 imágenes por solicitud. Admite URL públicas y codificación Base64.
- El formato de respuesta es idéntico al de las solicitudes de solo texto. El modelo genera un informe basado en el contenido de la imagen.
Llamada a herramientas MCP
La llamada a herramientas MCP solo es compatible con
qwen-deep-research-2025-12-15. qwen-deep-research no admite esta función.qwen-deep-research-2025-12-15 extraiga datos de fuentes privadas o específicas de dominio durante la fase WebResearch, como una base de conocimientos, documentos internos o una base de datos propietaria, además de las búsquedas web estándar. Pase la configuración del servidor MCP a través del parámetro research_tools. El formato de respuesta es idéntico al de las llamadas estándar.
Para obtener detalles sobre research_tools y las especificaciones de herramientas MCP, consulte Qwen-Deep-Research .
Ejemplo de solicitud
Facturación
Modelo | Costo de entrada (por 1K tokens) | Costo de salida (por 1K tokens) | Cuota gratuita |
|---|---|---|---|
qwen-deep-research | $0.007742 | $0.023367 | Sin cuota gratuita |
qwen-deep-research-2025-12-15 | Por determinar | Por determinar | Sin cuota gratuita |
Puesta en marcha
Uso de salida por streaming
El modelo solo admite salida por streaming (stream=True). Una sola tarea de investigación puede ejecutarse durante varios minutos a lo largo de docenas de ciclos iterativos de búsqueda y lectura, lo cual excede el tiempo de espera de una solicitud síncrona. Utilice el streaming para mantener la conexión abierta y rastrear el progreso mediante los campos phase y status.
Gestión de errores
Verifique el código de estado de la respuesta en cada fragmento. Para códigos de estado distintos de 200, lea los campos code y message y manéjelos adecuadamente.
Supervisión del uso de tokens
Cuando status es finished, recupere el uso de tokens desde response.usage (tokens de entrada, tokens de salida e ID de solicitud).
Gestión del keepalive de conexión
La fase KeepAlive mantiene la conexión entre tareas de larga duración. Ignore esta fase y continúe procesando el flujo.
FAQ
- ¿Por qué el campo de salida está vacío en algunos fragmentos de respuesta? Los primeros fragmentos contienen únicamente metadatos. El contenido llega en fragmentos posteriores a medida que el modelo lo genera.
-
¿Cómo determino si una fase está completa?
Una fase se completa cuando
statuscambia afinished. - ¿El modelo admite llamadas a la API compatible con OpenAI? No. No se admiten llamadas a la API compatible con OpenAI.
- ¿Cómo se calculan los tokens de entrada y salida? Tokens de entrada: mensajes del usuario e instrucciones del sistema. Tokens de salida: preguntas de seguimiento, planes de investigación, objetivos, consultas de búsqueda y el informe final.
-
¿Cuál es la diferencia entre qwen-deep-research y qwen-deep-research-2025-12-15?
qwen-deep-research: modelo principal, actualizado continuamente.qwen-deep-research-2025-12-15: versión instantánea con mayor profundidad, calidad y soporte para MCP. Ambos admiten entrada de imágenes y se facturan por separado. -
¿Cómo paso imágenes para la investigación?
Utilice el formato de matriz para
content: pase{"image": "URL"}y{"text": "description"}como objetos en la matriz. Ambos modelos admiten entrada de imágenes. -
¿Cómo omito la pregunta de seguimiento y paso directamente a la investigación?
Establezca
enable_feedbackenfalsedentro deparameters. El modelo omite la pregunta de seguimiento e inicia la investigación inmediatamente.