Merge pull request #257 from openai/release-please--branches--main--changes--next

apcha-oai · web-flow · commit 0956d164d4b4 · 2026-03-17T22:01:22.000-04:00
release: 0.56.0
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -1,12 +1,14 @@
 name: CI
 on:
   push:
-    branches-ignore:
-      - 'generated'
-      - 'codegen/**'
-      - 'integrated/**'
-      - 'stl-preview-head/**'
-      - 'stl-preview-base/**'
+    branches:
+      - '**'
+      - '!integrated/**'
+      - '!stl-preview-head/**'
+      - '!stl-preview-base/**'
+      - '!generated'
+      - '!codegen/**'
+      - 'codegen/stl/**'
   pull_request:
     branches-ignore:
       - 'stl-preview-head/**'
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.55.0"
+  ".": "0.56.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 151
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-cb3e4451108eed58d59cff25bf77ec0dc960ec9c6f3dba68f90e7a9847c09d21.yml
-openapi_spec_hash: dec6d9be64a5ba8f474a1f2a7a4fafef
-config_hash: e922f01e25accd07d8fd3641c37fbd62
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-55ef7034334e938c30656a404ce5e21466103be87542a796425346299f450404.yml
+openapi_spec_hash: 4a5bfd2ee4ad47f5b7cf6f1ad08d5d7f
+config_hash: 96fbf82cf74a44ccd513f5acf0956ffd
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.56.0 (2026-03-17)
+
+Full Changelog: [v0.55.0...v0.56.0](https://github.com/openai/openai-ruby/compare/v0.55.0...v0.56.0)
+
+### Features
+
+* **api:** 5.4 nano and mini model slugs ([ce7f09d](https://github.com/openai/openai-ruby/commit/ce7f09dcafdb1a8259ce14d0e7c012b872469a32))
+* **api:** add /v1/videos endpoint support to batch create params ([7a661eb](https://github.com/openai/openai-ruby/commit/7a661eb405c72bb2696e0acd327ecd56d7ed6c54))
+* **api:** add defer_loading field to namespace_tool function ([2f3b9b7](https://github.com/openai/openai-ruby/commit/2f3b9b7a2fa7b63ed20d362a993d98d8cec72fc1))
+* **api:** add in/nin operators to ComparisonFilter ([70c8bf5](https://github.com/openai/openai-ruby/commit/70c8bf55c4d0e2054e23972479edb09c0d8f3d8e))
+
+
+### Chores
+
+* **internal:** tweak CI branches ([1a5054f](https://github.com/openai/openai-ruby/commit/1a5054f561a63a4b19c0d2a035e1c45dcfbc21fc))
+
 ## 0.55.0 (2026-03-13)
 
 Full Changelog: [v0.54.0...v0.55.0](https://github.com/openai/openai-ruby/compare/v0.54.0...v0.55.0)
diff --git a/Gemfile.lock b/Gemfile.lock
@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    openai (0.55.0)
+    openai (0.56.0)
       base64
       cgi
       connection_pool
diff --git a/README.md b/README.md
@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.55.0"
+gem "openai", "~> 0.56.0"
 ```
 
 <!-- x-release-please-end -->
diff --git a/lib/openai/internal/type/enum.rb b/lib/openai/internal/type/enum.rb
@@ -21,9 +21,9 @@ module Type
       #   case chat_model
       #   when OpenAI::ChatModel::GPT_5_4
       #     # ...
-      #   when OpenAI::ChatModel::GPT_5_3_CHAT_LATEST
+      #   when OpenAI::ChatModel::GPT_5_4_MINI
       #     # ...
-      #   when OpenAI::ChatModel::GPT_5_2
+      #   when OpenAI::ChatModel::GPT_5_4_NANO
       #     # ...
       #   else
       #     puts(chat_model)
@@ -33,9 +33,9 @@ module Type
       #   case chat_model
       #   in :"gpt-5.4"
       #     # ...
-      #   in :"gpt-5.3-chat-latest"
+      #   in :"gpt-5.4-mini"
       #     # ...
-      #   in :"gpt-5.2"
+      #   in :"gpt-5.4-nano"
       #     # ...
       #   else
       #     puts(chat_model)
diff --git a/lib/openai/models/batch_create_params.rb b/lib/openai/models/batch_create_params.rb
@@ -17,9 +17,10 @@ class BatchCreateParams < OpenAI::Internal::Type::BaseModel
       # @!attribute endpoint
       #   The endpoint to be used for all requests in the batch. Currently
       #   `/v1/responses`, `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`,
-      #   `/v1/moderations`, `/v1/images/generations`, and `/v1/images/edits` 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/moderations`, `/v1/images/generations`, `/v1/images/edits`, and
+      #   `/v1/videos` are supported. Note that `/v1/embeddings` batches are also
+      #   restricted to a maximum of 50,000 embedding inputs across all requests in the
+      #   batch.
       #
       #   @return [Symbol, OpenAI::Models::BatchCreateParams::Endpoint]
       required :endpoint, enum: -> { OpenAI::BatchCreateParams::Endpoint }
@@ -85,9 +86,10 @@ module CompletionWindow
 
       # The endpoint to be used for all requests in the batch. Currently
       # `/v1/responses`, `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`,
-      # `/v1/moderations`, `/v1/images/generations`, and `/v1/images/edits` 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/moderations`, `/v1/images/generations`, `/v1/images/edits`, and
+      # `/v1/videos` are supported. Note that `/v1/embeddings` batches are also
+      # restricted to a maximum of 50,000 embedding inputs across all requests in the
+      # batch.
       module Endpoint
         extend OpenAI::Internal::Type::Enum
 
@@ -98,6 +100,7 @@ module Endpoint
         V1_MODERATIONS = :"/v1/moderations"
         V1_IMAGES_GENERATIONS = :"/v1/images/generations"
         V1_IMAGES_EDITS = :"/v1/images/edits"
+        V1_VIDEOS = :"/v1/videos"
 
         # @!method self.values
         #   @return [Array<Symbol>]
diff --git a/lib/openai/models/chat_model.rb b/lib/openai/models/chat_model.rb
@@ -6,6 +6,10 @@ module ChatModel
       extend OpenAI::Internal::Type::Enum
 
       GPT_5_4 = :"gpt-5.4"
+      GPT_5_4_MINI = :"gpt-5.4-mini"
+      GPT_5_4_NANO = :"gpt-5.4-nano"
+      GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+      GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
       GPT_5_3_CHAT_LATEST = :"gpt-5.3-chat-latest"
       GPT_5_2 = :"gpt-5.2"
       GPT_5_2_2025_12_11 = :"gpt-5.2-2025-12-11"
diff --git a/lib/openai/models/comparison_filter.rb b/lib/openai/models/comparison_filter.rb
@@ -67,6 +67,8 @@ module Type
         GTE = :gte
         LT = :lt
         LTE = :lte
+        IN = :in
+        NIN = :nin
 
         # @!method self.values
         #   @return [Array<Symbol>]
diff --git a/lib/openai/models/responses/namespace_tool.rb b/lib/openai/models/responses/namespace_tool.rb
@@ -61,6 +61,12 @@ class Function < OpenAI::Internal::Type::BaseModel
             #   @return [Symbol, :function]
             required :type, const: :function
 
+            # @!attribute defer_loading
+            #   Whether this function should be deferred and discovered via tool search.
+            #
+            #   @return [Boolean, nil]
+            optional :defer_loading, OpenAI::Internal::Type::Boolean
+
             # @!attribute description
             #
             #   @return [String, nil]
@@ -76,11 +82,17 @@ class Function < OpenAI::Internal::Type::BaseModel
             #   @return [Boolean, nil]
             optional :strict, OpenAI::Internal::Type::Boolean, nil?: true
 
-            # @!method initialize(name:, description: nil, parameters: nil, strict: nil, type: :function)
+            # @!method initialize(name:, defer_loading: nil, description: nil, parameters: nil, strict: nil, type: :function)
             #   @param name [String]
+            #
+            #   @param defer_loading [Boolean] Whether this function should be deferred and discovered via tool search.
+            #
             #   @param description [String, nil]
+            #
             #   @param parameters [Object, nil]
+            #
             #   @param strict [Boolean, nil]
+            #
             #   @param type [Symbol, :function]
           end
 
diff --git a/lib/openai/models/responses/response_compact_params.rb b/lib/openai/models/responses/response_compact_params.rb
@@ -74,6 +74,14 @@ module Model
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_4 }
 
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_4_MINI }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_4_NANO }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_4_MINI_2026_03_17 }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_4_NANO_2026_03_17 }
+
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_3_CHAT_LATEST }
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_2 }
@@ -260,6 +268,10 @@ module Model
           # @!group
 
           GPT_5_4 = :"gpt-5.4"
+          GPT_5_4_MINI = :"gpt-5.4-mini"
+          GPT_5_4_NANO = :"gpt-5.4-nano"
+          GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+          GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
           GPT_5_3_CHAT_LATEST = :"gpt-5.3-chat-latest"
           GPT_5_2 = :"gpt-5.2"
           GPT_5_2_2025_12_11 = :"gpt-5.2-2025-12-11"
diff --git a/lib/openai/version.rb b/lib/openai/version.rb
@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.55.0"
+  VERSION = "0.56.0"
 end
diff --git a/rbi/openai/models/batch_create_params.rbi b/rbi/openai/models/batch_create_params.rbi
@@ -18,9 +18,10 @@ module OpenAI
 
       # The endpoint to be used for all requests in the batch. Currently
       # `/v1/responses`, `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`,
-      # `/v1/moderations`, `/v1/images/generations`, and `/v1/images/edits` 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/moderations`, `/v1/images/generations`, `/v1/images/edits`, and
+      # `/v1/videos` are supported. Note that `/v1/embeddings` batches are also
+      # restricted to a maximum of 50,000 embedding inputs across all requests in the
+      # batch.
       sig { returns(OpenAI::BatchCreateParams::Endpoint::OrSymbol) }
       attr_accessor :endpoint
 
@@ -76,9 +77,10 @@ module OpenAI
         completion_window:,
         # The endpoint to be used for all requests in the batch. Currently
         # `/v1/responses`, `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`,
-        # `/v1/moderations`, `/v1/images/generations`, and `/v1/images/edits` 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/moderations`, `/v1/images/generations`, `/v1/images/edits`, and
+        # `/v1/videos` are supported. Note that `/v1/embeddings` batches are also
+        # restricted to a maximum of 50,000 embedding inputs across all requests in the
+        # batch.
         endpoint:,
         # The ID of an uploaded file that contains requests for the new batch.
         #
@@ -148,9 +150,10 @@ module OpenAI
 
       # The endpoint to be used for all requests in the batch. Currently
       # `/v1/responses`, `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`,
-      # `/v1/moderations`, `/v1/images/generations`, and `/v1/images/edits` 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/moderations`, `/v1/images/generations`, `/v1/images/edits`, and
+      # `/v1/videos` are supported. Note that `/v1/embeddings` batches are also
+      # restricted to a maximum of 50,000 embedding inputs across all requests in the
+      # batch.
       module Endpoint
         extend OpenAI::Internal::Type::Enum
 
@@ -193,6 +196,11 @@ module OpenAI
             :"/v1/images/edits",
             OpenAI::BatchCreateParams::Endpoint::TaggedSymbol
           )
+        V1_VIDEOS =
+          T.let(
+            :"/v1/videos",
+            OpenAI::BatchCreateParams::Endpoint::TaggedSymbol
+          )
 
         sig do
           override.returns(
diff --git a/rbi/openai/models/chat_model.rbi b/rbi/openai/models/chat_model.rbi
@@ -9,6 +9,12 @@ module OpenAI
       OrSymbol = T.type_alias { T.any(Symbol, String) }
 
       GPT_5_4 = T.let(:"gpt-5.4", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_4_MINI = T.let(:"gpt-5.4-mini", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_4_NANO = T.let(:"gpt-5.4-nano", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_4_MINI_2026_03_17 =
+        T.let(:"gpt-5.4-mini-2026-03-17", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_4_NANO_2026_03_17 =
+        T.let(:"gpt-5.4-nano-2026-03-17", OpenAI::ChatModel::TaggedSymbol)
       GPT_5_3_CHAT_LATEST =
         T.let(:"gpt-5.3-chat-latest", OpenAI::ChatModel::TaggedSymbol)
       GPT_5_2 = T.let(:"gpt-5.2", OpenAI::ChatModel::TaggedSymbol)
diff --git a/rbi/openai/models/comparison_filter.rbi b/rbi/openai/models/comparison_filter.rbi
@@ -97,6 +97,8 @@ module OpenAI
         GTE = T.let(:gte, OpenAI::ComparisonFilter::Type::TaggedSymbol)
         LT = T.let(:lt, OpenAI::ComparisonFilter::Type::TaggedSymbol)
         LTE = T.let(:lte, OpenAI::ComparisonFilter::Type::TaggedSymbol)
+        IN = T.let(:in, OpenAI::ComparisonFilter::Type::TaggedSymbol)
+        NIN = T.let(:nin, OpenAI::ComparisonFilter::Type::TaggedSymbol)
 
         sig do
           override.returns(
diff --git a/rbi/openai/models/responses/namespace_tool.rbi b/rbi/openai/models/responses/namespace_tool.rbi
@@ -107,6 +107,13 @@ module OpenAI
             sig { returns(Symbol) }
             attr_accessor :type
 
+            # Whether this function should be deferred and discovered via tool search.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_reader :defer_loading
+
+            sig { params(defer_loading: T::Boolean).void }
+            attr_writer :defer_loading
+
             sig { returns(T.nilable(String)) }
             attr_accessor :description
 
@@ -119,6 +126,7 @@ module OpenAI
             sig do
               params(
                 name: String,
+                defer_loading: T::Boolean,
                 description: T.nilable(String),
                 parameters: T.nilable(T.anything),
                 strict: T.nilable(T::Boolean),
@@ -127,6 +135,8 @@ module OpenAI
             end
             def self.new(
               name:,
+              # Whether this function should be deferred and discovered via tool search.
+              defer_loading: nil,
               description: nil,
               parameters: nil,
               strict: nil,
@@ -139,6 +149,7 @@ module OpenAI
                 {
                   name: String,
                   type: Symbol,
+                  defer_loading: T::Boolean,
                   description: T.nilable(String),
                   parameters: T.nilable(T.anything),
                   strict: T.nilable(T::Boolean)
diff --git a/rbi/openai/models/responses/response_compact_params.rbi b/rbi/openai/models/responses/response_compact_params.rbi
@@ -163,6 +163,26 @@ module OpenAI
               :"gpt-5.4",
               OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
             )
+          GPT_5_4_MINI =
+            T.let(
+              :"gpt-5.4-mini",
+              OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
+            )
+          GPT_5_4_NANO =
+            T.let(
+              :"gpt-5.4-nano",
+              OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
+            )
+          GPT_5_4_MINI_2026_03_17 =
+            T.let(
+              :"gpt-5.4-mini-2026-03-17",
+              OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
+            )
+          GPT_5_4_NANO_2026_03_17 =
+            T.let(
+              :"gpt-5.4-nano-2026-03-17",
+              OpenAI::Responses::ResponseCompactParams::Model::TaggedSymbol
+            )
           GPT_5_3_CHAT_LATEST =
             T.let(
               :"gpt-5.3-chat-latest",
diff --git a/rbi/openai/resources/batches.rbi b/rbi/openai/resources/batches.rbi
@@ -23,9 +23,10 @@ module OpenAI
         completion_window:,
         # The endpoint to be used for all requests in the batch. Currently
         # `/v1/responses`, `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`,
-        # `/v1/moderations`, `/v1/images/generations`, and `/v1/images/edits` 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/moderations`, `/v1/images/generations`, `/v1/images/edits`, and
+        # `/v1/videos` are supported. Note that `/v1/embeddings` batches are also
+        # restricted to a maximum of 50,000 embedding inputs across all requests in the
+        # batch.
         endpoint:,
         # The ID of an uploaded file that contains requests for the new batch.
         #
diff --git a/sig/openai/models/batch_create_params.rbs b/sig/openai/models/batch_create_params.rbs
@@ -64,6 +64,7 @@ module OpenAI
         | :"/v1/moderations"
         | :"/v1/images/generations"
         | :"/v1/images/edits"
+        | :"/v1/videos"
 
       module Endpoint
         extend OpenAI::Internal::Type::Enum
@@ -75,6 +76,7 @@ module OpenAI
         V1_MODERATIONS: :"/v1/moderations"
         V1_IMAGES_GENERATIONS: :"/v1/images/generations"
         V1_IMAGES_EDITS: :"/v1/images/edits"
+        V1_VIDEOS: :"/v1/videos"
 
         def self?.values: -> ::Array[OpenAI::Models::BatchCreateParams::endpoint]
       end
diff --git a/sig/openai/models/chat_model.rbs b/sig/openai/models/chat_model.rbs
diff --git a/sig/openai/models/comparison_filter.rbs b/sig/openai/models/comparison_filter.rbs
diff --git a/sig/openai/models/responses/namespace_tool.rbs b/sig/openai/models/responses/namespace_tool.rbs
diff --git a/sig/openai/models/responses/response_compact_params.rbs b/sig/openai/models/responses/response_compact_params.rbs

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "0.55.0"`
	`2`	`+ ".": "0.56.0"`
`3`	`3`	`}`