openai 0.49.1 → 0.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f34d18042a6ab2826128026a9c7fb5bd1a93abf9ee6c475a5d168560094677b
-  data.tar.gz: aa73e8a5f85adfd6b5b6436cfc02cb07d8dea6443a74cf8b755b4298991176b4
+  metadata.gz: f54d6873508436a7ccfd29e41959daf2d674ce2b8cc1acd7dfaad857047cd97f
+  data.tar.gz: e0831943ff8b7715276e4e37e97236c93d835926eb45abc53c9153d27d74ca2c
 SHA512:
-  metadata.gz: 8910aed1db556d26ba8372b674c799936dd12f30c4c00d7c2ca3bbd09fd2df5743e33fae034087d81cfa239ebfe2b0f12821e3884b019c8c6609179489daceeb
-  data.tar.gz: 8aeabebae2ca9742924adf7dc71037da21ad33b713c0e0c0773f9dcd58b46afa49de0c05fd4dfb636442aa73c357583225e2ee3539396437a0db4680066f6760
+  metadata.gz: 7473cc28a620f11a6f0b4af493cbf0c30e4db5b87fbcbe2317b03bba4346962637f47ed58c6ecda6e629cf0a980e3e2f6d960267ebf4213059275bf0f686832e
+  data.tar.gz: 28a38eb6efe67d18aa5eadf4ec8ffee010075683d17f739370adafe73c049b81f8bcf93f4b737b7627d1fa2c91f62c00798a23bb466d9ef4081fc3df3247d362

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.51.0 (2026-02-24)
+
+Full Changelog: [v0.50.0...v0.51.0](https://github.com/openai/openai-ruby/compare/v0.50.0...v0.51.0)
+
+### Features
+
+* **api:** add phase ([656f591](https://github.com/openai/openai-ruby/commit/656f5917f52cfbe388f9d706ab372b958301985e))
+
+
+### Bug Fixes
+
+* **api:** fix phase enum ([c055d7b](https://github.com/openai/openai-ruby/commit/c055d7b2fe06a49ad64db6dc880e30f41d42e22d))
+* **api:** phase docs ([766b70c](https://github.com/openai/openai-ruby/commit/766b70cc83834acf57f1d2c31ea5026ff0d70b7f))
+
+## 0.50.0 (2026-02-24)
+
+Full Changelog: [v0.49.1...v0.50.0](https://github.com/openai/openai-ruby/compare/v0.49.1...v0.50.0)
+
+### Features
+
+* **api:** add gpt-realtime-1.5 and gpt-audio-1.5 models to realtime session ([23a0d24](https://github.com/openai/openai-ruby/commit/23a0d24790e85e300735cdc7481ec907b85dff01))
+
 ## 0.49.1 (2026-02-23)
 
 Full Changelog: [v0.49.0...v0.49.1](https://github.com/openai/openai-ruby/compare/v0.49.0...v0.49.1)

data/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.49.1"
+gem "openai", "~> 0.51.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/models/realtime/realtime_session.rb

@@ -312,6 +312,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSession::Model::GPT_REALTIME }
 
+          variant const: -> { OpenAI::Models::Realtime::RealtimeSession::Model::GPT_REALTIME_1_5 }
+
           variant const: -> { OpenAI::Models::Realtime::RealtimeSession::Model::GPT_REALTIME_2025_08_28 }
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSession::Model::GPT_4O_REALTIME_PREVIEW }
@@ -332,6 +334,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSession::Model::GPT_REALTIME_MINI_2025_12_15 }
 
+          variant const: -> { OpenAI::Models::Realtime::RealtimeSession::Model::GPT_AUDIO_1_5 }
+
           variant const: -> { OpenAI::Models::Realtime::RealtimeSession::Model::GPT_AUDIO_MINI }
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSession::Model::GPT_AUDIO_MINI_2025_10_06 }
@@ -348,6 +352,7 @@ module OpenAI
           # @!group
 
           GPT_REALTIME = :"gpt-realtime"
+          GPT_REALTIME_1_5 = :"gpt-realtime-1.5"
           GPT_REALTIME_2025_08_28 = :"gpt-realtime-2025-08-28"
           GPT_4O_REALTIME_PREVIEW = :"gpt-4o-realtime-preview"
           GPT_4O_REALTIME_PREVIEW_2024_10_01 = :"gpt-4o-realtime-preview-2024-10-01"
@@ -358,6 +363,7 @@ module OpenAI
           GPT_REALTIME_MINI = :"gpt-realtime-mini"
           GPT_REALTIME_MINI_2025_10_06 = :"gpt-realtime-mini-2025-10-06"
           GPT_REALTIME_MINI_2025_12_15 = :"gpt-realtime-mini-2025-12-15"
+          GPT_AUDIO_1_5 = :"gpt-audio-1.5"
           GPT_AUDIO_MINI = :"gpt-audio-mini"
           GPT_AUDIO_MINI_2025_10_06 = :"gpt-audio-mini-2025-10-06"
           GPT_AUDIO_MINI_2025_12_15 = :"gpt-audio-mini-2025-12-15"

data/lib/openai/models/realtime/realtime_session_create_request.rb

@@ -185,6 +185,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model::GPT_REALTIME }
 
+          variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model::GPT_REALTIME_1_5 }
+
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model::GPT_REALTIME_2025_08_28 }
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model::GPT_4O_REALTIME_PREVIEW }
@@ -205,6 +207,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model::GPT_REALTIME_MINI_2025_12_15 }
 
+          variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model::GPT_AUDIO_1_5 }
+
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model::GPT_AUDIO_MINI }
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateRequest::Model::GPT_AUDIO_MINI_2025_10_06 }
@@ -221,6 +225,7 @@ module OpenAI
           # @!group
 
           GPT_REALTIME = :"gpt-realtime"
