The short answer
For a new DeepSeek API integration, don’t treat deepseek-chat and deepseek-reasoner as two current model choices. DeepSeek’s V3.1 announcement mapped those names to non-thinking and thinking modes, respectively; its changelog gave July 24, 2026 as their discontinuation date. The current API quickstart instead lists deepseek-flash and deepseek-v4-pro. Flash supports both thinking and non-thinking modes, so you can choose a mode for each request. (Change Log; V3.1 announcement; API quickstart)
Practical rule: start with non-thinking for routine requests where concise output matters. Try thinking mode for tasks that benefit from more reasoning effort. This is a workload-based starting point, not a guarantee that thinking mode is more accurate or faster for any specific request.
DeepSeek Chat vs Reasoner at a glance
| Question | What the documentation supports |
|---|---|
| Are these still the two API model names to choose between? | No. The current API quickstart lists deepseek-flash and deepseek-v4-pro; the old names were scheduled for discontinuation on July 24, 2026. |
| What did Chat vs Reasoner mean? | DeepSeek’s V3.1 announcement mapped deepseek-chat to non-thinking mode and deepseek-reasoner to thinking mode. It listed 128K context for both at that time. |
| Can one current model handle both styles? | Yes. The current documentation says deepseek-flash supports thinking and non-thinking modes. Its listed version is DeepSeek-V4.1-Flash-1017. |
| Is one proven faster or more accurate? | The sources cited here do not provide a controlled, current head-to-head latency or accuracy comparison between the two legacy modes. |
The historical mapping does not mean the old identifiers are still available or that earlier specifications apply to the current model. (V3.1 announcement; API quickstart; Models & Pricing)
Which mode fits your workload?
- Routine conversation, short summaries, or straightforward writing: start with non-thinking if concise output is what you need.
- Multi-step math, logic, or coding problems: try thinking mode when the task may benefit from additional reasoning effort; check consequential answers independently.
- Tool-using workflows: the current docs list tool calls for Flash and document tool use in thinking mode. If you include a
toolsparameter on a follow-up Chat Completions request, pass back the prior turns’reasoning_contentas documented. (Models & Pricing; Tool Calls; Thinking Mode)
These are practical heuristics, not a current official task ranking. A third-party guide historically described V3 Chat as general-purpose and direct-answering, and R1 as reasoning-oriented; it does not establish that those descriptions or historical specifications apply to today’s API model. (BentoML’s DeepSeek guide)
What to use in a production API request
The current quickstart shows the chat-completions endpoint, bearer-token authentication, and deepseek-flash as the model name. The thinking-mode guide documents the thinking toggle and reasoning_effort values of low, high, and max. Thinking is enabled by default in that guide, so explicitly set the mode you intend to use. (API quickstart; Thinking Mode)
Example request body for an ordinary, non-thinking call:
{
"model": "deepseek-flash",
"messages": [
{"role": "user", "content": "Summarize this paragraph in two sentences."}
],
"thinking": {"type": "disabled"},
"stream": false
}
For a reasoning-oriented request, use "thinking": {"type": "enabled"}. You may set reasoning_effort to low, high, or max; the guide says the actual mapped effort can differ from the requested label. In thinking mode, the response includes reasoning_content alongside the final content. The docs say that when a follow-up request includes tools, prior reasoning_content should be passed back; without tools, it is not needed and will be ignored if passed. (Thinking Mode)
For tool compatibility, DeepSeek documents tool use in thinking mode from V3.2 onward and provides a non-thinking Flash tool-call example. Its current pricing/model page also lists tool calls as a Flash feature. The docs distinguish ordinary model-generated tool calls from inserting tool-call messages mid-conversation: Chat Completions does not support the latter; use the Anthropic or Responses API for that case. (Tool Calls; Models & Pricing)
Current API pricing: compare modes, not retired aliases
DeepSeek’s pricing page lists rates per 1 million tokens and says model usage is billed based on total input and output tokens. The table lists one deepseek-flash rate card, not separate thinking and non-thinking prices. It displays dollar-sign ($) rates but does not identify a currency code in the cited text. (Models & Pricing)
| DeepSeek Flash token type | Off-peak | Peak |
|---|---|---|
| Input, cache miss | $0.15 / 1M tokens | $0.30 / 1M tokens |
| Input, cache hit | $0.003 / 1M tokens | $0.006 / 1M tokens |
| Output | $0.60 / 1M tokens | $1.20 / 1M tokens |
The pricing page defines peak hours as 01:00–04:00 and 06:00–10:00 UTC, Monday through Friday, excluding Chinese public holidays. All other hours—including weekends and Chinese public holidays—are off-peak. DeepSeek notes that prices may change, so check its live pricing page when estimating spend. (Models & Pricing)
Worked example (hypothetical): 100,000 uncached input tokens and 10,000 output tokens cost $0.021 off-peak: (0.1 × $0.15) + (0.01 × $0.60). At peak rates, the same usage costs $0.042. These estimates use the table’s dollar-sign rates and exclude any other charges.
The pricing page says billing is based on total input and output tokens, and the thinking guide says reasoning_content is returned alongside content. The cited documentation does not explicitly say whether reasoning tokens are included in billed output-token counts. Account for that as an unresolved billing detail when estimating thinking-mode costs; do not assume only the visible final answer determines the output charge. The published table does not show separate token rates by mode. (Models & Pricing; Thinking Mode)
Bottom line
For a new integration, use the current model ID deepseek-flash and explicitly choose thinking or non-thinking mode for each request. Start with non-thinking for routine tasks; evaluate thinking mode for complex, multi-step work. Before rollout, test both modes on representative prompts and compare answer quality, end-to-end latency, token usage, and cost in your workload. The current documentation provides mode controls and a single Flash rate card, but not a universal quality or latency winner—or an explicit statement about how reasoning_content is counted for billing.
Sources
Change Log | DeepSeek API Docs
DeepSeek-V3.1 Release | DeepSeek API Docs
Your First API Call | DeepSeek API Docs
Models & Pricing | DeepSeek API Docs
Thinking Mode | DeepSeek API Docs
Tool Calls | DeepSeek API Docs
The Complete Guide to DeepSeek Models: V3, R1, V4 and Beyond
