--- title: "思考模式 | DeepSeek API Docs" source: "https://api-docs.deepseek.com/zh-cn/guides/thinking_mode" author: published: created: 2026-03-18 description: "DeepSeek 模型支持思考模式:在输出最终回答之前,模型会先输出一段思维链内容,以提升最终答案的准确性。您可以通过以下任意一种方式,开启思考模式:" tags: - "clippings" --- ## 思考模式 DeepSeek 模型支持思考模式:在输出最终回答之前,模型会先输出一段思维链内容,以提升最终答案的准确性。您可以通过以下任意一种方式,开启思考模式: 1. 设置 `model` 参数: `"model": "deepseek-reasoner"` 2. 设置 `thinking` 参数: `"thinking": {"type": "enabled"}` 如果您使用的是 OpenAI SDK,在设置 `thinking` 参数时,需要将 `thinking` 参数传入 `extra_body` 中: ```python response = client.chat.completions.create( model="deepseek-chat", # ... extra_body={"thinking": {"type": "enabled"}} ) ``` ## API 参数 - **输入参数** : - `max_tokens` :模型单次回答的最大长度(含思维链输出),默认为 32K,最大为 64K。 - **输出字段** : - `reasoning_content` :思维链内容,与 `content` 同级,访问方法见 [样例代码](https://api-docs.deepseek.com/zh-cn/guides/thinking_mode#%E6%A0%B7%E4%BE%8B%E4%BB%A3%E7%A0%81) 。 - `content` :最终回答内容。 - `tool_calls`: 模型工具调用。 - **支持的功能** : [Json Output](https://api-docs.deepseek.com/zh-cn/guides/json_mode) 、 [Tool Calls](https://api-docs.deepseek.com/zh-cn/guides/tool_calls) 、 [对话补全](https://api-docs.deepseek.com/zh-cn/api/create-chat-completion) , [对话前缀续写 (Beta)](https://api-docs.deepseek.com/zh-cn/guides/chat_prefix_completion) - **不支持的功能** :FIM 补全 (Beta) - **不支持的参数** : `temperature` 、 `top_p` 、 `presence_penalty` 、 `frequency_penalty` 、 `logprobs` 、 `top_logprobs` 。请注意,为了兼容已有软件,设置 `temperature` 、 `top_p` 、 `presence_penalty` 、 `frequency_penalty` 参数不会报错,但也不会生效。设置 `logprobs` 、 `top_logprobs` 会报错。 ## 多轮对话拼接 在每一轮对话过程中,模型会输出思维链内容( `reasoning_content` )和最终回答( `content` )。在下一轮对话中,之前轮输出的思维链内容不会被拼接到上下文中,如下图所示: ![](https://api-docs.deepseek.com/zh-cn/img/deepseek_r1_multiround_example_cn.jpeg) ### 样例代码 下面的代码以 Python 语言为例,展示了如何访问思维链和最终回答,以及如何在多轮对话中进行上下文拼接。注意代码中在新一轮对话里,只传入了上一轮输出的 `content` ,而忽略了 `reasoning_content` 。 - 非流式 - 流式 ```python from openai import OpenAI client = OpenAI(api_key="", base_url="https://api.deepseek.com") # Turn 1 messages = [{"role": "user", "content": "9.11 and 9.8, which is greater?"}] response = client.chat.completions.create( model="deepseek-reasoner", messages=messages ) reasoning_content = response.choices[0].message.reasoning_content content = response.choices[0].message.content # Turn 2 messages.append({'role': 'assistant', 'content': content}) messages.append({'role': 'user', 'content': "How many Rs are there in the word 'strawberry'?"}) response = client.chat.completions.create( model="deepseek-reasoner", messages=messages ) # ... ``` ## 工具调用 我们为 DeepSeek 模型的思考模式增加了工具调用功能。模型在输出最终答案之前,可以进行多轮的思考与工具调用,以提升答案的质量。其调用模式如下图所示: ![](https://api-docs.deepseek.com/zh-cn/img/v3.2_thinking_with_tools.jpeg) - 在回答问题 1 过程中(请求 1.1 - 1.3),模型进行了多次思考 + 工具调用后给出答案。在这个过程中,用户需回传思维链内容(reasoning\_content)给 API,以让模型继续思考。 - 在下一个用户问题开始时(请求 2.1),需删除之前的 `reasoning_content` ,并保留其它内容发送给 API。如果保留了 `reasoning_content` 并发送给 API,API 将会忽略它们。 ### 兼容性提示 因思考模式下的工具调用过程中要求用户回传 `reasoning_content` 给 API,若您的代码中未正确回传 `reasoning_content` ,API 会返回 400 报错。正确回传方法请您参考下面的样例代码。 ### 样例代码 下面是一个简单的在思考模式下进行工具调用的样例代码: ```python import os import json from openai import OpenAI # The definition of the tools tools = [ { "type": "function", "function": { "name": "get_date", "description": "Get the current date", "parameters": { "type": "object", "properties": {} }, } }, { "type": "function", "function": { "name": "get_weather", "description": "Get weather of a location, the user should supply the location and date.", "parameters": { "type": "object", "properties": { "location": { "type": "string", "description": "The city name" }, "date": { "type": "string", "description": "The date in format YYYY-mm-dd" }, }, "required": ["location", "date"] }, } }, ] # The mocked version of the tool calls def get_date_mock(): return "2025-12-01" def get_weather_mock(location, date): return "Cloudy 7~13°C" TOOL_CALL_MAP = { "get_date": get_date_mock, "get_weather": get_weather_mock } def clear_reasoning_content(messages): for message in messages: if hasattr(message, 'reasoning_content'): message.reasoning_content = None def run_turn(turn, messages): sub_turn = 1 while True: response = client.chat.completions.create( model='deepseek-chat', messages=messages, tools=tools, extra_body={ "thinking": { "type": "enabled" } } ) messages.append(response.choices[0].message) reasoning_content = response.choices[0].message.reasoning_content content = response.choices[0].message.content tool_calls = response.choices[0].message.tool_calls print(f"Turn {turn}.{sub_turn}\n{reasoning_content=}\n{content=}\n{tool_calls=}") # If there is no tool calls, then the model should get a final answer and we need to stop the loop if tool_calls is None: break for tool in tool_calls: tool_function = TOOL_CALL_MAP[tool.function.name] tool_result = tool_function(**json.loads(tool.function.arguments)) print(f"tool result for {tool.function.name}: {tool_result}\n") messages.append({ "role": "tool", "tool_call_id": tool.id, "content": tool_result, }) sub_turn += 1 client = OpenAI( api_key=os.environ.get('DEEPSEEK_API_KEY'), base_url=os.environ.get('DEEPSEEK_BASE_URL'), ) # The user starts a question turn = 1 messages = [{ "role": "user", "content": "How's the weather in Hangzhou Tomorrow" }] run_turn(turn, messages) # The user starts a new question turn = 2 messages.append({ "role": "user", "content": "How's the weather in Hangzhou Tomorrow" }) # We recommended to clear the reasoning_content in history messages so as to save network bandwidth clear_reasoning_content(messages) run_turn(turn, messages) ``` 在 Turn 1 的每个子请求中,都携带了该 Turn 下产生的 `reasoning_content` 给 API,从而让模型继续之前的思考。 `response.choices[0].message` 携带了 `assistant` 消息的所有必要字段,包括 `content` 、 `reasoning_content` 、 `tool_calls` 。简单起见,可以直接用如下代码将消息 append 到 messages 结尾: ```markdown messages.append(response.choices[0].message) ``` 这行代码等价于: ```markdown messages.append({ 'role': 'assistant', 'content': response.choices[0].message.content, 'reasoning_content': response.choices[0].message.reasoning_content, 'tool_calls': response.choices[0].message.tool_calls, }) ``` 在 Turn 2 开始时,我们建议丢弃掉之前 Turn 中的 `reasoning_content` 来节省网络带宽: ```markdown clear_reasoning_content(messages) ``` 该代码的样例输出如下: ```bash Turn 1.1 reasoning_content="The user is asking about the weather in Hangzhou tomorrow. I need to get the current date first, then calculate tomorrow's date, and then call the weather API. Let me start by getting the current date." content='' tool_calls=[ChatCompletionMessageToolCall(id='call_00_Tcek83ZQ4fFb1RfPQnsPEE5w', function=Function(arguments='{}', name='get_date'), type='function', index=0)] tool_result(get_date): 2025-12-01 Turn 1.2 reasoning_content='Today is December 1, 2025. Tomorrow is December 2, 2025. I need to format the date as YYYY-mm-dd: "2025-12-02". Now I can call get_weather with location Hangzhou and date 2025-12-02.' content='' tool_calls=[ChatCompletionMessageToolCall(id='call_00_V0Uwt4i63m5QnWRS1q1AO1tP', function=Function(arguments='{"location": "Hangzhou", "date": "2025-12-02"}', name='get_weather'), type='function', index=0)] tool_result(get_weather): Cloudy 7~13°C Turn 1.3 reasoning_content="I have the weather information: Cloudy with temperatures between 7 and 13°C. I should respond in a friendly, helpful manner. I'll mention that it's for tomorrow (December 2, 2025) and give the details. I can also ask if they need any other information. Let's craft the response." content="Tomorrow (Tuesday, December 2, 2025) in Hangzhou will be **cloudy** with temperatures ranging from **7°C to 13°C**. \n\nIt might be a good idea to bring a light jacket if you're heading out. Is there anything else you'd like to know about the weather?" tool_calls=None Turn 2.1 reasoning_content="The user wants clothing advice for tomorrow based on the weather in Hangzhou. I know tomorrow's weather: cloudy, 7-13°C. That's cool but not freezing. I should suggest layered clothing, maybe a jacket, long pants, etc. I can also mention that since it's cloudy, an umbrella might not be needed unless there's rain chance, but the forecast didn't mention rain. I should be helpful and give specific suggestions. I can also ask if they have any specific activities planned to tailor the advice. Let me respond." content="Based on tomorrow's forecast of **cloudy weather with temperatures between 7°C and 13°C** in Hangzhou, here are some clothing suggestions:\n\n**Recommended outfit:**\n- **Upper body:** A long-sleeve shirt or sweater, plus a light to medium jacket (like a fleece, windbreaker, or light coat)\n- **Lower body:** Long pants or jeans\n- **Footwear:** Closed-toe shoes or sneakers\n- **Optional:** A scarf or light hat for extra warmth, especially in the morning and evening\n\n**Why this works:**\n- The temperature range is cool but not freezing, so layering is key\n- Since it's cloudy but no rain mentioned, you likely won't need an umbrella\n- The jacket will help with the morning chill (7°C) and can be removed if you warm up during the day\n\n**If you have specific plans:**\n- For outdoor activities: Consider adding an extra layer\n- For indoor/office settings: The layered approach allows you to adjust comfortably\n\nWould you like more specific advice based on your planned activities?" tool_calls=None ```