feat(api): gpt 5.2

stainless-app[bot] · stainless-app[bot] · commit 752a293da54c · 2025-12-11T18:17:45.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 137
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-88d85ff87ad8983262af2b729762a6e05fd509468bb691529bc2f81e4ce27c69.yml
-openapi_spec_hash: 46a55acbccd0147534017b92c1f4dd99
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-41f98da99f44ebe6204fce5c1dc9940f85f3472779e797b674c4fdc20306c77d.yml
+openapi_spec_hash: c61259027f421f501bdc6b23cf9e430e
 config_hash: 141b101c9f13b90e21af74e1686f1f41
diff --git a/src/openai/resources/beta/assistants.py b/src/openai/resources/beta/assistants.py
@@ -108,7 +108,7 @@ def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: Specifies the format that the model must output. Compatible with
               [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -323,7 +323,7 @@ def update(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: Specifies the format that the model must output. Compatible with
               [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -577,7 +577,7 @@ async def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: Specifies the format that the model must output. Compatible with
               [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -792,7 +792,7 @@ async def update(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: Specifies the format that the model must output. Compatible with
               [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
diff --git a/src/openai/resources/beta/threads/runs/runs.py b/src/openai/resources/beta/threads/runs/runs.py
@@ -179,7 +179,7 @@ def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: Specifies the format that the model must output. Compatible with
               [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -341,7 +341,7 @@ def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: Specifies the format that the model must output. Compatible with
               [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -499,7 +499,7 @@ def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: Specifies the format that the model must output. Compatible with
               [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -1633,7 +1633,7 @@ async def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: Specifies the format that the model must output. Compatible with
               [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -1795,7 +1795,7 @@ async def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: Specifies the format that the model must output. Compatible with
               [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -1953,7 +1953,7 @@ async def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: Specifies the format that the model must output. Compatible with
               [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
diff --git a/src/openai/resources/chat/completions/completions.py b/src/openai/resources/chat/completions/completions.py
@@ -421,7 +421,7 @@ def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: An object specifying the format that the model must output.
 
@@ -732,7 +732,7 @@ def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: An object specifying the format that the model must output.
 
@@ -1034,7 +1034,7 @@ def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: An object specifying the format that the model must output.
 
@@ -1907,7 +1907,7 @@ async def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: An object specifying the format that the model must output.
 
@@ -2218,7 +2218,7 @@ async def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: An object specifying the format that the model must output.
 
@@ -2520,7 +2520,7 @@ async def create(
               - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 support `none`.
               - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
 
           response_format: An object specifying the format that the model must output.
 
diff --git a/src/openai/resources/responses/responses.py b/src/openai/resources/responses/responses.py
@@ -1528,6 +1528,11 @@ def compact(
         *,
         model: Union[
             Literal[
+                "gpt-5.2",
+                "gpt-5.2-2025-12-11",
+                "gpt-5.2-chat-latest",
+                "gpt-5.2-pro",
+                "gpt-5.2-pro-2025-12-11",
                 "gpt-5.1",
                 "gpt-5.1-2025-11-13",
                 "gpt-5.1-codex",
@@ -3141,6 +3146,11 @@ async def compact(
         *,
         model: Union[
             Literal[
+                "gpt-5.2",
+                "gpt-5.2-2025-12-11",
+                "gpt-5.2-chat-latest",
+                "gpt-5.2-pro",
+                "gpt-5.2-pro-2025-12-11",
                 "gpt-5.1",
                 "gpt-5.1-2025-11-13",
                 "gpt-5.1-codex",
diff --git a/src/openai/types/beta/assistant_create_params.py b/src/openai/types/beta/assistant_create_params.py
@@ -72,7 +72,7 @@ class AssistantCreateParams(TypedDict, total=False):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     response_format: Optional[AssistantResponseFormatOptionParam]
diff --git a/src/openai/types/beta/assistant_update_params.py b/src/openai/types/beta/assistant_update_params.py
@@ -107,7 +107,7 @@ class AssistantUpdateParams(TypedDict, total=False):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     response_format: Optional[AssistantResponseFormatOptionParam]
diff --git a/src/openai/types/beta/threads/run_create_params.py b/src/openai/types/beta/threads/run_create_params.py
@@ -121,7 +121,7 @@ class RunCreateParamsBase(TypedDict, total=False):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     response_format: Optional[AssistantResponseFormatOptionParam]
diff --git a/src/openai/types/chat/completion_create_params.py b/src/openai/types/chat/completion_create_params.py
@@ -207,7 +207,7 @@ class CompletionCreateParamsBase(TypedDict, total=False):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     response_format: ResponseFormat
diff --git a/src/openai/types/evals/create_eval_completions_run_data_source.py b/src/openai/types/evals/create_eval_completions_run_data_source.py
@@ -196,7 +196,7 @@ class SamplingParams(BaseModel):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     response_format: Optional[SamplingParamsResponseFormat] = None
diff --git a/src/openai/types/evals/create_eval_completions_run_data_source_param.py b/src/openai/types/evals/create_eval_completions_run_data_source_param.py
@@ -192,7 +192,7 @@ class SamplingParams(TypedDict, total=False):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     response_format: SamplingParamsResponseFormat
diff --git a/src/openai/types/evals/run_cancel_response.py b/src/openai/types/evals/run_cancel_response.py
@@ -115,7 +115,7 @@ class DataSourceResponsesSourceResponses(BaseModel):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     temperature: Optional[float] = None
@@ -278,7 +278,7 @@ class DataSourceResponsesSamplingParams(BaseModel):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     seed: Optional[int] = None
diff --git a/src/openai/types/evals/run_create_params.py b/src/openai/types/evals/run_create_params.py
@@ -128,7 +128,7 @@ class DataSourceCreateEvalResponsesRunDataSourceSourceResponses(TypedDict, total
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     temperature: Optional[float]
@@ -296,7 +296,7 @@ class DataSourceCreateEvalResponsesRunDataSourceSamplingParams(TypedDict, total=
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     seed: int
diff --git a/src/openai/types/evals/run_create_response.py b/src/openai/types/evals/run_create_response.py
@@ -115,7 +115,7 @@ class DataSourceResponsesSourceResponses(BaseModel):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     temperature: Optional[float] = None
@@ -278,7 +278,7 @@ class DataSourceResponsesSamplingParams(BaseModel):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     seed: Optional[int] = None
diff --git a/src/openai/types/evals/run_list_response.py b/src/openai/types/evals/run_list_response.py
@@ -115,7 +115,7 @@ class DataSourceResponsesSourceResponses(BaseModel):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     temperature: Optional[float] = None
@@ -278,7 +278,7 @@ class DataSourceResponsesSamplingParams(BaseModel):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     seed: Optional[int] = None
diff --git a/src/openai/types/evals/run_retrieve_response.py b/src/openai/types/evals/run_retrieve_response.py
@@ -115,7 +115,7 @@ class DataSourceResponsesSourceResponses(BaseModel):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     temperature: Optional[float] = None
@@ -278,7 +278,7 @@ class DataSourceResponsesSamplingParams(BaseModel):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     seed: Optional[int] = None
diff --git a/src/openai/types/graders/score_model_grader.py b/src/openai/types/graders/score_model_grader.py
@@ -91,7 +91,7 @@ class SamplingParams(BaseModel):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     seed: Optional[int] = None
@@ -108,7 +108,11 @@ class ScoreModelGrader(BaseModel):
     """A ScoreModelGrader object that uses a model to assign a score to the input."""
 
     input: List[Input]
-    """The input text. This may include template strings."""
+    """The input messages evaluated by the grader.
+
+    Supports text, output text, input image, and input audio content blocks, and may
+    include template strings.
+    """
 
     model: str
     """The model to use for the evaluation."""
diff --git a/src/openai/types/graders/score_model_grader_param.py b/src/openai/types/graders/score_model_grader_param.py
@@ -97,7 +97,7 @@ class SamplingParams(TypedDict, total=False):
     - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       support `none`.
     - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     """
 
     seed: Optional[int]
@@ -114,7 +114,11 @@ class ScoreModelGraderParam(TypedDict, total=False):
     """A ScoreModelGrader object that uses a model to assign a score to the input."""
 
     input: Required[Iterable[Input]]
-    """The input text. This may include template strings."""
+    """The input messages evaluated by the grader.
+
+    Supports text, output text, input image, and input audio content blocks, and may
+    include template strings.
+    """
 
     model: Required[str]
     """The model to use for the evaluation."""
diff --git a/src/openai/types/responses/response_compact_params.py b/src/openai/types/responses/response_compact_params.py
@@ -14,6 +14,11 @@ class ResponseCompactParams(TypedDict, total=False):
     model: Required[
         Union[
             Literal[
+                "gpt-5.2",
+                "gpt-5.2-2025-12-11",
+                "gpt-5.2-chat-latest",
+                "gpt-5.2-pro",
+                "gpt-5.2-pro-2025-12-11",
                 "gpt-5.1",
                 "gpt-5.1-2025-11-13",
                 "gpt-5.1-codex",
diff --git a/src/openai/types/shared/chat_model.py b/src/openai/types/shared/chat_model.py
@@ -5,6 +5,11 @@
 __all__ = ["ChatModel"]
 
 ChatModel: TypeAlias = Literal[
+    "gpt-5.2",
+    "gpt-5.2-2025-12-11",
+    "gpt-5.2-chat-latest",
+    "gpt-5.2-pro",
+    "gpt-5.2-pro-2025-12-11",
     "gpt-5.1",
     "gpt-5.1-2025-11-13",
     "gpt-5.1-codex",
diff --git a/src/openai/types/shared/reasoning.py b/src/openai/types/shared/reasoning.py
diff --git a/src/openai/types/shared_params/chat_model.py b/src/openai/types/shared_params/chat_model.py
diff --git a/src/openai/types/shared_params/reasoning.py b/src/openai/types/shared_params/reasoning.py
diff --git a/tests/api_resources/test_responses.py b/tests/api_resources/test_responses.py