+          GPT_REALTIME_1_5 = :"gpt-realtime-1.5"
           GPT_REALTIME_2025_08_28 = :"gpt-realtime-2025-08-28"
           GPT_4O_REALTIME_PREVIEW = :"gpt-4o-realtime-preview"
           GPT_4O_REALTIME_PREVIEW_2024_10_01 = :"gpt-4o-realtime-preview-2024-10-01"
@@ -231,6 +236,7 @@ module OpenAI
           GPT_REALTIME_MINI = :"gpt-realtime-mini"
           GPT_REALTIME_MINI_2025_10_06 = :"gpt-realtime-mini-2025-10-06"
           GPT_REALTIME_MINI_2025_12_15 = :"gpt-realtime-mini-2025-12-15"
+          GPT_AUDIO_1_5 = :"gpt-audio-1.5"
           GPT_AUDIO_MINI = :"gpt-audio-mini"
           GPT_AUDIO_MINI_2025_10_06 = :"gpt-audio-mini-2025-10-06"
           GPT_AUDIO_MINI_2025_12_15 = :"gpt-audio-mini-2025-12-15"

data/lib/openai/models/realtime/realtime_session_create_response.rb

@@ -594,6 +594,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Model::GPT_REALTIME }
 
+          variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Model::GPT_REALTIME_1_5 }
+
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Model::GPT_REALTIME_2025_08_28 }
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Model::GPT_4O_REALTIME_PREVIEW }
@@ -614,6 +616,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Model::GPT_REALTIME_MINI_2025_12_15 }
 
+          variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Model::GPT_AUDIO_1_5 }
+
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Model::GPT_AUDIO_MINI }
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Model::GPT_AUDIO_MINI_2025_10_06 }
@@ -630,6 +634,7 @@ module OpenAI
           # @!group
 
           GPT_REALTIME = :"gpt-realtime"
+          GPT_REALTIME_1_5 = :"gpt-realtime-1.5"
           GPT_REALTIME_2025_08_28 = :"gpt-realtime-2025-08-28"
           GPT_4O_REALTIME_PREVIEW = :"gpt-4o-realtime-preview"
           GPT_4O_REALTIME_PREVIEW_2024_10_01 = :"gpt-4o-realtime-preview-2024-10-01"
@@ -640,6 +645,7 @@ module OpenAI
           GPT_REALTIME_MINI = :"gpt-realtime-mini"
           GPT_REALTIME_MINI_2025_10_06 = :"gpt-realtime-mini-2025-10-06"
           GPT_REALTIME_MINI_2025_12_15 = :"gpt-realtime-mini-2025-12-15"
+          GPT_AUDIO_1_5 = :"gpt-audio-1.5"
           GPT_AUDIO_MINI = :"gpt-audio-mini"
           GPT_AUDIO_MINI_2025_10_06 = :"gpt-audio-mini-2025-10-06"
           GPT_AUDIO_MINI_2025_12_15 = :"gpt-audio-mini-2025-12-15"

data/lib/openai/models/responses/easy_input_message.rb

@@ -18,13 +18,24 @@ module OpenAI
         #   @return [Symbol, OpenAI::Models::Responses::EasyInputMessage::Role]
         required :role, enum: -> { OpenAI::Responses::EasyInputMessage::Role }
 
