openai 0.61.0 → 0.63.0

data/rbi/openai/models/image_generate_params.rbi

@@ -18,9 +18,14 @@ module OpenAI
       attr_accessor :prompt
 
       # Allows to set transparency for the background of the generated image(s). This
-      # parameter is only supported for the GPT image models. Must be one of
-      # `transparent`, `opaque` or `auto` (default value). When `auto` is used, the
-      # model will automatically determine the best background for the image.
+      # parameter is only supported for GPT image models that support transparent
+      # backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value).
+      # When `auto` is used, the model will automatically determine the best background
+      # for the image.
+      #
+      # `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent
+      # backgrounds. Requests with `background` set to `transparent` will return an
+      # error for these models; use `opaque` or `auto` instead.
       #
       # If `transparent`, the output format needs to support transparency, so it should
       # be set to either `png` (default value) or `webp`.
@@ -30,8 +35,9 @@ module OpenAI
       attr_accessor :background
 
       # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
-      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`). Defaults to
-      # `dall-e-2` unless a parameter specific to the GPT image models is used.
+      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+      # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
+      # to the GPT image models is used.
       sig { returns(T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol))) }
       attr_accessor :model
 
@@ -91,11 +97,22 @@ module OpenAI
       end
       attr_accessor :response_format
 
-      # The size of the generated images. Must be one of `1024x1024`, `1536x1024`
-      # (landscape), `1024x1536` (portrait), or `auto` (default value) for the GPT image
-      # models, one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`, and one of
-      # `1024x1024`, `1792x1024`, or `1024x1792` for `dall-e-3`.
-      sig { returns(T.nilable(OpenAI::ImageGenerateParams::Size::OrSymbol)) }
+      # The size of the generated images. For `gpt-image-2` and
+      # `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
+      # strings, for example `1536x864`. Width and height must both be divisible by 16
+      # and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
+      # `2560x1440` are experimental, and the maximum supported resolution is
+      # `3840x2160`. The requested size must also satisfy the model's current pixel and
+      # edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
+      # supported by the GPT image models; `auto` is supported for models that allow
+      # automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
+      # `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
+      # `1024x1792`.
+      sig do
+        returns(
+          T.nilable(T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol))
+        )
+      end
       attr_accessor :size
 
       # The style of the generated images. This parameter is only supported for
@@ -130,7 +147,10 @@ module OpenAI
           quality: T.nilable(OpenAI::ImageGenerateParams::Quality::OrSymbol),
           response_format:
             T.nilable(OpenAI::ImageGenerateParams::ResponseFormat::OrSymbol),
-          size: T.nilable(OpenAI::ImageGenerateParams::Size::OrSymbol),
+          size:
+            T.nilable(
+              T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol)
+            ),
           style: T.nilable(OpenAI::ImageGenerateParams::Style::OrSymbol),
           user: String,
           request_options: OpenAI::RequestOptions::OrHash
@@ -142,16 +162,22 @@ module OpenAI
         # characters for `dall-e-3`.
         prompt:,
         # Allows to set transparency for the background of the generated image(s). This
-        # parameter is only supported for the GPT image models. Must be one of
-        # `transparent`, `opaque` or `auto` (default value). When `auto` is used, the
-        # model will automatically determine the best background for the image.
+        # parameter is only supported for GPT image models that support transparent
+        # backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value).
+        # When `auto` is used, the model will automatically determine the best background
+        # for the image.
+        #
+        # `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent
+        # backgrounds. Requests with `background` set to `transparent` will return an
+        # error for these models; use `opaque` or `auto` instead.
         #
         # If `transparent`, the output format needs to support transparency, so it should
         # be set to either `png` (default value) or `webp`.
         background: nil,
         # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
-        # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`). Defaults to
-        # `dall-e-2` unless a parameter specific to the GPT image models is used.
+        # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+        # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
+        # to the GPT image models is used.
         model: nil,
         # Control the content-moderation level for images generated by the GPT image
         # models. Must be either `low` for less restrictive filtering or `auto` (default
@@ -187,10 +213,17 @@ module OpenAI
         # after the image has been generated. This parameter isn't supported for the GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
-        # The size of the generated images. Must be one of `1024x1024`, `1536x1024`
-        # (landscape), `1024x1536` (portrait), or `auto` (default value) for the GPT image
-        # models, one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`, and one of
-        # `1024x1024`, `1792x1024`, or `1024x1792` for `dall-e-3`.
+        # The size of the generated images. For `gpt-image-2` and
+        # `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
+        # strings, for example `1536x864`. Width and height must both be divisible by 16
+        # and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
+        # `2560x1440` are experimental, and the maximum supported resolution is
+        # `3840x2160`. The requested size must also satisfy the model's current pixel and
+        # edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
+        # supported by the GPT image models; `auto` is supported for models that allow
+        # automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
+        # `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
+        # `1024x1792`.
         size: nil,
         # The style of the generated images. This parameter is only supported for
         # `dall-e-3`. Must be one of `vivid` or `natural`. Vivid causes the model to lean
