feat(api): gpt 5.2

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 136
-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

README.md

@@ -82,7 +82,7 @@ OpenAIClient client = OpenAIOkHttpClient.fromEnv();
 
 ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
     .addUserMessage("Say this is a test")
-    .model(ChatModel.GPT_5_1)
+    .model(ChatModel.GPT_5_2)
     .build();
 ChatCompletion chatCompletion = client.chat().completions().create(params);
 ```
@@ -188,7 +188,7 @@ OpenAIClient client = OpenAIOkHttpClient.fromEnv();
 
 ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
     .addUserMessage("Say this is a test")
-    .model(ChatModel.GPT_5_1)
+    .model(ChatModel.GPT_5_2)
     .build();
 CompletableFuture<ChatCompletion> chatCompletion = client.async().chat().completions().create(params);
 ```
@@ -209,7 +209,7 @@ OpenAIClientAsync client = OpenAIOkHttpClientAsync.fromEnv();
 
 ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
     .addUserMessage("Say this is a test")
-    .model(ChatModel.GPT_5_1)
+    .model(ChatModel.GPT_5_2)
     .build();
 CompletableFuture<ChatCompletion> chatCompletion = client.chat().completions().create(params);
 ```
@@ -1143,7 +1143,7 @@ import com.openai.models.chat.completions.ChatCompletionCreateParams;
 
 ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
     .addUserMessage("Say this is a test")
-    .model(ChatModel.GPT_5_1)
+    .model(ChatModel.GPT_5_2)
     .build();
 HttpResponseFor<ChatCompletion> chatCompletion = client.chat().completions().withRawResponse().create(params);
 
@@ -1616,7 +1616,7 @@ import com.openai.models.chat.completions.ChatCompletionCreateParams;
 
 ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
     .messages(JsonValue.from(42))
-    .model(ChatModel.GPT_5_1)
+    .model(ChatModel.GPT_5_2)
     .build();
 ```
 
@@ -1669,7 +1669,7 @@ import com.openai.models.ChatModel;
 import com.openai.models.chat.completions.ChatCompletionCreateParams;
 
 ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