+        # @!attribute phase
+        #   The phase of an assistant message.
+        #
+        #   Use `commentary` for an intermediate assistant message and `final_answer` for
+        #   the final assistant message. For follow-up requests with models like
+        #   `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
+        #   Omitting it can degrade performance. Not used for user messages.
+        #
+        #   @return [Symbol, OpenAI::Models::Responses::EasyInputMessage::Phase, nil]
+        optional :phase, enum: -> { OpenAI::Responses::EasyInputMessage::Phase }, nil?: true
+
         # @!attribute type
         #   The type of the message input. Always `message`.
         #
         #   @return [Symbol, OpenAI::Models::Responses::EasyInputMessage::Type, nil]
         optional :type, enum: -> { OpenAI::Responses::EasyInputMessage::Type }
 
-        # @!method initialize(content:, role:, type: nil)
+        # @!method initialize(content:, role:, phase: nil, type: nil)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::EasyInputMessage} for more details.
         #
@@ -38,6 +49,8 @@ module OpenAI
         #
         #   @param role [Symbol, OpenAI::Models::Responses::EasyInputMessage::Role] The role of the message input. One of `user`, `assistant`, `system`, or
         #
+        #   @param phase [Symbol, OpenAI::Models::Responses::EasyInputMessage::Phase, nil] The phase of an assistant message.
+        #
         #   @param type [Symbol, OpenAI::Models::Responses::EasyInputMessage::Type] The type of the message input. Always `message`.
 
         # Text, image, or audio input to the model, used to generate a response. Can also
@@ -74,6 +87,24 @@ module OpenAI
           #   @return [Array<Symbol>]
         end
 
+        # The phase of an assistant message.
+        #
+        # Use `commentary` for an intermediate assistant message and `final_answer` for
+        # the final assistant message. For follow-up requests with models like
+        # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
+        # Omitting it can degrade performance. Not used for user messages.
+        #
+        # @see OpenAI::Models::Responses::EasyInputMessage#phase
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          COMMENTARY = :commentary
+          FINAL_ANSWER = :final_answer
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # The type of the message input. Always `message`.
         #
         # @see OpenAI::Models::Responses::EasyInputMessage#type

data/lib/openai/models/responses/response_compact_params.rb

@@ -42,7 +42,13 @@ module OpenAI
         #   @return [String, nil]
         optional :previous_response_id, String, nil?: true
 
-        # @!method initialize(model:, input: nil, instructions: nil, previous_response_id: nil, request_options: {})
+        # @!attribute prompt_cache_key
+        #   A key to use when reading from or writing to the prompt cache.
+        #
+        #   @return [String, nil]
+        optional :prompt_cache_key, String, nil?: true
+
+        # @!method initialize(model:, input: nil, instructions: nil, previous_response_id: nil, prompt_cache_key: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseCompactParams} for more details.
         #
@@ -54,6 +60,8 @@ module OpenAI
         #
         #   @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to create multi-tu
         #
+        #   @param prompt_cache_key [String, nil] A key to use when reading from or writing to the prompt cache.
+        #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
         # Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a

data/lib/openai/models/responses/response_output_message.rb

@@ -36,7 +36,18 @@ module OpenAI
         #   @return [Symbol, :message]
         required :type, const: :message
 
-        # @!method initialize(id:, content:, status:, role: :assistant, type: :message)
+        # @!attribute phase
+        #   The phase of an assistant message.
+        #
+        #   Use `commentary` for an intermediate assistant message and `final_answer` for
+        #   the final assistant message. For follow-up requests with models like
+        #   `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
+        #   Omitting it can degrade performance. Not used for user messages.
+        #
+        #   @return [Symbol, OpenAI::Models::Responses::ResponseOutputMessage::Phase, nil]
+        optional :phase, enum: -> { OpenAI::Responses::ResponseOutputMessage::Phase }, nil?: true
+
+        # @!method initialize(id:, content:, status:, phase: nil, role: :assistant, type: :message)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseOutputMessage} for more details.
         #
@@ -48,6 +59,8 @@ module OpenAI
         #
         #   @param status [Symbol, OpenAI::Models::Responses::ResponseOutputMessage::Status] The status of the message input. One of `in_progress`, `completed`, or
         #
+        #   @param phase [Symbol, OpenAI::Models::Responses::ResponseOutputMessage::Phase, nil] The phase of an assistant message.
+        #
         #   @param role [Symbol, :assistant] The role of the output message. Always `assistant`.
         #
         #   @param type [Symbol, :message] The type of the output message. Always `message`.
@@ -82,6 +95,24 @@ module OpenAI
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # The phase of an assistant message.
+        #
+        # Use `commentary` for an intermediate assistant message and `final_answer` for
+        # the final assistant message. For follow-up requests with models like
+        # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
+        # Omitting it can degrade performance. Not used for user messages.
+        #
+        # @see OpenAI::Models::Responses::ResponseOutputMessage#phase
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          COMMENTARY = :commentary
+          FINAL_ANSWER = :final_answer
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

data/lib/openai/resources/responses.rb