@@ -222,7 +255,10 @@ module OpenAI
             quality: T.nilable(OpenAI::ImageGenerateParams::Quality::OrSymbol),
             response_format:
               T.nilable(OpenAI::ImageGenerateParams::ResponseFormat::OrSymbol),
-            size: T.nilable(OpenAI::ImageGenerateParams::Size::OrSymbol),
+            size:
+              T.nilable(
+                T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol)
+              ),
             style: T.nilable(OpenAI::ImageGenerateParams::Style::OrSymbol),
             user: String,
             request_options: OpenAI::RequestOptions
@@ -233,9 +269,14 @@ module OpenAI
       end
 
       # Allows to set transparency for the background of the generated image(s). This
-      # parameter is only supported for the GPT image models. Must be one of
-      # `transparent`, `opaque` or `auto` (default value). When `auto` is used, the
-      # model will automatically determine the best background for the image.
+      # parameter is only supported for GPT image models that support transparent
+      # backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value).
+      # When `auto` is used, the model will automatically determine the best background
+      # for the image.
+      #
+      # `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent
+      # backgrounds. Requests with `background` set to `transparent` will return an
+      # error for these models; use `opaque` or `auto` instead.
       #
       # If `transparent`, the output format needs to support transparency, so it should
       # be set to either `png` (default value) or `webp`.
@@ -268,8 +309,9 @@ module OpenAI
       end
 
       # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
-      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`). Defaults to
-      # `dall-e-2` unless a parameter specific to the GPT image models is used.
+      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+      # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
+      # to the GPT image models is used.
       module Model
         extend OpenAI::Internal::Type::Union
 
@@ -399,12 +441,32 @@ module OpenAI
         end
       end
 
-      # The size of the generated images. Must be one of `1024x1024`, `1536x1024`
-      # (landscape), `1024x1536` (portrait), or `auto` (default value) for the GPT image
-      # models, one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`, and one of
-      # `1024x1024`, `1792x1024`, or `1024x1792` for `dall-e-3`.
+      # The size of the generated images. For `gpt-image-2` and
+      # `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
+      # strings, for example `1536x864`. Width and height must both be divisible by 16
+      # and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
+      # `2560x1440` are experimental, and the maximum supported resolution is
+      # `3840x2160`. The requested size must also satisfy the model's current pixel and
+      # edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
+      # supported by the GPT image models; `auto` is supported for models that allow
+      # automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
+      # `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
+      # `1024x1792`.
       module Size
-        extend OpenAI::Internal::Type::Enum
+        extend OpenAI::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(String, OpenAI::ImageGenerateParams::Size::TaggedSymbol)
+          end
+
+        sig do
+          override.returns(
+            T::Array[OpenAI::ImageGenerateParams::Size::Variants]
+          )
+        end
+        def self.variants
+        end
 
         TaggedSymbol =
           T.type_alias { T.all(Symbol, OpenAI::ImageGenerateParams::Size) }
@@ -425,14 +487,6 @@ module OpenAI
           T.let(:"1792x1024", OpenAI::ImageGenerateParams::Size::TaggedSymbol)
         SIZE_1024X1792 =
           T.let(:"1024x1792", OpenAI::ImageGenerateParams::Size::TaggedSymbol)
-
-        sig do
-          override.returns(
-            T::Array[OpenAI::ImageGenerateParams::Size::TaggedSymbol]
-          )
-        end
-        def self.values
-        end
       end
 
       # The style of the generated images. This parameter is only supported for

data/rbi/openai/models/image_model.rbi

@@ -8,12 +8,17 @@ module OpenAI
       TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::ImageModel) }
       OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-      GPT_IMAGE_1_5 = T.let(:"gpt-image-1.5", OpenAI::ImageModel::TaggedSymbol)
-      DALL_E_2 = T.let(:"dall-e-2", OpenAI::ImageModel::TaggedSymbol)
-      DALL_E_3 = T.let(:"dall-e-3", OpenAI::ImageModel::TaggedSymbol)
       GPT_IMAGE_1 = T.let(:"gpt-image-1", OpenAI::ImageModel::TaggedSymbol)
       GPT_IMAGE_1_MINI =
         T.let(:"gpt-image-1-mini", OpenAI::ImageModel::TaggedSymbol)
