Deep Thinking

Deep Thinking is an advanced reasoning feature that enables Chain of Thought mechanisms, allowing the model to perform deep analysis and reasoning before answering questions. This approach significantly improves the model’s accuracy and interpretability in complex tasks, particularly suitable for scenarios requiring multi-step reasoning, logical analysis, and problem-solving.

Features

The Deep Thinking feature currently supports the latest models in the GLM-5.2 GLM-5.1 GLM-5 GLM-5-Turbo GLM-5V-Turbo GLM-4.5 GLM-4.6 GLM-4.7 series. By enabling deep thinking, the model can:

• Multi-step Reasoning: Break down complex problems into multiple steps for gradual analysis and resolution
• Logical Analysis: Provide clear reasoning processes and logical chains
• Improved Accuracy: Reduce errors and improve answer quality through deep thinking
• Enhanced Interpretability: Display the thinking process to help users understand the model’s reasoning logic
• Intelligent Judgment: The model automatically determines whether deep thinking is needed to optimize response efficiency

Core Parameters

• thinking.type: Controls the deep thinking mode
  • enabled (default): Enable dynamic thinking. The model automatically determines whether to think: GLM-5.2, GLM-5.1, GLM-5, GLM-5-Turbo, GLM-5V-Turbo, GLM-4.6, and GLM-4.5 auto-decide whether to think, while GLM-4.7 and GLM-4.5V use forced thinking
  • disabled: Disable deep thinking, provide direct answers
• reasoning_effort: Controls the reasoning effort level when chain-of-thought thinking is enabled, only supported by GLM-5.2 and above
  • Allowed values: max (default and recommended, deep reasoning), xhigh, high (enhanced reasoning), medium, low, minimal, none
  • none or minimal: Model skips thinking; low / medium are mapped to high; xhigh is mapped to max
• model: Models that support deep thinking, such as glm-5.2, glm-5.1, glm-5, glm-4.7, glm-4.6, glm-4.5, glm-4.5v, etc.

Code Examples

cURL

Basic Call (Enable Deep Thinking)

curl --location 'https://api.z.ai/api/paas/v4/chat/completions' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "glm-5.2",
    "messages": [
        {
            "role": "user",
            "content": "Explain in detail the basic principles of quantum computing and analyze its potential impact in the field of cryptography"
        }
    ],
    "thinking": {
        "type": "enabled"
    },
    "max_tokens": 4096,
    "temperature": 1.0
}'

Streaming Call (Deep Thinking + Streaming Output)

curl --location 'https://api.z.ai/api/paas/v4/chat/completions' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "glm-5.2",
    "messages": [
        {
            "role": "user",
            "content": "Design a recommendation system architecture for an e-commerce website, considering user behavior, product features, and real-time requirements"
        }
    ],
    "thinking": {
        "type": "enabled"
    },
    "stream": true,
    "max_tokens": 4096,
    "temperature": 1.0
}'

Control Reasoning Effort (reasoning_effort)

curl --location 'https://api.z.ai/api/paas/v4/chat/completions' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "glm-5.2",
    "messages": [
        {
            "role": "user",
            "content": "Analyze the solution approach for this math problem"
        }
    ],
    "thinking": {
        "type": "enabled"
    },
    "reasoning_effort": "max"
}'

Disable Deep Thinking

curl --location 'https://api.z.ai/api/paas/v4/chat/completions' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "glm-5.2",
    "messages": [
        {
            "role": "user",
            "content": "How is the weather today?"
        }
    ],
    "thinking": {
        "type": "disabled"
    }
}'

Python SDK

Install SDK

# Install latest version
pip install zai-sdk

# Or specify version
pip install zai-sdk==0.2.3

Verify Installation

import zai
print(zai.__version__)

Basic Call (Enable Deep Thinking)

from zai import ZaiClient

# Initialize client
client = ZaiClient(api_key='your_api_key')

# Create deep thinking request
response = client.chat.completions.create(
    model="glm-5.2",
    messages=[
        {"role": "user", "content": "Explain in detail the basic principles of quantum computing and analyze its potential impact in the field of cryptography"}
    ],
    thinking={
        "type": "enabled"  # Enable deep thinking mode
    },
    max_tokens=4096,
    temperature=1.0
)