@@ -473,7 +473,7 @@ module OpenAI
       # For ZDR-compatible compaction details, see
       # [Compaction (advanced)](https://platform.openai.com/docs/guides/conversation-state#compaction-advanced).
       #
-      # @overload compact(model:, input: nil, instructions: nil, previous_response_id: nil, request_options: {})
+      # @overload compact(model:, input: nil, instructions: nil, previous_response_id: nil, prompt_cache_key: nil, request_options: {})
       #
       # @param model [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil] Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a wi
       #
@@ -483,6 +483,8 @@ module OpenAI
       #
       # @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to create multi-tu
       #
+      # @param prompt_cache_key [String, nil] A key to use when reading from or writing to the prompt cache.
+      #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [OpenAI::Models::Responses::CompactedResponse]

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.49.1"
+  VERSION = "0.51.0"
 end

data/rbi/openai/models/realtime/realtime_session.rbi

@@ -700,6 +700,11 @@ module OpenAI
               :"gpt-realtime",
               OpenAI::Realtime::RealtimeSession::Model::TaggedSymbol
             )
+          GPT_REALTIME_1_5 =
+            T.let(
+              :"gpt-realtime-1.5",
+              OpenAI::Realtime::RealtimeSession::Model::TaggedSymbol
+            )
           GPT_REALTIME_2025_08_28 =
             T.let(
               :"gpt-realtime-2025-08-28",
@@ -750,6 +755,11 @@ module OpenAI
               :"gpt-realtime-mini-2025-12-15",
               OpenAI::Realtime::RealtimeSession::Model::TaggedSymbol
             )
+          GPT_AUDIO_1_5 =
+            T.let(
+              :"gpt-audio-1.5",
+              OpenAI::Realtime::RealtimeSession::Model::TaggedSymbol
+            )
           GPT_AUDIO_MINI =
             T.let(
               :"gpt-audio-mini",

data/rbi/openai/models/realtime/realtime_session_create_request.rbi

@@ -505,6 +505,11 @@ module OpenAI
               :"gpt-realtime",
               OpenAI::Realtime::RealtimeSessionCreateRequest::Model::TaggedSymbol
             )
+          GPT_REALTIME_1_5 =
+            T.let(
+              :"gpt-realtime-1.5",
+              OpenAI::Realtime::RealtimeSessionCreateRequest::Model::TaggedSymbol
+            )
           GPT_REALTIME_2025_08_28 =
             T.let(
               :"gpt-realtime-2025-08-28",
@@ -555,6 +560,11 @@ module OpenAI
               :"gpt-realtime-mini-2025-12-15",
               OpenAI::Realtime::RealtimeSessionCreateRequest::Model::TaggedSymbol
             )
+          GPT_AUDIO_1_5 =
+            T.let(
+              :"gpt-audio-1.5",
+              OpenAI::Realtime::RealtimeSessionCreateRequest::Model::TaggedSymbol
+            )
           GPT_AUDIO_MINI =
             T.let(
               :"gpt-audio-mini",

data/rbi/openai/models/realtime/realtime_session_create_response.rbi

@@ -1321,6 +1321,11 @@ module OpenAI
               :"gpt-realtime",
               OpenAI::Realtime::RealtimeSessionCreateResponse::Model::TaggedSymbol
             )
+          GPT_REALTIME_1_5 =
+            T.let(
+              :"gpt-realtime-1.5",
+              OpenAI::Realtime::RealtimeSessionCreateResponse::Model::TaggedSymbol
+            )
           GPT_REALTIME_2025_08_28 =
             T.let(
               :"gpt-realtime-2025-08-28",
@@ -1371,6 +1376,11 @@ module OpenAI
               :"gpt-realtime-mini-2025-12-15",
               OpenAI::Realtime::RealtimeSessionCreateResponse::Model::TaggedSymbol
             )
