reasoning_effort parameter.
Supported models
Reasoning is available on models that support chain-of-thought, including:deepseek-ai/DeepSeek-R1
Controlling reasoning effort
Usereasoning_effort to control how much reasoning the model performs. Higher effort means deeper thinking but more output tokens and higher latency.
Disabling reasoning
Setreasoning_effort to "none" to disable chain-of-thought entirely. The model will respond directly without a reasoning trace — faster and cheaper.
The reasoning parameter
For more granular control, use the reasoning object instead of reasoning_effort:
"enabled": false is equivalent to reasoning_effort: "none".
When to use reasoning
Supported parameters
Notes
- Reasoning tokens count toward output token billing
- Disabling reasoning on a reasoning model makes it behave like a standard chat model
reasoning_effort: "none"is equivalent toreasoning: { enabled: false }- Not all models support reasoning — using these parameters on a non-reasoning model has no effect
Chat Completions
Full chat completions API reference.
Streaming
Stream reasoning responses token by token.
Prompt Caching
Cache long prompts for faster reasoning.