Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
context | OptionalNullable[components.ReasoningContext] | ➖ | Controls which reasoning is available to the model. auto uses the model default (same as omitting); all_turns includes reasoning from earlier turns passed in input; current_turn limits to the current turn only. Only supported by OpenAI GPT-5.6 and newer. | all_turns |
effort | OptionalNullable[components.ChatRequestEffort] | ➖ | Constrains effort on reasoning for reasoning models | medium |
enabled | Optional[bool] | ➖ | Enables reasoning with default settings. Defaults to being inferred from effort or max_tokens. | true |
exclude | Optional[bool] | ➖ | When true, the model still reasons but the reasoning is omitted from the response. Defaults to false. | false |
max_tokens | OptionalNullable[int] | ➖ | Maximum number of tokens the model may spend on reasoning, for models that take a reasoning token budget instead of an effort level. Cannot be combined with reasoning.effort or the top-level reasoning_effort: a request that sets both is rejected with “Only one of “reasoning.effort” and “reasoning.max_tokens” can be specified”. | 2000 |
mode | OptionalNullable[components.ReasoningMode] | ➖ | Selects the reasoning mode. standard is the default; pro engages deeper reasoning on models that support it, billed at standard token rates. Only supported by OpenAI GPT-5.6 and newer. | standard |
summary | OptionalNullable[components.ChatReasoningSummaryVerbosityEnum] | ➖ | N/A | concise |