+          GPT_AUDIO_1_5 =
+            T.let(
+              :"gpt-audio-1.5",
+              OpenAI::Realtime::RealtimeSessionCreateResponse::Model::TaggedSymbol
+            )
           GPT_AUDIO_MINI =
             T.let(
               :"gpt-audio-mini",

data/rbi/openai/models/responses/easy_input_message.rbi

@@ -22,6 +22,19 @@ module OpenAI
         sig { returns(OpenAI::Responses::EasyInputMessage::Role::OrSymbol) }
         attr_accessor :role
 
+        # The phase of an assistant message.
+        #
+        # Use `commentary` for an intermediate assistant message and `final_answer` for
+        # the final assistant message. For follow-up requests with models like
+        # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
+        # Omitting it can degrade performance. Not used for user messages.
+        sig do
+          returns(
+            T.nilable(OpenAI::Responses::EasyInputMessage::Phase::OrSymbol)
+          )
+        end
+        attr_accessor :phase
+
         # The type of the message input. Always `message`.
         sig do
           returns(
@@ -44,6 +57,8 @@ module OpenAI
           params(
             content: OpenAI::Responses::EasyInputMessage::Content::Variants,
             role: OpenAI::Responses::EasyInputMessage::Role::OrSymbol,
+            phase:
+              T.nilable(OpenAI::Responses::EasyInputMessage::Phase::OrSymbol),
             type: OpenAI::Responses::EasyInputMessage::Type::OrSymbol
           ).returns(T.attached_class)
         end
@@ -54,6 +69,13 @@ module OpenAI
           # The role of the message input. One of `user`, `assistant`, `system`, or
           # `developer`.
           role:,
+          # The phase of an assistant message.
+          #
+          # Use `commentary` for an intermediate assistant message and `final_answer` for
+          # the final assistant message. For follow-up requests with models like
+          # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
+          # Omitting it can degrade performance. Not used for user messages.
+          phase: nil,
           # The type of the message input. Always `message`.
           type: nil
         )
@@ -64,6 +86,8 @@ module OpenAI
             {
               content: OpenAI::Responses::EasyInputMessage::Content::Variants,
               role: OpenAI::Responses::EasyInputMessage::Role::OrSymbol,
+              phase:
+                T.nilable(OpenAI::Responses::EasyInputMessage::Phase::OrSymbol),
               type: OpenAI::Responses::EasyInputMessage::Type::OrSymbol
             }
           )
@@ -134,6 +158,41 @@ module OpenAI
           end
         end
 
+        # The phase of an assistant message.
+        #
+        # Use `commentary` for an intermediate assistant message and `final_answer` for
+        # the final assistant message. For follow-up requests with models like
+        # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
+        # Omitting it can degrade performance. Not used for user messages.
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Responses::EasyInputMessage::Phase)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          COMMENTARY =
+            T.let(
+              :commentary,
+              OpenAI::Responses::EasyInputMessage::Phase::TaggedSymbol
+            )
+          FINAL_ANSWER =
+            T.let(
+              :final_answer,
+              OpenAI::Responses::EasyInputMessage::Phase::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[OpenAI::Responses::EasyInputMessage::Phase::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+
         # The type of the message input. Always `message`.
         module Type
           extend OpenAI::Internal::Type::Enum

data/rbi/openai/models/responses/response_compact_params.rbi

@@ -54,6 +54,10 @@ module OpenAI
         sig { returns(T.nilable(String)) }
         attr_accessor :previous_response_id
 
+        # A key to use when reading from or writing to the prompt cache.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :prompt_cache_key
+
         sig do
           params(
             model:
@@ -69,6 +73,7 @@ module OpenAI
               ),
             instructions: T.nilable(String),
             previous_response_id: T.nilable(String),
+            prompt_cache_key: T.nilable(String),
             request_options: OpenAI::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -91,6 +96,8 @@ module OpenAI
           # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
           # Cannot be used in conjunction with `conversation`.
           previous_response_id: nil,
+          # A key to use when reading from or writing to the prompt cache.
+          prompt_cache_key: nil,
           request_options: {}
         )
         end
@@ -111,6 +118,7 @@ module OpenAI
                 ),
               instructions: T.nilable(String),
               previous_response_id: T.nilable(String),
+              prompt_cache_key: T.nilable(String),
               request_options: OpenAI::RequestOptions
             }
           )

data/rbi/openai/models/responses/response_output_message.rbi

@@ -44,6 +44,19 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The phase of an assistant message.
+        #
+        # Use `commentary` for an intermediate assistant message and `final_answer` for
+        # the final assistant message. For follow-up requests with models like
+        # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
+        # Omitting it can degrade performance. Not used for user messages.
+        sig do
+          returns(
+            T.nilable(OpenAI::Responses::ResponseOutputMessage::Phase::OrSymbol)
+          )
+        end
+        attr_accessor :phase
+
         # An output message from the model.
         sig do
           params(
@@ -56,6 +69,10 @@ module OpenAI
                 )
               ],
             status: OpenAI::Responses::ResponseOutputMessage::Status::OrSymbol,
+            phase:
+              T.nilable(
+                OpenAI::Responses::ResponseOutputMessage::Phase::OrSymbol
+              ),
             role: Symbol,
             type: Symbol
           ).returns(T.attached_class)
@@ -68,6 +85,13 @@ module OpenAI
           # The status of the message input. One of `in_progress`, `completed`, or
           # `incomplete`. Populated when input items are returned via API.
           status:,
