feat(api): gpt 5.1

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 135
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-eeba8addf3a5f412e5ce8d22031e60c61650cee3f5d9e587a2533f6818a249ea.yml
-openapi_spec_hash: 0a4d8ad2469823ce24a3fd94f23f1c2b
-config_hash: 630eea84bb3067d25640419af058ed56
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-ca24bc4d8125b5153514ce643c4e3220f25971b7d67ca384d56d493c72c0d977.yml
+openapi_spec_hash: c6f048c7b3d29f4de48fde0e845ba33f
+config_hash: b876221dfb213df9f0a999e75d38a65e

README.md

@@ -82,7 +82,7 @@ OpenAIClient client = OpenAIOkHttpClient.fromEnv();
 
 ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
     .addUserMessage("Say this is a test")
-    .model(ChatModel.GPT_5)
+    .model(ChatModel.GPT_5_1)
     .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)
+    .model(ChatModel.GPT_5_1)
     .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)
+    .model(ChatModel.GPT_5_1)
     .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)
+    .model(ChatModel.GPT_5_1)
     .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)
+    .model(ChatModel.GPT_5_1)
     .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)
+    .model(ChatModel.GPT_5_1)
     .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_1 = of("gpt-5.1")
+
+        @JvmField val GPT_5_1_2025_11_13 = of("gpt-5.1-2025-11-13")
+
+        @JvmField val GPT_5_1_CODEX = of("gpt-5.1-codex")
+
+        @JvmField val GPT_5_1_MINI = of("gpt-5.1-mini")
+
+        @JvmField val GPT_5_1_CHAT_LATEST = of("gpt-5.1-chat-latest")
+
         @JvmField val GPT_5 = of("gpt-5")
 
         @JvmField val GPT_5_MINI = of("gpt-5-mini")
