DeepSeek 思考开关

概念介绍

思考参数（thinking）用于控制模型在响应前是否显示思考过程。该功能适用于需要观察模型推理过程的场景，可提升模型响应的可解释性，帮助开发者理解模型的决策逻辑。

注意：DeepSeek 不同版本模型的思考功能配置参数存在差异，以下分别说明 V3.1 和 V3.2 版本的具体配置方法。

DeepSeek V3.1 模型开启思考说明

参数说明

V3.1 版本通过 thinking 参数配置思考过程，该参数为结构体，核心字段如下：

字段	类型	必填	描述
`thinking\.type`	String	是	用于控制是否显示思考过程，可选值仅以下两种：- `enabled`：强制开启思考过程；- `disabled`：强制关闭思考过程。

JSON示例

V3.1 版本配置思考功能的完整请求示例：

{
    "model": "deepseek-ai/DeepSeek-V3.1-Terminus",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "9.9和9.11哪个大"
                }
            ]
        }
    ],
    "thinking": {
        "type": "enabled"
    }
}

模型支持情况

支持模型
deepseek-ai/DeepSeek-V3.1
deepseek-ai/DeepSeek-V3.1-Terminus

API 接口示例（Python）

import json
import requests

# 配置API密钥
api_key = "******"  # 替换为你的 APIKEY
url = "https://api.modelverse.cn/v1/chat/completions"

headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
data = {
    "model": "deepseek-ai/DeepSeek-V3.1-Terminus",  # 指定V3.1版本支持模型
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "9.9和9.11哪个大",  # 用户提问
                }
            ],
        }
    ],
    "thinking": {"type": "enabled"},  # 开启思考功能，可选 enabled/disabled
}

try:
    response = requests.post(url, headers=headers, json=data)
    response.raise_for_status() 

    print("请求成功!")
    print(json.dumps(response.json(), indent=2, ensure_ascii=False))

except requests.exceptions.RequestException as e:
    print(f"请求失败: {e}")

DeepSeek V3.2 模型开启思考说明

参数说明

V3.2 版本通过 chat\_template\_kwargs 参数配置思考过程，该参数为结构体，核心字段如下：

字段	类型	必填	描述
`chat\_template\_kwargs\.thinking`	Boolean	是	用于控制是否显示思考过程，可选值仅以下两种：- `true`：强制开启思考过程；- `false`：强制关闭思考过程。

JSON示例

V3.2 版本配置思考功能的完整请求示例：

{
    "model": "deepseek-ai/DeepSeek-V3.2",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "9.9和9.11哪个大"
                }
            ]
        }
    ],
    "chat_template_kwargs": {
        "thinking": true
    }
}

模型支持情况

支持模型
deepseek-ai/DeepSeek-V3.2

API 接口示例（Python）

import json
import requests

# 配置API密钥
api_key = "******"  # 替换为你的 APIKEY
url = "https://api.modelverse.cn/v1/chat/completions"

headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
data = {
    "model": "deepseek-ai/DeepSeek-V3.2",  # 指定V3.2版本支持模型
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "9.9和9.11哪个大",  # 用户提问
                }
            ],
        }
    ],
    "chat_template_kwargs": {
        "thinking": true  # 开启思考功能，可选 true/false
    }
}

try:
    response = requests.post(url, headers=headers, json=data)
    response.raise_for_status()

    print("请求成功!")
    print(json.dumps(response.json(), indent=2, ensure_ascii=False))

except requests.exceptions.RequestException as e:
    print(f"请求失败: {e}")

注意事项

V3.1 与 V3.2 版本的思考功能配置参数不通用，需根据使用的模型版本选择对应配置方式，配置错误会导致功能失效。
思考功能会增加少量响应时间，建议根据场景合理选择开启与否；复杂推理场景开启可提升可解释性，简单问答场景可关闭以减少延迟。
示例中 api\_key 需替换为个人实际 API 密钥，否则会导致请求失败。