+          # The phase of an assistant message.
+          #
+          # Use `commentary` for an intermediate assistant message and `final_answer` for
+          # the final assistant message. For follow-up requests with models like
+          # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
+          # Omitting it can degrade performance. Not used for user messages.
+          phase: nil,
           # The role of the output message. Always `assistant`.
           role: :assistant,
           # The type of the output message. Always `message`.
@@ -89,7 +113,11 @@ module OpenAI
               role: Symbol,
               status:
                 OpenAI::Responses::ResponseOutputMessage::Status::OrSymbol,
-              type: Symbol
+              type: Symbol,
+              phase:
+                T.nilable(
+                  OpenAI::Responses::ResponseOutputMessage::Phase::OrSymbol
+                )
             }
           )
         end
@@ -156,6 +184,43 @@ module OpenAI
           def self.values
           end
         end
+
+        # The phase of an assistant message.
+        #
+        # Use `commentary` for an intermediate assistant message and `final_answer` for
+        # the final assistant message. For follow-up requests with models like
+        # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
+        # Omitting it can degrade performance. Not used for user messages.
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Responses::ResponseOutputMessage::Phase)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          COMMENTARY =
+            T.let(
+              :commentary,
+              OpenAI::Responses::ResponseOutputMessage::Phase::TaggedSymbol
+            )
+          FINAL_ANSWER =
+            T.let(
+              :final_answer,
+              OpenAI::Responses::ResponseOutputMessage::Phase::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::ResponseOutputMessage::Phase::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/openai/resources/responses.rbi

@@ -981,6 +981,7 @@ module OpenAI
             ),
           instructions: T.nilable(String),
           previous_response_id: T.nilable(String),
+          prompt_cache_key: T.nilable(String),
           request_options: OpenAI::RequestOptions::OrHash
         ).returns(OpenAI::Responses::CompactedResponse)
       end
@@ -1003,6 +1004,8 @@ module OpenAI
         # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
         # Cannot be used in conjunction with `conversation`.
         previous_response_id: nil,
+        # A key to use when reading from or writing to the prompt cache.
+        prompt_cache_key: nil,
         request_options: {}
       )
       end

data/sig/openai/models/realtime/realtime_session.rbs

@@ -223,6 +223,7 @@ module OpenAI
         type model =
           String
           | :"gpt-realtime"
+          | :"gpt-realtime-1.5"
           | :"gpt-realtime-2025-08-28"
           | :"gpt-4o-realtime-preview"
           | :"gpt-4o-realtime-preview-2024-10-01"
@@ -233,6 +234,7 @@ module OpenAI
           | :"gpt-realtime-mini"
           | :"gpt-realtime-mini-2025-10-06"
           | :"gpt-realtime-mini-2025-12-15"
+          | :"gpt-audio-1.5"
           | :"gpt-audio-mini"
           | :"gpt-audio-mini-2025-10-06"
           | :"gpt-audio-mini-2025-12-15"
@@ -243,6 +245,7 @@ module OpenAI
           def self?.variants: -> ::Array[OpenAI::Models::Realtime::RealtimeSession::model]
 
           GPT_REALTIME: :"gpt-realtime"
+          GPT_REALTIME_1_5: :"gpt-realtime-1.5"
           GPT_REALTIME_2025_08_28: :"gpt-realtime-2025-08-28"
           GPT_4O_REALTIME_PREVIEW: :"gpt-4o-realtime-preview"
           GPT_4O_REALTIME_PREVIEW_2024_10_01: :"gpt-4o-realtime-preview-2024-10-01"
@@ -253,6 +256,7 @@ module OpenAI
           GPT_REALTIME_MINI: :"gpt-realtime-mini"
           GPT_REALTIME_MINI_2025_10_06: :"gpt-realtime-mini-2025-10-06"
           GPT_REALTIME_MINI_2025_12_15: :"gpt-realtime-mini-2025-12-15"
+          GPT_AUDIO_1_5: :"gpt-audio-1.5"
           GPT_AUDIO_MINI: :"gpt-audio-mini"
           GPT_AUDIO_MINI_2025_10_06: :"gpt-audio-mini-2025-10-06"
           GPT_AUDIO_MINI_2025_12_15: :"gpt-audio-mini-2025-12-15"

data/sig/openai/models/realtime/realtime_session_create_request.rbs

@@ -127,6 +127,7 @@ module OpenAI
         type model =
           String
           | :"gpt-realtime"
+          | :"gpt-realtime-1.5"
           | :"gpt-realtime-2025-08-28"
           | :"gpt-4o-realtime-preview"
           | :"gpt-4o-realtime-preview-2024-10-01"
@@ -137,6 +138,7 @@ module OpenAI
           | :"gpt-realtime-mini"
           | :"gpt-realtime-mini-2025-10-06"
           | :"gpt-realtime-mini-2025-12-15"