+      GPT_IMAGE_2 = T.let(:"gpt-image-2", OpenAI::ImageModel::TaggedSymbol)
+      GPT_IMAGE_2_2026_04_21 =
+        T.let(:"gpt-image-2-2026-04-21", OpenAI::ImageModel::TaggedSymbol)
+      GPT_IMAGE_1_5 = T.let(:"gpt-image-1.5", OpenAI::ImageModel::TaggedSymbol)
+      CHATGPT_IMAGE_LATEST =
+        T.let(:"chatgpt-image-latest", OpenAI::ImageModel::TaggedSymbol)
+      DALL_E_2 = T.let(:"dall-e-2", OpenAI::ImageModel::TaggedSymbol)
+      DALL_E_3 = T.let(:"dall-e-3", OpenAI::ImageModel::TaggedSymbol)
 
       sig { override.returns(T::Array[OpenAI::ImageModel::TaggedSymbol]) }
       def self.values

data/rbi/openai/models/realtime/audio_transcription.rbi

@@ -12,6 +12,23 @@ module OpenAI
             )
           end
 
+        # Controls how long the model waits before emitting transcription text. Higher
+        # values can improve transcription accuracy at the cost of latency. Only supported
+        # with `gpt-realtime-whisper` in GA Realtime sessions.
+        sig do
+          returns(
+            T.nilable(OpenAI::Realtime::AudioTranscription::Delay::OrSymbol)
+          )
+        end
+        attr_reader :delay
+
+        sig do
+          params(
+            delay: OpenAI::Realtime::AudioTranscription::Delay::OrSymbol
+          ).void
+        end
+        attr_writer :delay
+
         # The language of the input audio. Supplying the input language in
         # [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`)
         # format will improve accuracy and latency.
@@ -23,8 +40,8 @@ module OpenAI
 
         # The model to use for transcription. Current options are `whisper-1`,
         # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`,
