DeepSeek API 思考模式怎麼開：reasoning_effort 三檔、reasoning_content 與 deepseek-reasoner 的現狀

本文根據 DeepSeek 官方思考模式文檔和更新日誌整理，資料核對於 2026-10-24。參數可能調整，以官方文檔為準。圖為本站整理的示意圖。

適用於誰

• 搜「deepseek reasoning effort」「deepseek reasoner」的開發者；
• 想知道 deepseek-reasoner 現在該換成什麼的人；
• 調用時思考內容怎麼取、多輪對話要不要回傳，搞不清楚的人。

結論先說

1. 現在不需要單獨的「推理模型」：deepseek-flash 和 deepseek-v4-pro 都同時支持思考與非思考模式，預設開啟思考，強度預設 high。
2. 強度有三檔：low、high、max。官方 2026-08-13 的更新日誌建議：簡單任務用 low，日常 Agent 任務用 high，更復雜的任務用 max。
3. deepseek-reasoner 是舊模型名。官方 2026-04-24 說它將於 2026-07-24 停用（過渡期內指向 deepseek-v4-flash 的思考模式）；價格頁現在只列新名字。新項目請直接用 deepseek-flash 並按需開關思考。
4. 思考模式下 temperature 等採樣參數不生效，不會報錯也不起作用；要靠它們控制隨機性，請關閉思考模式。
5. 只要請求帶了 tools，就必須把歷史的 reasoning_content 完整回傳，否則返回 400。

圖：本站根據 DeepSeek 官方思考模式文檔 整理的示意圖

一、怎麼開、怎麼設

官方文檔按三種接口給出參數：

注意幾點：

• 預設開啟，預設 high；
• 在 OpenAI SDK 裏用 Chat Completion 時，thinking 參數要放進 extra_body，而 reasoning_effort 是普通參數：

python
response = client.chat.completions.create(
    model="deepseek-flash",
    messages=messages,
    reasoning_effort="high",
    extra_body={"thinking": {"type": "enabled"}},
)

• Anthropic 格式裏 thinking 被支持，但 budget_tokens 會被忽略，output_config 只支持 effort（Anthropic API 兼容性文檔）；
• 關閉思考的寫法是 {"thinking": {"type": "disabled"}}（Responses 格式則是 effort 設成 none）。

二、傳了別的檔位名會怎樣

官方給了一張映射表，你傳的 effort 會被映射到實際檔位：

也就是說，實際只有 low、high、max 三檔，其他名字都是別名。這樣設計是為了兼容別的工具裏常見的檔位名。

圖：本站根據 DeepSeek 官方更新日誌 整理的示意圖

三、思考模式下哪些參數沒用

官方文檔寫明，思考模式不支持 temperature、presence_penalty、frequency_penalty，設定了不會報錯，但也不會生效（為了兼容已有軟件）。top_p 的行為因模型而異：

• deepseek-flash：只在思考模式下生效，有效範圍 0.95–1.0，低於 0.95 按 0.95 處理；非思考模式下恆為 1.0，傳入值會被忽略；
• deepseek-v4-pro：思考模式下忽略傳入值（攜帶 tools 時固定為 0.95，否則 1.0）；非思考模式下生效。

四、reasoning_content 怎麼取、要不要回傳

思考模式下，思維鏈內容通過 reasoning_content 返回，和 content 同級。後續輪次是否需要回傳它，取決於請求有沒有帶 tools：

• 沒有帶 tools：reasoning_content 不需要回傳；即使傳了也會被忽略，不會拼進上下文。你只需要把 content 放回對話歷史；
• 帶了 tools：歷史輪次的 reasoning_content 都要回傳，並且會被拼進上下文。官方強調，帶了 tools 的請求，在後續所有請求裏都必須完整回傳，即使那一輪模型沒有真的調用工具。沒有正確回傳，API 返回 400。

最穩妥的寫法，是直接把返回的 message 整個追加到 messages：

python
messages.append(response.choices[0].message)

這一行等價於手動追加 content、reasoning_content 和 tool_calls。工具調用的更多內容見 /guides/deepseek-json-output-function-calling，報錯 400 的其他原因見 /guides/deepseek-api-error-codes。

五、什麼時候該開、什麼時候該關

官方沒有給「必須開 / 必須關」的規則，下面是根據官方參數說明整理的思路：

• 需要多步推理、寫代碼、數學、規劃：保持預設開啟，從 high 開始；覺得慢或貴，試 low；
• 簡單問答、改寫、翻譯、分類：可以關閉思考，響應通常更快、輸出更短；
• 想調 temperature 控制風格：關閉思考；
• JSON 輸出 / 工具調用：兩種模式都可以用，但帶 tools 時要注意回傳。

思考相關的使用技巧，見 /guides/chain-of-thought-thinking-mode-when-to-use；網頁版的「深度思考」開關見 /guides/deepseek-deep-thinking-web-search。

常見問題

Q：deepseek-reasoner 還能用嗎？

官方 2026-04-24 公告說 2026-07-24 停用，當前價格頁沒有這個名字。建議改成 deepseek-flash 並保持思考開啟（預設就是）。

Q：思考內容算錢嗎？

價格頁按輸入和輸出的總 token 計費，官方沒有把思維鏈單獨列出來；Responses API 文檔裏 usage 會返回 reasoning_tokens（思維鏈 token 數），可用來觀察。具體費用以官方價格頁為準，見 /guides/deepseek-v4-pro-vs-flash-api-price。

Q：我只想要最終答案，不想要思考內容？

讀取 content 即可，reasoning_content 是單獨字段，不會混進 content。

Q：Python 完整示例在哪？

見 /guides/deepseek-api-python-quickstart。

想同時用 ChatGPT、Claude 等海外模型做對比？本站提供 AI 會員充值，ChatGPT 可看 Plus 充值。

參考資料

• DeepSeek API 文檔：思考模式 — https://api-docs.deepseek.com/zh-cn/guides/thinking_mode
• DeepSeek API 文檔：更新日誌 — https://api-docs.deepseek.com/zh-cn/updates
• DeepSeek API 文檔：模型 & 價格 — https://api-docs.deepseek.com/zh-cn/quick_start/pricing
• DeepSeek API 文檔：使用 Responses API — https://api-docs.deepseek.com/zh-cn/guides/responses_api
• DeepSeek API 文檔：使用 Anthropic API — https://api-docs.deepseek.com/zh-cn/guides/anthropic_api