+          | :"gpt-audio-1.5"
           | :"gpt-audio-mini"
           | :"gpt-audio-mini-2025-10-06"
           | :"gpt-audio-mini-2025-12-15"
@@ -147,6 +149,7 @@ module OpenAI
           def self?.variants: -> ::Array[OpenAI::Models::Realtime::RealtimeSessionCreateRequest::model]
 
           GPT_REALTIME: :"gpt-realtime"
+          GPT_REALTIME_1_5: :"gpt-realtime-1.5"
           GPT_REALTIME_2025_08_28: :"gpt-realtime-2025-08-28"
           GPT_4O_REALTIME_PREVIEW: :"gpt-4o-realtime-preview"
           GPT_4O_REALTIME_PREVIEW_2024_10_01: :"gpt-4o-realtime-preview-2024-10-01"
@@ -157,6 +160,7 @@ module OpenAI
           GPT_REALTIME_MINI: :"gpt-realtime-mini"
           GPT_REALTIME_MINI_2025_10_06: :"gpt-realtime-mini-2025-10-06"
           GPT_REALTIME_MINI_2025_12_15: :"gpt-realtime-mini-2025-12-15"
+          GPT_AUDIO_1_5: :"gpt-audio-1.5"
           GPT_AUDIO_MINI: :"gpt-audio-mini"
           GPT_AUDIO_MINI_2025_10_06: :"gpt-audio-mini-2025-10-06"
           GPT_AUDIO_MINI_2025_12_15: :"gpt-audio-mini-2025-12-15"

data/sig/openai/models/realtime/realtime_session_create_response.rbs

@@ -414,6 +414,7 @@ module OpenAI
         type model =
           String
           | :"gpt-realtime"
+          | :"gpt-realtime-1.5"
           | :"gpt-realtime-2025-08-28"
           | :"gpt-4o-realtime-preview"
           | :"gpt-4o-realtime-preview-2024-10-01"
@@ -424,6 +425,7 @@ module OpenAI
           | :"gpt-realtime-mini"
           | :"gpt-realtime-mini-2025-10-06"
           | :"gpt-realtime-mini-2025-12-15"
+          | :"gpt-audio-1.5"
           | :"gpt-audio-mini"
           | :"gpt-audio-mini-2025-10-06"
           | :"gpt-audio-mini-2025-12-15"
@@ -434,6 +436,7 @@ module OpenAI
           def self?.variants: -> ::Array[OpenAI::Models::Realtime::RealtimeSessionCreateResponse::model]
 
           GPT_REALTIME: :"gpt-realtime"
+          GPT_REALTIME_1_5: :"gpt-realtime-1.5"
           GPT_REALTIME_2025_08_28: :"gpt-realtime-2025-08-28"
           GPT_4O_REALTIME_PREVIEW: :"gpt-4o-realtime-preview"
           GPT_4O_REALTIME_PREVIEW_2024_10_01: :"gpt-4o-realtime-preview-2024-10-01"
@@ -444,6 +447,7 @@ module OpenAI
           GPT_REALTIME_MINI: :"gpt-realtime-mini"
           GPT_REALTIME_MINI_2025_10_06: :"gpt-realtime-mini-2025-10-06"
           GPT_REALTIME_MINI_2025_12_15: :"gpt-realtime-mini-2025-12-15"
+          GPT_AUDIO_1_5: :"gpt-audio-1.5"
           GPT_AUDIO_MINI: :"gpt-audio-mini"
           GPT_AUDIO_MINI_2025_10_06: :"gpt-audio-mini-2025-10-06"
           GPT_AUDIO_MINI_2025_12_15: :"gpt-audio-mini-2025-12-15"

data/sig/openai/models/responses/easy_input_message.rbs

@@ -5,6 +5,7 @@ module OpenAI
         {
           content: OpenAI::Models::Responses::EasyInputMessage::content,
           role: OpenAI::Models::Responses::EasyInputMessage::role,
+          phase: OpenAI::Models::Responses::EasyInputMessage::phase?,
           type: OpenAI::Models::Responses::EasyInputMessage::type_
         }
 
@@ -13,6 +14,8 @@ module OpenAI
 
         attr_accessor role: OpenAI::Models::Responses::EasyInputMessage::role
 