-        # `gpt-4o-transcribe`, and `gpt-4o-transcribe-diarize`. Use
-        # `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
+        # `gpt-4o-transcribe`, `gpt-4o-transcribe-diarize`, and `gpt-realtime-whisper`.
+        # Use `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
         sig do
           returns(
             T.nilable(
@@ -53,6 +70,7 @@ module OpenAI
         # [prompt is a list of keywords](https://platform.openai.com/docs/guides/speech-to-text#prompting).
         # For `gpt-4o-transcribe` models (excluding `gpt-4o-transcribe-diarize`), the
         # prompt is a free text string, for example "expect words related to technology".
+        # Prompt is not supported with `gpt-realtime-whisper` in GA Realtime sessions.
         sig { returns(T.nilable(String)) }
         attr_reader :prompt
 
@@ -61,6 +79,7 @@ module OpenAI
 
         sig do
           params(
+            delay: OpenAI::Realtime::AudioTranscription::Delay::OrSymbol,
             language: String,
             model:
               T.any(
@@ -71,20 +90,25 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
+          # Controls how long the model waits before emitting transcription text. Higher
+          # values can improve transcription accuracy at the cost of latency. Only supported
+          # with `gpt-realtime-whisper` in GA Realtime sessions.
+          delay: nil,
           # The language of the input audio. Supplying the input language in
           # [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`)
           # format will improve accuracy and latency.
           language: nil,
           # The model to use for transcription. Current options are `whisper-1`,
           # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`,
-          # `gpt-4o-transcribe`, and `gpt-4o-transcribe-diarize`. Use
-          # `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
+          # `gpt-4o-transcribe`, `gpt-4o-transcribe-diarize`, and `gpt-realtime-whisper`.
+          # Use `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
           model: nil,
           # An optional text to guide the model's style or continue a previous audio
           # segment. For `whisper-1`, the
           # [prompt is a list of keywords](https://platform.openai.com/docs/guides/speech-to-text#prompting).
           # For `gpt-4o-transcribe` models (excluding `gpt-4o-transcribe-diarize`), the
           # prompt is a free text string, for example "expect words related to technology".
+          # Prompt is not supported with `gpt-realtime-whisper` in GA Realtime sessions.
           prompt: nil
         )
         end
@@ -92,6 +116,7 @@ module OpenAI
         sig do
           override.returns(
             {
+              delay: OpenAI::Realtime::AudioTranscription::Delay::OrSymbol,
               language: String,
               model:
                 T.any(
@@ -105,10 +130,59 @@ module OpenAI
         def to_hash
         end
 
+        # Controls how long the model waits before emitting transcription text. Higher
+        # values can improve transcription accuracy at the cost of latency. Only supported
+        # with `gpt-realtime-whisper` in GA Realtime sessions.
+        module Delay
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Realtime::AudioTranscription::Delay)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MINIMAL =
+            T.let(
+              :minimal,
+              OpenAI::Realtime::AudioTranscription::Delay::TaggedSymbol
+            )
+          LOW =
+            T.let(
+              :low,
+              OpenAI::Realtime::AudioTranscription::Delay::TaggedSymbol
+            )
+          MEDIUM =
+            T.let(
+              :medium,
+              OpenAI::Realtime::AudioTranscription::Delay::TaggedSymbol
+            )
+          HIGH =
+            T.let(
+              :high,
+              OpenAI::Realtime::AudioTranscription::Delay::TaggedSymbol
+            )
+          XHIGH =
+            T.let(
+              :xhigh,
+              OpenAI::Realtime::AudioTranscription::Delay::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Realtime::AudioTranscription::Delay::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
         # The model to use for transcription. Current options are `whisper-1`,
         # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`,
-        # `gpt-4o-transcribe`, and `gpt-4o-transcribe-diarize`. Use
-        # `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
+        # `gpt-4o-transcribe`, `gpt-4o-transcribe-diarize`, and `gpt-realtime-whisper`.
+        # Use `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
         module Model
           extend OpenAI::Internal::Type::Union
 
@@ -159,6 +233,11 @@ module OpenAI
               :"gpt-4o-transcribe-diarize",
               OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
             )
+          GPT_REALTIME_WHISPER =
+            T.let(
+              :"gpt-realtime-whisper",
+              OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
+            )
         end
       end
     end

data/rbi/openai/models/realtime/realtime_audio_config_input.rbi

@@ -91,6 +91,9 @@ module OpenAI
         # trails off with "uhhm", the model will score a low probability of turn end and
         # wait longer for the user to continue speaking. This can be useful for more
         # natural conversations, but may have a higher latency.
+        #
+        # For `gpt-realtime-whisper` transcription sessions, turn detection must be set to
+        # `null`; VAD is not supported.
         sig do
           returns(
             T.nilable(
@@ -154,6 +157,9 @@ module OpenAI
           # trails off with "uhhm", the model will score a low probability of turn end and
           # wait longer for the user to continue speaking. This can be useful for more
           # natural conversations, but may have a higher latency.
+          #
+          # For `gpt-realtime-whisper` transcription sessions, turn detection must be set to
+          # `null`; VAD is not supported.
           turn_detection: nil
         )
         end

data/rbi/openai/models/realtime/realtime_audio_input_turn_detection.rbi

@@ -16,6 +16,9 @@ module OpenAI
       # trails off with "uhhm", the model will score a low probability of turn end and
       # wait longer for the user to continue speaking. This can be useful for more
       # natural conversations, but may have a higher latency.
+      #
+      # For `gpt-realtime-whisper` transcription sessions, turn detection must be set to
+      # `null`; VAD is not supported.
       module RealtimeAudioInputTurnDetection
         extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/realtime/realtime_reasoning.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Realtime
+      class RealtimeReasoning < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Realtime::RealtimeReasoning,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # Constrains effort on reasoning for reasoning-capable Realtime models such as
+        # `gpt-realtime-2`.
+        sig do
+          returns(
+            T.nilable(OpenAI::Realtime::RealtimeReasoningEffort::OrSymbol)
+          )
+        end
+        attr_reader :effort
+
+        sig do
+          params(
+            effort: OpenAI::Realtime::RealtimeReasoningEffort::OrSymbol
+          ).void
+        end
+        attr_writer :effort
+
+        # Configuration for reasoning-capable Realtime models such as `gpt-realtime-2`.
+        sig do
+          params(
+            effort: OpenAI::Realtime::RealtimeReasoningEffort::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Constrains effort on reasoning for reasoning-capable Realtime models such as
+          # `gpt-realtime-2`.
+          effort: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            { effort: OpenAI::Realtime::RealtimeReasoningEffort::OrSymbol }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/realtime/realtime_reasoning_effort.rbi

@@ -0,0 +1,44 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Realtime
+      # Constrains effort on reasoning for reasoning-capable Realtime models such as
+      # `gpt-realtime-2`.
+      module RealtimeReasoningEffort
+        extend OpenAI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, OpenAI::Realtime::RealtimeReasoningEffort)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        MINIMAL =
+          T.let(
+            :minimal,
+            OpenAI::Realtime::RealtimeReasoningEffort::TaggedSymbol
+          )
+        LOW =
+          T.let(:low, OpenAI::Realtime::RealtimeReasoningEffort::TaggedSymbol)
+        MEDIUM =
+          T.let(
+            :medium,
+            OpenAI::Realtime::RealtimeReasoningEffort::TaggedSymbol
+          )
+        HIGH =
+          T.let(:high, OpenAI::Realtime::RealtimeReasoningEffort::TaggedSymbol)
+        XHIGH =
+          T.let(:xhigh, OpenAI::Realtime::RealtimeReasoningEffort::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[OpenAI::Realtime::RealtimeReasoningEffort::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/realtime/realtime_response_create_params.rbi

@@ -159,6 +159,14 @@ module OpenAI
         end
         attr_writer :output_modalities
 
+        # Whether the model may call multiple tools in parallel. Only supported by
+        # reasoning Realtime models such as `gpt-realtime-2`.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :parallel_tool_calls
+
+        sig { params(parallel_tool_calls: T::Boolean).void }
+        attr_writer :parallel_tool_calls
+
         # Reference to a prompt template and its variables.
         # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
         sig { returns(T.nilable(OpenAI::Responses::ResponsePrompt)) }
@@ -171,6 +179,15 @@ module OpenAI
         end
         attr_writer :prompt
 
+        # Configuration for reasoning-capable Realtime models such as `gpt-realtime-2`.
+        sig { returns(T.nilable(OpenAI::Realtime::RealtimeReasoning)) }
+        attr_reader :reasoning
+
+        sig do
+          params(reasoning: OpenAI::Realtime::RealtimeReasoning::OrHash).void
+        end
+        attr_writer :reasoning
+
         # How the model chooses tools. Provide one of the string modes or force a specific
         # function/MCP tool.
         sig do
@@ -256,7 +273,9 @@ module OpenAI
               T::Array[
                 OpenAI::Realtime::RealtimeResponseCreateParams::OutputModality::OrSymbol
               ],
+            parallel_tool_calls: T::Boolean,
             prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
+            reasoning: OpenAI::Realtime::RealtimeReasoning::OrHash,
             tool_choice:
               T.any(
                 OpenAI::Responses::ToolChoiceOptions::OrSymbol,
@@ -313,9 +332,14 @@ module OpenAI
           # transcript. Setting the output to mode `text` will disable audio output from the
           # model.
           output_modalities: nil,
+          # Whether the model may call multiple tools in parallel. Only supported by
+          # reasoning Realtime models such as `gpt-realtime-2`.
+          parallel_tool_calls: nil,
           # Reference to a prompt template and its variables.
           # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
           prompt: nil,
+          # Configuration for reasoning-capable Realtime models such as `gpt-realtime-2`.
+          reasoning: nil,
           # How the model chooses tools. Provide one of the string modes or force a specific
           # function/MCP tool.
           tool_choice: nil,
@@ -354,7 +378,9 @@ module OpenAI
                 T::Array[
                   OpenAI::Realtime::RealtimeResponseCreateParams::OutputModality::OrSymbol
                 ],
+              parallel_tool_calls: T::Boolean,
               prompt: T.nilable(OpenAI::Responses::ResponsePrompt),
+              reasoning: OpenAI::Realtime::RealtimeReasoning,
               tool_choice:
                 T.any(
                   OpenAI::Responses::ToolChoiceOptions::OrSymbol,

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

@@ -274,6 +274,9 @@ module OpenAI
         # trails off with "uhhm", the model will score a low probability of turn end and
         # wait longer for the user to continue speaking. This can be useful for more
         # natural conversations, but may have a higher latency.
+        #
+        # For `gpt-realtime-whisper` transcription sessions, turn detection must be set to
+        # `null`; VAD is not supported.
         sig do
           returns(
             T.nilable(
@@ -442,6 +445,9 @@ module OpenAI
           # trails off with "uhhm", the model will score a low probability of turn end and
           # wait longer for the user to continue speaking. This can be useful for more
           # natural conversations, but may have a higher latency.
+          #
+          # For `gpt-realtime-whisper` transcription sessions, turn detection must be set to
+          # `null`; VAD is not supported.
           turn_detection: nil,
           # The voice the model uses to respond. Voice cannot be changed during the session
           # once the model has responded with audio at least once. Current voice options are
@@ -948,6 +954,9 @@ module OpenAI
         # trails off with "uhhm", the model will score a low probability of turn end and
         # wait longer for the user to continue speaking. This can be useful for more
         # natural conversations, but may have a higher latency.
+        #
+        # For `gpt-realtime-whisper` transcription sessions, turn detection must be set to
+        # `null`; VAD is not supported.
         module TurnDetection
           extend OpenAI::Internal::Type::Union