print("Model response:")
print(response.choices[0].message.content)
print("\n---")
print(response.choices[0].message.reasoning_content)

Streaming Call (Deep Thinking + Streaming Output)

from zai import ZaiClient

# Initialize client
client = ZaiClient(api_key='your_api_key')

# Create streaming deep thinking request
response = client.chat.completions.create(
    model="glm-5.2",
    messages=[
        {"role": "user", "content": "Design a recommendation system architecture for an e-commerce website, considering user behavior, product features, and real-time requirements"}
    ],
    thinking={
        "type": "enabled"  # Enable deep thinking mode
    },
    stream=True,  # Enable streaming output
    max_tokens=4096,
    temperature=1.0
)

# Process streaming response
reasoning_content = ""
thinking_phase = True

for chunk in response:
    if not chunk.choices:
        continue
    
    delta = chunk.choices[0].delta
    
    # Process thinking process (if any)
    if hasattr(delta, 'reasoning_content') and delta.reasoning_content:
        reasoning_content += delta.reasoning_content
        if thinking_phase:
            print("🧠 Thinking...", end="", flush=True)
            thinking_phase = False
        print(delta.reasoning_content, end="", flush=True)
    
    # Process answer content
    if hasattr(delta, 'content') and delta.content:
        if thinking_phase:
            print("\n\n💡 Answer:")
            thinking_phase = False
        print(delta.content, end="", flush=True)

Control Reasoning Effort (reasoning_effort)

from zai import ZaiClient

# Initialize client
client = ZaiClient(api_key='your_api_key')

# Use reasoning_effort to control reasoning level
response = client.chat.completions.create(
    model="glm-5.2",
    messages=[
        {"role": "user", "content": "Analyze the solution approach for this math problem"}
    ],
    thinking={
        "type": "enabled"
    },
    reasoning_effort="high"  # Options: max, xhigh, high, medium, low, minimal, none
)

print(response.choices[0].message.content)
print(response.choices[0].message.reasoning_content)

Disable Deep Thinking

from zai import ZaiClient

# Initialize client
client = ZaiClient(api_key='your_api_key')

# Disable deep thinking for quick response
response = client.chat.completions.create(
    model="glm-5.2",
    messages=[
        {"role": "user", "content": "How is the weather today?"}
    ],
    thinking={
        "type": "disabled"  # Disable deep thinking mode
    }
)

print(response.choices[0].message.content)

Response Example

Response format with deep thinking enabled:

{
  "created": 1677652288,
  "model": "glm-5.2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Artificial intelligence has tremendous application prospects in medical diagnosis...",
        "reasoning_content": "Let me analyze this question from multiple angles. First, I need to consider the technical advantages of AI in medical diagnosis..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "completion_tokens": 239,
    "prompt_tokens": 8,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "total_tokens": 247
  }
}

Best Practices

Recommended scenarios to enable:

• Complex problem analysis and solving
• Multi-step reasoning tasks
• Technical solution design
• Strategy planning and decision
• Academic research and analysis
• Creative writing and content creation

Can be disabled scenarios:

• Simple fact query
• Basic translation tasks
• Simple classification judgment
• Quick question and answer requirements

Application scenarios

Academic Research

• Research method design
• Data analysis and explanation
• Theory deduction and proof

Technology Consulting

• System architecture design
• Technological scheme evaluation
• Problem diagnosis and solution

Business Analysis

• Market trends analysis
• Business model design
• Investment decision support

Education Training

• Complex concept explanation
• Learning path planning
• Knowledge system building

Notes

1. Response time：Enable deep thinking will increase response time, particularly for complex tasks
2. Token consumption：Thinking process will consume extra tokens, please manage your tokens
3. Model support：Ensure you’re using models that support deep thinking
4. Task matching：Choose whether to enable deep thinking according to the task complexity
5. Streaming output：Combine streaming output to see the thinking process, improving user experience