+        attr_accessor phase: OpenAI::Models::Responses::EasyInputMessage::phase?
+
         attr_reader type: OpenAI::Models::Responses::EasyInputMessage::type_?
 
         def type=: (
@@ -22,12 +25,14 @@ module OpenAI
         def initialize: (
           content: OpenAI::Models::Responses::EasyInputMessage::content,
           role: OpenAI::Models::Responses::EasyInputMessage::role,
+          ?phase: OpenAI::Models::Responses::EasyInputMessage::phase?,
           ?type: OpenAI::Models::Responses::EasyInputMessage::type_
         ) -> void
 
         def to_hash: -> {
           content: OpenAI::Models::Responses::EasyInputMessage::content,
           role: OpenAI::Models::Responses::EasyInputMessage::role,
+          phase: OpenAI::Models::Responses::EasyInputMessage::phase?,
           type: OpenAI::Models::Responses::EasyInputMessage::type_
         }
 
@@ -54,6 +59,17 @@ module OpenAI
           def self?.values: -> ::Array[OpenAI::Models::Responses::EasyInputMessage::role]
         end
 
+        type phase = :commentary | :final_answer
+
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          COMMENTARY: :commentary
+          FINAL_ANSWER: :final_answer
+
+          def self?.values: -> ::Array[OpenAI::Models::Responses::EasyInputMessage::phase]
+        end
+
         type type_ = :message
 
         module Type

data/sig/openai/models/responses/response_compact_params.rbs

@@ -6,7 +6,8 @@ module OpenAI
           model: OpenAI::Models::Responses::ResponseCompactParams::model?,
           input: OpenAI::Models::Responses::ResponseCompactParams::input?,
           instructions: String?,
-          previous_response_id: String?
+          previous_response_id: String?,
+          prompt_cache_key: String?
         }
         & OpenAI::Internal::Type::request_parameters
 
@@ -22,11 +23,14 @@ module OpenAI
 
         attr_accessor previous_response_id: String?
 
+        attr_accessor prompt_cache_key: String?
+
         def initialize: (
           model: OpenAI::Models::Responses::ResponseCompactParams::model?,
           ?input: OpenAI::Models::Responses::ResponseCompactParams::input?,
           ?instructions: String?,
           ?previous_response_id: String?,
+          ?prompt_cache_key: String?,
           ?request_options: OpenAI::request_opts
         ) -> void
 
@@ -35,6 +39,7 @@ module OpenAI
           input: OpenAI::Models::Responses::ResponseCompactParams::input?,
           instructions: String?,
           previous_response_id: String?,
+          prompt_cache_key: String?,
           request_options: OpenAI::RequestOptions
         }
 

data/sig/openai/models/responses/response_output_message.rbs

@@ -7,7 +7,8 @@ module OpenAI
           content: ::Array[OpenAI::Models::Responses::ResponseOutputMessage::content],
           role: :assistant,
           status: OpenAI::Models::Responses::ResponseOutputMessage::status,
-          type: :message
+          type: :message,
+          phase: OpenAI::Models::Responses::ResponseOutputMessage::phase?
         }
 
       class ResponseOutputMessage < OpenAI::Internal::Type::BaseModel
@@ -21,10 +22,13 @@ module OpenAI
 
         attr_accessor type: :message
 
+        attr_accessor phase: OpenAI::Models::Responses::ResponseOutputMessage::phase?
+
         def initialize: (
           id: String,
           content: ::Array[OpenAI::Models::Responses::ResponseOutputMessage::content],
           status: OpenAI::Models::Responses::ResponseOutputMessage::status,
+          ?phase: OpenAI::Models::Responses::ResponseOutputMessage::phase?,
           ?role: :assistant,
           ?type: :message
         ) -> void
@@ -34,7 +38,8 @@ module OpenAI
           content: ::Array[OpenAI::Models::Responses::ResponseOutputMessage::content],
           role: :assistant,
           status: OpenAI::Models::Responses::ResponseOutputMessage::status,
-          type: :message
+          type: :message,
+          phase: OpenAI::Models::Responses::ResponseOutputMessage::phase?
         }
 
         type content =
@@ -58,6 +63,17 @@ module OpenAI
 
           def self?.values: -> ::Array[OpenAI::Models::Responses::ResponseOutputMessage::status]
         end
+
+        type phase = :commentary | :final_answer
+
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          COMMENTARY: :commentary
+          FINAL_ANSWER: :final_answer
+
+          def self?.values: -> ::Array[OpenAI::Models::Responses::ResponseOutputMessage::phase]
+        end
       end
     end
   end

data/sig/openai/resources/responses.rbs

@@ -128,6 +128,7 @@ module OpenAI
         ?input: OpenAI::Models::Responses::ResponseCompactParams::input?,
         ?instructions: String?,
         ?previous_response_id: String?,
+        ?prompt_cache_key: String?,
         ?request_options: OpenAI::request_opts
       ) -> OpenAI::Responses::CompactedResponse
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openai
 version: !ruby/object:Gem::Version
-  version: 0.49.1
+  version: 0.51.0
 platform: ruby
 authors:
 - OpenAI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-23 00:00:00.000000000 Z
+date: 2026-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64