1# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 2
 3from typing import Optional
 4from typing_extensions import Literal
 5
 6from ..._models import BaseModel
 7from .reasoning_effort import ReasoningEffort
 8
 9__all__ = ["Reasoning"]
10
11
12class Reasoning(BaseModel):
13    effort: Optional[ReasoningEffort] = None
14    """
15    Constrains effort on reasoning for
16    [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
17    supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
18    Reducing reasoning effort can result in faster responses and fewer tokens used
19    on reasoning in a response.
20
21    - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
22      reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
23      calls are supported for all reasoning values in gpt-5.1.
24    - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
25      support `none`.
26    - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
27    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
28    """
29
30    generate_summary: Optional[Literal["auto", "concise", "detailed"]] = None
31    """**Deprecated:** use `summary` instead.
32
33    A summary of the reasoning performed by the model. This can be useful for
34    debugging and understanding the model's reasoning process. One of `auto`,
35    `concise`, or `detailed`.
36    """
37
38    summary: Optional[Literal["auto", "concise", "detailed"]] = None
39    """A summary of the reasoning performed by the model.
40
41    This can be useful for debugging and understanding the model's reasoning
42    process. One of `auto`, `concise`, or `detailed`.
43
44    `concise` is only supported for `computer-use-preview` models.
45    """