DeepSeek reasoning effort: controls, cost and verification
Reasoning effort is not a quality switch. It buys depth with latency, tokens, and quota; raising it on simple tasks mostly wastes budget.
What it controls
It controls the thinking budget, not the answer style.
| Setting | Thinking | Latency | Tokens | Suited to |
|---|---|---|---|---|
| Low | Less | Short | Few | Simple transformations |
| Medium | Moderate | Moderate | Medium | Most daily tasks |
| High | More | Long | Many | Multi-step reasoning |
Thinking tokens count too. They are consumed during reasoning and affect input and output limits and billing (source).
The trade-off is nonlinear. Doubling thinking does not double quality; gains diminish with task difficulty.
It is independent of output limit. Output limit caps the answer; reasoning effort changes the process.
When to raise it
Raise it when tasks need more steps, not when answers "feel short."
- Multi-step reasoning: planning, comparison, proof.
- Ambiguous constraints: reconciling conflicting requirements.
- Long chains: tasks needing several dependent judgments.
- Verification: review and consistency checks.
- Coding and refactoring: cross-file reasoning.
Simple tasks see limited gains. Formatting, extraction, and translation rarely need high effort; latency rises and quality changes little.
Do not raise it by default. A low baseline with targeted increases saves more than a high baseline everywhere.
Cost and latency
Three cost layers, each visible separately.
- Latency: more thinking means longer first-token and total time.
- Tokens: thinking consumes quota, affecting budget and rate limits.
- Rate limits: higher token use makes limits more likely.
The cost is not only money. Higher effort slows interaction and crowds out other requests.
Measure with the same task. Comparing different prompts mixes variables; fix the task and change only effort.
Think about peak periods. High effort at peak is most likely to hit rate limits.
Turning it off or down
Lower effort is the first lever when speed matters.
- Reduce effort before changing models.
- For short tasks, use the lowest setting.
- Split long tasks into steps rather than raising effort.
- For batch jobs, fix a lower effort and verify quality.
- Record the setting used for comparison.
Splitting beats raising effort. Breaking a large task into clear steps often matches high effort at lower latency.
The lowest setting is not always bad. Many daily tasks do not need extended reasoning.
Verification
Three checks confirm the effect.
- Parameters: check that the request carries the intended setting.
- Response: look for reasoning fields or process traces.
- Metrics: compare latency and token usage before and after.
Do not infer from answer length. A longer answer may be more output, not more thinking.
Keep a task set for comparison. The same few tasks make settings comparable.
Common problems
Four frequent problems.
- No difference: task is too simple, or the setting is not applied; check parameters.
- Much slower: expected; decide whether depth is worth the latency.
- Rate limited: thinking tokens raised usage; lower effort or switch channels.
- Truncated answer: output limit, not reasoning; see output token guidance.
Each maps to a different layer. Effort, output limit, and quota are separate.
Practical configuration
Keep it simple: a baseline plus task overrides.
- Set a daily baseline, medium by default.
- Write explicit overrides for complex tasks.
- Batch jobs use low effort with spot checks.
- Record usage and adjust by quarter.
- Document settings so teams stay consistent.
Configuration should be reviewable. One line explaining "why high" is more useful than everyone guessing.
Next steps
Set baseline, measure, adjust. For output limits, read Output token limit and truncated replies. For quota, read request quota exhausted. For provider setup, read How to configure models.
Sources: DeepSeek API docs, DeepSeek Harness docs, dsh CLI README
FAQ
Reasoning effort is not the same as the output token limit. The limit caps the final answer, while effort controls how much thinking the model does before answering.
Higher reasoning effort does not always improve DeepSeek Harness answers. Simple tasks see limited gains and higher latency, while complex tasks benefit more.
Raising reasoning effort can get you rate limited because thinking tokens also count. Higher effort consumes quota faster.
To tell whether thinking is actually on in DeepSeek Harness, check request parameters and response fields. Then compare latency and token usage.
Related Terms
- reasoning effort
- Reasoning effort is a control over how much internal thinking the model does before answering; it trades latency and tokens for reasoning depth.— DeepSeek API docs
- thinking token
- Thinking tokens are tokens consumed during reasoning, counted in input and output limits and billing.— DeepSeek API docs
- latency
- Latency is the time from sending a request to receiving the first output or a complete reply, extended by more reasoning.— DeepSeek Harness docs
- verification
- Verification compares parameters, latency, and output under different reasoning settings to confirm the effect.— DeepSeek Harness docs
Sources
- DeepSeek API docs· DeepSeek
- DeepSeek Harness docs· deepseek-harness
- dsh CLI README· deepseek-ai