Los modelos de pensamiento profundo razonan antes de responder, mejorando la precisión en tareas complejas como el razonamiento lógico y las matemáticas.
Este artículo describe cómo llamar al modelo de pensamiento profundo mediante la interfaz Chat Completion compatible con OpenAI o la interfaz DashScope. Para el uso de la API Responses, consulte: Pensamiento profundo.
Demostración
El siguiente es un ejemplo de conversación del modelo de Pensamiento Profundo, que muestra cómo el modelo primero realiza el razonamiento y luego da una respuesta.
Pregunta del usuario ¿Cuál es mayor, 9.9 o 9.11? Proceso de pensamiento (campo reasoning_content) Primero, la pregunta del usuario es: "¿Cuál es mayor, 9.9 o 9.11?", lo que parece ser una comparación de dos números: 9.9 y 9.11. Necesito entender el significado de estos números. En matemáticas, 9.9 es equivalente a 9.90, y 9.11 es 9.11. Para compararlos, debo tratarlos como decimales. 9.9 es 9 + 9/10 = 9.9, mientras que 9.11 es 9 + 11/100 = 9.11. Ahora, compare 9.9 y 9.11: 9.9 es igual a 9.90 (porque 9.9 = 9.90), y 9.11 es 9.11. Ahora, compare 9.90 con 9.11: 9.90 es mayor que 9.11, porque 90/100 > 11/100. Más precisamente: 9.9 = 99/10 = 990/100, 9.11 = 911/100, compare 990/100 con 911/100, obviamente 990 > 911, por lo que 990/100 > 911/100, por lo tanto 9.9 > 9.11. También puedo observar directamente la parte decimal: la parte decimal de 9.9 es 0.9, y la parte decimal de 9.11 es 0.11. 0.9 es mayor que 0.11, porque 0.9 = 0.90 > 0.11. Por lo tanto, 9.9 es mayor que 9.11. Respuesta del modelo (campo content) Conclusión: 9.9 es mayor que 9.11. |
Uso
El Modelo de Pensamiento Profundo de Bailian se divide en dos modos:
-
Modo de pensamiento mixto: El pensamiento se puede habilitar o deshabilitar por solicitud, y los parámetros de control varían según el modelo. El siguiente ejemplo utiliza
enable_thinking, los valores son los siguientes:- Establecido en
true: el modelo piensa antes de responder; - Establecido en
false: el modelo responde directamente;
- Compatible con OpenAI
- DashScope
- Establecido en
-
Modo solo de pensamiento: El modelo siempre piensa antes de responder y no se puede deshabilitar. Salvo que no necesita configurar el parámetro
enable_thinking, el formato de la solicitud es consistente con el modo de pensamiento híbrido.
reasoning_content, y el contenido de la respuesta se devuelve a través del campo content. El pensamiento profundo requiere tiempo adicional de razonamiento. Los ejemplos de este artículo utilizan llamadas con streaming de forma predeterminada (recomendado, puede ver el proceso de pensamiento en tiempo real y evitar largas esperas). El modelo comercial de pensamiento profundo también admite salida sin streaming (síncrona). Para uso y precauciones, consulte las preguntas frecuentes a continuación; algunos modelos (como qwen3.5-122b-a10b, qwen3.5-27b y otras versiones de código abierto) solo admiten salida Stream, y la llamada sin streaming reportará un error.
Modelos compatibles
- Qwen4
- Qwen3.8
- Qwen3.7
- Qwen3.6
- Qwen3.5
- Qwen3
- DeepSeek
- GLM
- Kimi
- MiniMax
Inicio rápido
Requisito previo para el uso de la API: Haberobtenido y configurado la clave de API y completadoConfigurar la clave de API en variables de entorno. Si realiza la llamada mediante SDK, necesitaInstalar el SDK de OpenAI o DashScope(el SDK de Java de DashScope requiere al menos la versión 2.19.4).
El siguiente código utiliza la llamada en streaming qwen3.8-max con el modo de pensamiento activado como ejemplo.
- Compatible con OpenAI
- DashScope
- Python
- Node.js
- HTTP
Código de ejemplo
Respuesta
Capacidades principales
Cambiar modo Pensamiento/Sin Pensamiento
Habilitar el modo de pensamiento puede mejorar la calidad de la respuesta, pero aumentará la latencia de respuesta y el consumo de tokens. Al utilizar modelos con modo de pensamiento híbrido, puede cambiar dinámicamente según la complejidad del problema sin cambiar el modelo:
- Tareas simples (chat diario, preguntas y respuestas sencillas): Establezca
enable_thinkingenfalsepara desactivar el pensamiento; - Tareas complejas (razonamiento lógico, generación de código, soluciones matemáticas): Establezca
enable_thinkingentruepara activar el pensamiento.
- Compatible con OpenAI
- DashScope
- Python
- Node.js
- HTTP
Código de ejemplo
Respuesta
enable_thinking es true, añada /no_think al prompt para deshabilitar el pensamiento; en conversaciones de múltiples turnos, para volver a habilitarlo, añada /think al prompt más reciente. El modelo siempre sigue la última instrucción /think o /no_think.
Limitar la longitud del pensamiento
Los modelos de pensamiento profundo a veces generan procesos de razonamiento extensos, lo que aumenta la latencia y consume más tokens. Use el parámetro thinking_budget para establecer el número máximo de tokens del proceso de razonamiento. Al alcanzar el límite, el modelo comienza a generar la respuesta de inmediato. kimi-k3.1-pro y kimi-k3 no admiten este parámetro, por lo que no puede limitar la longitud de su pensamiento.
Para conocer los modelos compatibles y sus valores predeterminados, consulte los parámetros de Chat Completions y los parámetros de DashScope.
Los ejemplos siguientes solo muestran los parámetros clave. Para ver el ejemplo de streaming completo, consulte Inicio rápido.
- Compatible con OpenAI
- DashScope
Pasar el proceso de pensamiento
kimi-k3.1-pro y kimi-k3 (implementados en Alibaba Cloud Model Studio) conservan de forma predeterminada el reasoning_content histórico proporcionado por el cliente. Se recomienda reenviar los mensajes históricos del asistente con su reasoning_content completo en las solicitudes de múltiples turnos.
En conversaciones de múltiples turnos, preserve_thinking controla si el modelo lee el reasoning_content del mensaje histórico del asistente. Cuando se establece en true, estos contenidos de pensamiento se añadirán a la entrada de la siguiente ronda. El cliente necesita proporcionar los mensajes históricos del asistente y su messages en los reasoning_content de la solicitud. El valor predeterminado de cada modelo se basa en la Descripción de parámetros de Chat Completions.
Para los modelos Qwen3.8 Max, Qwen3.7, Qwen3.6 y Kimi que admiten este parámetro, si los mensajes históricos no contienen reasoning_content, habilitar este parámetro no causará un error.
Después de activarlo, en la conversación histórica reasoning_content se contará para el recuento de tokens de entrada y la facturación.
- Compatible con OpenAI
- DashScope
preserve_thinking Parámetro no estándar de OpenAI. Si usa el SDK de Python, debe pasarlo mediante extra_body.- Python
- Node.js
- HTTP
Código de ejemplo
Respuesta
Otras funciones
Detalles de facturación
- El contenido de pensamiento se factura por Token de salida.
-
Algunos modelos de pensamiento híbrido tienen precios diferentes en los modos de pensamiento y sin pensamiento.
Si el modelo no genera el Proceso de Pensamiento en el modo de pensamiento, se factura al precio del modo sin pensamiento.
FAQ
P: ¿Cómo deshabilitar el modo de pensamiento?
P: ¿Cómo deshabilitar el modo de pensamiento?
- Modelos de modo de pensamiento híbrido (como qwen3.6-plus, deepseek-v4-pro): establezca
enable_thinkingenfalsepara desactivar; - Los modelos de modo solo pensamiento (como glm-5.3, kimi-k2.7-code): no se pueden desactivar.
- kimi-k3.1-pro y kimi-k3 habilitan el pensamiento de forma predeterminada. Establezca
enable_thinking=falsepara deshabilitarlo, pero se recomienda mantenerlo habilitado. En kimi-k3.1-pro, deshabilitar el pensamiento degrada significativamente la calidad de la salida, por lo que se recomienda encarecidamente mantenerlo habilitado.
P: ¿Cómo solucionar respuestas lentas de qwen3.7-plus?
P: ¿Cómo solucionar respuestas lentas de qwen3.7-plus?
- Confirm si el modo de pensamiento está habilitado. qwen3.7-plus está habilitado de forma predeterminada, lo cual se puede determinar verificando si se devuelve el campo
reasoning_contenten la respuesta. - Revise
completion_tokensyreasoning_tokensen el uso de la respuesta. Sireasoning_tokenses relativamente alto, el consumo total de tiempo es un comportamiento esperado del modo de pensamiento. - Si no se requiere un proceso de pensamiento, configure
enable_thinkingenfalsepara deshabilitar el modo de pensamiento. Una vez deshabilitado, el token de salida se reduce significativamente y el tiempo total real puede reducirse en un 60%-75%. - Si necesita conservar la capacidad de pensamiento, puede cambiar aStream para obtener el primer token más rápidamente y ver el proceso de pensamiento en tiempo real, evitando largas esperas por la respuesta completa.
Las estadísticas de uso muestran el consumo total de tiempo de una sola llamada (incluido el tiempo de generación del token de pensamiento), en lugar de la latencia de generación de un solo token.
P: ¿Cómo llamar a modelos de pensamiento profundo en modo sin streaming (síncrono)?
P: ¿Cómo llamar a modelos de pensamiento profundo en modo sin streaming (síncrono)?
Al cambiar el ejemplo de streaming a no streaming, modifique el código de análisis de resultados: la llamada sin streaming devuelve un objeto Response completo (El siguiente ejemplo utiliza la interfaz compatible con OpenAI con una llamada sin streaming de qwen3.8-max con el modo de pensamiento activado:completion), no se puede iterar a través defor chunk in completioncomo en el código de ejemplo de streaming (de lo contrario se generará un error'tuple' object has no attribute 'choices'), y debe leer directamentecompletion.choices[0].message.reasoning_content(proceso de pensamiento) ycompletion.choices[0].message.content(contenido de la respuesta). Además,stream=Falseno puede establecer el parámetrostream_options.
Algunos modelos (como qwen3.5-122b-a10b, qwen3.5-27b y otras versiones de código abierto) solo admiten salida Stream, y la llamada sin streaming resultará en un error parameter.enable_thinking only support stream call. Para tales modelos, utilice llamadas con streaming.
P: ¿Cómo comprar tokens después de agotar la cuota gratuita?
P: ¿Cómo comprar tokens después de agotar la cuota gratuita?
Después de superar la Free Quota, la facturación se realiza automáticamente en intervalos de nivel de minuto. Para detalles de consumo, vaya a ;Detalles de la factura para consultarlos.
P: ¿Puedo subir imágenes o documentos para realizar consultas?
P: ¿Puedo subir imágenes o documentos para realizar consultas?
P: ¿Cómo ver el consumo de tokens y el recuento de llamadas?
P: ¿Cómo ver el consumo de tokens y el recuento de llamadas?
Los datos de monitoreo se actualizan a nivel de minuto y son solo para referencia; no se utilizan como base de facturación.
P: ¿Qué hacer si un prompt largo falla al generarse o excede el tiempo de espera?
P: ¿Qué hacer si un prompt largo falla al generarse o excede el tiempo de espera?
enable_thinking es true). El modo de pensamiento aumentará el tiempo de procesamiento y, en escenarios de prompts largos, puede causar truncamiento de la respuesta o tiempo de espera de la solicitud.Solución:- Desactivar el modo de pensamiento: Establezca
enable_thinkingenfalse, reduciendo el tiempo de procesamiento de aproximadamente 50 s a unos 30 s. - Activar Stream: Establezca
streamentruepara evitar el límite de tiempo de espera de las llamadas sin streaming. - Aumentar el tiempo de espera: Si necesita mantener el modo de pensamiento, establezca el tiempo de espera del cliente en 180 segundos o más.
P: ¿Qué hacer si un cliente de terceros se desconecta después de generar una etiqueta de pensamiento al llamar a un modelo de pensamiento profundo?
P: ¿Qué hacer si un cliente de terceros se desconecta después de generar una etiqueta de pensamiento al llamar a un modelo de pensamiento profundo?
enable_thinking para controlar el cambio del modo de pensamiento, y el modelo devuelve el campo reasoning_content que contiene el contenido completo del proceso de pensamiento; el modelo devolverá normalmente el contenido de pensamiento. Las desconexiones suelen ser causadas por fluctuaciones en la red del cliente o problemas de compatibilidad de la versión del cliente.Pasos de solución de problemas:- Verifique la estabilidad de la conexión de red del cliente.
- Actualice el cliente a la versión más reciente.
- Revise los registros del cliente para confirmar la asociación entre el momento de la desconexión y la salida de la etiqueta de pensamiento.