@@ -151,6 +161,11 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
 
     /** An enum containing [ChatModel]'s known values. */
     enum class Known {
+        GPT_5_1,
+        GPT_5_1_2025_11_13,
+        GPT_5_1_CODEX,
+        GPT_5_1_MINI,
+        GPT_5_1_CHAT_LATEST,
         GPT_5,
         GPT_5_MINI,
         GPT_5_NANO,
@@ -225,6 +240,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_1,
+        GPT_5_1_2025_11_13,
+        GPT_5_1_CODEX,
+        GPT_5_1_MINI,
+        GPT_5_1_CHAT_LATEST,
         GPT_5,
         GPT_5_MINI,
         GPT_5_NANO,
@@ -300,6 +320,11 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
      */
     fun value(): Value =
         when (this) {
+            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
+            GPT_5_1_MINI -> Value.GPT_5_1_MINI
+            GPT_5_1_CHAT_LATEST -> Value.GPT_5_1_CHAT_LATEST
             GPT_5 -> Value.GPT_5
             GPT_5_MINI -> Value.GPT_5_MINI
             GPT_5_NANO -> Value.GPT_5_NANO
@@ -375,6 +400,11 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
      */
     fun known(): Known =
         when (this) {
+            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
+            GPT_5_1_MINI -> Known.GPT_5_1_MINI
+            GPT_5_1_CHAT_LATEST -> Known.GPT_5_1_CHAT_LATEST
             GPT_5 -> Known.GPT_5
             GPT_5_MINI -> Known.GPT_5_MINI
             GPT_5_NANO -> Known.GPT_5_NANO

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

@@ -45,10 +45,14 @@ private constructor(
     /**
      * Constrains effort on reasoning for
      * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported
-     * values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning effort can result in
-     * faster responses and fewer tokens used on reasoning in a response.
-     *
-     * Note: The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+     * values are `none`, `minimal`, `low`, `medium`, and `high`. Reducing reasoning effort can
+     * result in faster responses and fewer tokens used on reasoning in a response.
+     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
+     *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for
+     *   all 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.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -140,10 +144,14 @@ private constructor(
         /**
          * Constrains effort on reasoning for
          * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning effort
-         * can result in faster responses and fewer tokens used on reasoning in a response.
-         *
-         * Note: The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+         * supported values are `none`, `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+         * effort can result in faster responses and fewer tokens used on reasoning in a response.
+         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
+         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
+         *   for all 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.
          */
         fun effort(effort: ReasoningEffort?) = effort(JsonField.ofNullable(effort))
 

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

@@ -10,10 +10,13 @@ import com.openai.errors.OpenAIInvalidDataException
 /**
  * Constrains effort on reasoning for
  * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values
- * are `minimal`, `low`, `medium`, and `high`. Reducing reasoning effort can result in faster
- * responses and fewer tokens used on reasoning in a response.
- *
- * Note: The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+ * are `none`, `minimal`, `low`, `medium`, and `high`. Reducing reasoning effort can result in
+ * faster responses and fewer tokens used on reasoning in a response.
+ * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values
+ *   for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all
+ *   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.
  */
 class ReasoningEffort @JsonCreator private constructor(private val value: JsonField<String>) :
     Enum {
@@ -29,6 +32,8 @@ class ReasoningEffort @JsonCreator private constructor(private val value: JsonFi
 
     companion object {
 
+        @JvmField val NONE = of("none")
+
         @JvmField val MINIMAL = of("minimal")
 
         @JvmField val LOW = of("low")
@@ -42,6 +47,7 @@ class ReasoningEffort @JsonCreator private constructor(private val value: JsonFi
 
     /** An enum containing [ReasoningEffort]'s known values. */
     enum class Known {
+        NONE,
         MINIMAL,
         LOW,
         MEDIUM,
@@ -58,6 +64,7 @@ class ReasoningEffort @JsonCreator private constructor(private val value: JsonFi
      * - It was constructed with an arbitrary value using the [of] method.
      */
     enum class Value {
+        NONE,
         MINIMAL,
         LOW,
         MEDIUM,
@@ -77,6 +84,7 @@ class ReasoningEffort @JsonCreator private constructor(private val value: JsonFi
      */
     fun value(): Value =
         when (this) {
+            NONE -> Value.NONE
             MINIMAL -> Value.MINIMAL
             LOW -> Value.LOW
             MEDIUM -> Value.MEDIUM
@@ -94,6 +102,7 @@ class ReasoningEffort @JsonCreator private constructor(private val value: JsonFi
      */
     fun known(): Known =
         when (this) {
+            NONE -> Known.NONE
             MINIMAL -> Known.MINIMAL
             LOW -> Known.LOW
             MEDIUM -> Known.MEDIUM

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

@@ -40,9 +40,9 @@ private constructor(
 
     /**
      * The endpoint to be used for all requests in the batch. Currently `/v1/responses`,
-     * `/v1/chat/completions`, `/v1/embeddings`, and `/v1/completions` are supported. Note that
-     * `/v1/embeddings` batches are also restricted to a maximum of 50,000 embedding inputs across
-     * all requests in the batch.
+     * `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`, and `/v1/moderations` are
+     * supported. Note that `/v1/embeddings` batches are also restricted to a maximum of 50,000
+     * embedding inputs across all requests in the batch.
      *
      * @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 value).
@@ -197,9 +197,9 @@ private constructor(
 
         /**
          * The endpoint to be used for all requests in the batch. Currently `/v1/responses`,
-         * `/v1/chat/completions`, `/v1/embeddings`, and `/v1/completions` are supported. Note that
-         * `/v1/embeddings` batches are also restricted to a maximum of 50,000 embedding inputs
-         * across all requests in the batch.
+         * `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`, and `/v1/moderations` are
+         * supported. Note that `/v1/embeddings` batches are also restricted to a maximum of 50,000
+         * embedding inputs across all requests in the batch.
          */
         fun endpoint(endpoint: Endpoint) = apply { body.endpoint(endpoint) }
 
@@ -467,9 +467,9 @@ private constructor(
 
         /**
          * The endpoint to be used for all requests in the batch. Currently `/v1/responses`,
-         * `/v1/chat/completions`, `/v1/embeddings`, and `/v1/completions` are supported. Note that
-         * `/v1/embeddings` batches are also restricted to a maximum of 50,000 embedding inputs
-         * across all requests in the batch.
+         * `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`, and `/v1/moderations` are
+         * supported. Note that `/v1/embeddings` batches are also restricted to a maximum of 50,000
+         * embedding inputs across all requests in the batch.
          *
          * @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 value).
@@ -624,9 +624,9 @@ private constructor(
 
             /**
              * The endpoint to be used for all requests in the batch. Currently `/v1/responses`,
-             * `/v1/chat/completions`, `/v1/embeddings`, and `/v1/completions` are supported. Note
-             * that `/v1/embeddings` batches are also restricted to a maximum of 50,000 embedding
-             * inputs across all requests in the batch.
+             * `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`, and `/v1/moderations`
+             * are supported. Note that `/v1/embeddings` batches are also restricted to a maximum of
+             * 50,000 embedding inputs across all requests in the batch.
              */
             fun endpoint(endpoint: Endpoint) = endpoint(JsonField.of(endpoint))
 
@@ -943,9 +943,9 @@ private constructor(
 
     /**
      * The endpoint to be used for all requests in the batch. Currently `/v1/responses`,
-     * `/v1/chat/completions`, `/v1/embeddings`, and `/v1/completions` are supported. Note that
-     * `/v1/embeddings` batches are also restricted to a maximum of 50,000 embedding inputs across
-     * all requests in the batch.
+     * `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`, and `/v1/moderations` are
+     * supported. Note that `/v1/embeddings` batches are also restricted to a maximum of 50,000
+     * embedding inputs across all requests in the batch.
      */
     class Endpoint @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
@@ -969,6 +969,8 @@ private constructor(
 
             @JvmField val V1_COMPLETIONS = of("/v1/completions")
 
+            @JvmField val V1_MODERATIONS = of("/v1/moderations")
+
             @JvmStatic fun of(value: String) = Endpoint(JsonField.of(value))
         }
 
@@ -978,6 +980,7 @@ private constructor(
             V1_CHAT_COMPLETIONS,
             V1_EMBEDDINGS,
             V1_COMPLETIONS,
+            V1_MODERATIONS,
         }
 
         /**
@@ -994,6 +997,7 @@ private constructor(
             V1_CHAT_COMPLETIONS,
             V1_EMBEDDINGS,
             V1_COMPLETIONS,
+            V1_MODERATIONS,
             /** An enum member indicating that [Endpoint] was instantiated with an unknown value. */
             _UNKNOWN,
         }
@@ -1011,6 +1015,7 @@ private constructor(
                 V1_CHAT_COMPLETIONS -> Value.V1_CHAT_COMPLETIONS
                 V1_EMBEDDINGS -> Value.V1_EMBEDDINGS
                 V1_COMPLETIONS -> Value.V1_COMPLETIONS
+                V1_MODERATIONS -> Value.V1_MODERATIONS
                 else -> Value._UNKNOWN
             }
 
@@ -1029,6 +1034,7 @@ private constructor(
                 V1_CHAT_COMPLETIONS -> Known.V1_CHAT_COMPLETIONS
                 V1_EMBEDDINGS -> Known.V1_EMBEDDINGS
                 V1_COMPLETIONS -> Known.V1_COMPLETIONS
+                V1_MODERATIONS -> Known.V1_MODERATIONS
                 else -> throw OpenAIInvalidDataException("Unknown Endpoint: $value")
             }