-    .model(ChatModel.GPT_5_1)
+    .model(ChatModel.GPT_5_2)
     .messages(JsonMissing.of())
     .build();
 ```

openai-java-core/src/main/kotlin/com/openai/models/ChatModel.kt

@@ -20,6 +20,16 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
 
     companion object {
 
+        @JvmField val GPT_5_2 = of("gpt-5.2")
+
+        @JvmField val GPT_5_2_2025_12_11 = of("gpt-5.2-2025-12-11")
+
+        @JvmField val GPT_5_2_CHAT_LATEST = of("gpt-5.2-chat-latest")
+
+        @JvmField val GPT_5_2_PRO = of("gpt-5.2-pro")
+
+        @JvmField val GPT_5_2_PRO_2025_12_11 = of("gpt-5.2-pro-2025-12-11")
+
         @JvmField val GPT_5_1 = of("gpt-5.1")
 
         @JvmField val GPT_5_1_2025_11_13 = of("gpt-5.1-2025-11-13")
@@ -161,6 +171,11 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
 
     /** An enum containing [ChatModel]'s known values. */
     enum class Known {
+        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,
@@ -240,6 +255,11 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
      * - It was constructed with an arbitrary value using the [of] method.
      */
     enum class Value {
+        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,
@@ -320,6 +340,11 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
      */
     fun value(): Value =
         when (this) {
+            GPT_5_2 -> Value.GPT_5_2
+            GPT_5_2_2025_12_11 -> Value.GPT_5_2_2025_12_11
+            GPT_5_2_CHAT_LATEST -> Value.GPT_5_2_CHAT_LATEST
+            GPT_5_2_PRO -> Value.GPT_5_2_PRO
+            GPT_5_2_PRO_2025_12_11 -> Value.GPT_5_2_PRO_2025_12_11
             GPT_5_1 -> Value.GPT_5_1
             GPT_5_1_2025_11_13 -> Value.GPT_5_1_2025_11_13
             GPT_5_1_CODEX -> Value.GPT_5_1_CODEX
@@ -400,6 +425,11 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
      */
     fun known(): Known =
         when (this) {
+            GPT_5_2 -> Known.GPT_5_2
+            GPT_5_2_2025_12_11 -> Known.GPT_5_2_2025_12_11
+            GPT_5_2_CHAT_LATEST -> Known.GPT_5_2_CHAT_LATEST
+            GPT_5_2_PRO -> Known.GPT_5_2_PRO
+            GPT_5_2_PRO_2025_12_11 -> Known.GPT_5_2_PRO_2025_12_11
             GPT_5_1 -> Known.GPT_5_1
             GPT_5_1_2025_11_13 -> Known.GPT_5_1_2025_11_13
             GPT_5_1_CODEX -> Known.GPT_5_1_CODEX

openai-java-core/src/main/kotlin/com/openai/models/Reasoning.kt

@@ -53,7 +53,7 @@ private constructor(
      * - 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`.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -77,7 +77,8 @@ private constructor(
      * A summary of the reasoning performed by the model. This can be useful for debugging and
      * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
      *
-     * `concise` is only supported for `computer-use-preview` models.
+     * `concise` is supported for `computer-use-preview` models and all reasoning models after
+     * `gpt-5`.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -154,7 +155,7 @@ private constructor(
          * - 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`.
          */
         fun effort(effort: ReasoningEffort?) = effort(JsonField.ofNullable(effort))
 
@@ -201,7 +202,8 @@ private constructor(
          * A summary of the reasoning performed by the model. This can be useful for debugging and
          * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
          *
-         * `concise` is only supported for `computer-use-preview` models.
+         * `concise` is supported for `computer-use-preview` models and all reasoning models after
+         * `gpt-5`.
          */
         fun summary(summary: Summary?) = summary(JsonField.ofNullable(summary))
 
@@ -422,7 +424,8 @@ private constructor(
      * A summary of the reasoning performed by the model. This can be useful for debugging and
      * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
      *
-     * `concise` is only supported for `computer-use-preview` models.
+     * `concise` is supported for `computer-use-preview` models and all reasoning models after
+     * `gpt-5`.
      */
     class Summary @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 

openai-java-core/src/main/kotlin/com/openai/models/ReasoningEffort.kt

@@ -17,7 +17,7 @@ import com.openai.errors.OpenAIInvalidDataException
  *   reasoning values in gpt-5.1.
  * - 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`.
  */
 class ReasoningEffort @JsonCreator private constructor(private val value: JsonField<String>) :
     Enum {

openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantCreateParams.kt

@@ -106,7 +106,7 @@ private constructor(
      * - 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`.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -413,7 +413,7 @@ private constructor(
          * - 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`.
          */
         fun reasoningEffort(reasoningEffort: ReasoningEffort?) = apply {
             body.reasoningEffort(reasoningEffort)
@@ -883,7 +883,7 @@ private constructor(
          * - 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`.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -1222,7 +1222,7 @@ private constructor(
              * - 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`.
              */
             fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                 reasoningEffort(JsonField.ofNullable(reasoningEffort))

openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantUpdateParams.kt

@@ -98,7 +98,7 @@ private constructor(
      * - 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`.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -407,7 +407,7 @@ private constructor(
          * - 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`.
          */
         fun reasoningEffort(reasoningEffort: ReasoningEffort?) = apply {
             body.reasoningEffort(reasoningEffort)
@@ -877,7 +877,7 @@ private constructor(
          * - 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`.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -1209,7 +1209,7 @@ private constructor(
              * - 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`.
              */
             fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                 reasoningEffort(JsonField.ofNullable(reasoningEffort))

openai-java-core/src/main/kotlin/com/openai/models/beta/threads/runs/RunCreateParams.kt

@@ -175,7 +175,7 @@ private constructor(
      * - 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`.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -702,7 +702,7 @@ private constructor(
          * - 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`.
          */
         fun reasoningEffort(reasoningEffort: ReasoningEffort?) = apply {
             body.reasoningEffort(reasoningEffort)
@@ -1302,7 +1302,7 @@ private constructor(
          * - 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`.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -1852,7 +1852,7 @@ private constructor(
              * - 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`.
              */
             fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                 reasoningEffort(JsonField.ofNullable(reasoningEffort))

openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParams.kt

@@ -286,7 +286,7 @@ private constructor(
      * - 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`.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -1407,7 +1407,7 @@ private constructor(
          * - 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`.
          */
         fun reasoningEffort(reasoningEffort: ReasoningEffort?) = apply {
             body.reasoningEffort(reasoningEffort)
@@ -2446,7 +2446,7 @@ private constructor(
          * - 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`.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -3743,7 +3743,7 @@ private constructor(
              * - 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`.
              */
             fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                 reasoningEffort(JsonField.ofNullable(reasoningEffort))

openai-java-core/src/main/kotlin/com/openai/models/evals/EvalCreateParams.kt

@@ -5478,7 +5478,8 @@ private constructor(
                     .build()
 
             /**
-             * 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.
              *
              * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
              *   unexpectedly missing or null (e.g. if the server responded with an unexpected
@@ -5644,7 +5645,10 @@ private constructor(
                     additionalProperties = scoreModel.additionalProperties.toMutableMap()
                 }
 
-                /** 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.
+                 */
                 fun input(input: List<ScoreModelGrader.Input>) = input(JsonField.of(input))
 
                 /**