openai 0.61.0 → 0.63.0

data/rbi/openai/models/responses/tool.rbi

@@ -926,8 +926,18 @@ module OpenAI
           end
           attr_writer :action
 
-          # Background type for the generated image. One of `transparent`, `opaque`, or
-          # `auto`. Default: `auto`.
+          # Allows to set transparency for the background of the generated image(s). This
+          # 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`.
           sig do
             returns(
               T.nilable(
@@ -1072,12 +1082,24 @@ module OpenAI
           end
           attr_writer :quality
 
-          # The size of the generated image. One of `1024x1024`, `1024x1536`, `1536x1024`,
-          # or `auto`. Default: `auto`.
+          # 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(
-                OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                T.any(
+                  String,
+                  OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                )
               )
             )
           end
@@ -1085,7 +1107,11 @@ module OpenAI
 
           sig do
             params(
-              size: OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+              size:
+                T.any(
+                  String,
+                  OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                )
             ).void
           end
           attr_writer :size
@@ -1116,15 +1142,29 @@ module OpenAI
               partial_images: Integer,
               quality:
                 OpenAI::Responses::Tool::ImageGeneration::Quality::OrSymbol,
-              size: OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol,
+              size:
+                T.any(
+                  String,
+                  OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                ),
               type: Symbol
             ).returns(T.attached_class)
           end
           def self.new(
             # Whether to generate a new image or edit an existing image. Default: `auto`.
             action: nil,
-            # Background type for the generated image. One of `transparent`, `opaque`, or
-            # `auto`. Default: `auto`.
+            # Allows to set transparency for the background of the generated image(s). This
+            # 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,
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. This parameter is only supported
@@ -1149,8 +1189,17 @@ module OpenAI
             # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
             # Default: `auto`.
             quality: nil,
-            # The size of the generated image. One of `1024x1024`, `1024x1536`, `1536x1024`,
-            # or `auto`. Default: `auto`.
+            # 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 type of the image generation tool. Always `image_generation`.
             type: :image_generation
@@ -1184,7 +1233,11 @@ module OpenAI
                 partial_images: Integer,
                 quality:
                   OpenAI::Responses::Tool::ImageGeneration::Quality::OrSymbol,
-                size: OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                size:
+                  T.any(
+                    String,
+                    OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                  )
               }
             )
           end
@@ -1228,8 +1281,18 @@ module OpenAI
             end
           end
 
-          # Background type for the generated image. One of `transparent`, `opaque`, or
-          # `auto`. Default: `auto`.
+          # Allows to set transparency for the background of the generated image(s). This
+          # 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`.
           module Background
             extend OpenAI::Internal::Type::Enum
 
@@ -1388,11 +1451,26 @@ module OpenAI
                 :"gpt-image-1-mini",
                 OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
               )
+            GPT_IMAGE_2 =
+              T.let(
+                :"gpt-image-2",
+                OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+              )
+            GPT_IMAGE_2_2026_04_21 =
+              T.let(
+                :"gpt-image-2-2026-04-21",
+                OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+              )
             GPT_IMAGE_1_5 =
               T.let(
                 :"gpt-image-1.5",
                 OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
               )
+            CHATGPT_IMAGE_LATEST =
+              T.let(
+                :"chatgpt-image-latest",
+                OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+              )
           end
 
           # Moderation level for the generated image. Default: `auto`.
@@ -1514,10 +1592,37 @@ module OpenAI
             end
           end
 
-          # The size of the generated image. One of `1024x1024`, `1024x1536`, `1536x1024`,
-          # or `auto`. Default: `auto`.
+          # 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::Responses::Tool::ImageGeneration::Size::TaggedSymbol
+                )
+              end
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::Tool::ImageGeneration::Size::Variants
+                ]
+              )
+            end
+            def self.variants
+            end
 
             TaggedSymbol =
               T.type_alias do
@@ -1545,16 +1650,6 @@ module OpenAI
                 :auto,
                 OpenAI::Responses::Tool::ImageGeneration::Size::TaggedSymbol
               )
-
-            sig do
-              override.returns(
-                T::Array[
-                  OpenAI::Responses::Tool::ImageGeneration::Size::TaggedSymbol
-                ]
-              )
-            end
-            def self.values
-            end
           end
         end
 

data/rbi/openai/resources/chat/completions.rbi

@@ -320,8 +320,9 @@ module OpenAI
           # [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
           # or [function tools](https://platform.openai.com/docs/guides/function-calling).
           tools: nil,
-          # An integer between 0 and 20 specifying the number of most likely tokens to
-          # return at each token position, each with an associated log probability.
+          # An integer between 0 and 20 specifying the maximum number of most likely tokens
+          # to return at each token position, each with an associated log probability. In
+          # some cases, the number of returned tokens may be fewer than requested.
           # `logprobs` must be set to `true` if this parameter is used.
           top_logprobs: nil,
           # An alternative to sampling with temperature, called nucleus sampling, where the
@@ -658,8 +659,9 @@ module OpenAI
           # [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
           # or [function tools](https://platform.openai.com/docs/guides/function-calling).
           tools: nil,
-          # An integer between 0 and 20 specifying the number of most likely tokens to
-          # return at each token position, each with an associated log probability.
+          # An integer between 0 and 20 specifying the maximum number of most likely tokens
+          # to return at each token position, each with an associated log probability. In
+          # some cases, the number of returned tokens may be fewer than requested.
           # `logprobs` must be set to `true` if this parameter is used.
           top_logprobs: nil,
           # An alternative to sampling with temperature, called nucleus sampling, where the

data/rbi/openai/resources/images.rbi

@@ -65,7 +65,8 @@ module OpenAI
           quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
           response_format:
             T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
-          size: T.nilable(OpenAI::ImageEditParams::Size::OrSymbol),
+          size:
+            T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol)),
           user: String,
           stream: T.noreturn,
           request_options: OpenAI::RequestOptions::OrHash
@@ -74,10 +75,10 @@ module OpenAI
       def edit(
         # The image(s) to edit. Must be a supported image file or an array of images.
         #
-        # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, and
-        # `gpt-image-1.5`), each image should be a `png`, `webp`, or `jpg` file less than
-        # 50MB. You can provide up to 16 images. `chatgpt-image-latest` follows the same
-        # input constraints as GPT image models.
+        # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
+        # `gpt-image-2`, `gpt-image-2-2026-04-21`, and `chatgpt-image-latest`), each image
+        # should be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to
+        # 16 images.
         #
         # For `dall-e-2`, you can only provide one image, and it should be a square `png`
         # file less than 4MB.
@@ -86,9 +87,14 @@ module OpenAI
         # characters for `dall-e-2`, and 32000 characters for the GPT image models.
         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`.
@@ -103,7 +109,10 @@ module OpenAI
         # the mask will be applied on the first image. Must be a valid PNG file, less than
         # 4MB, and have the same dimensions as `image`.
         mask: nil,
-        # The model to use for image generation. Defaults to `gpt-image-1.5`.
+        # The model to use for image generation. One of `dall-e-2` or a GPT image model
+        # (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+        # `gpt-image-2-2026-04-21`, or `chatgpt-image-latest`). Defaults to
+        # `gpt-image-1.5`.
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
         n: nil,
@@ -130,9 +139,17 @@ module OpenAI
         # generated. This parameter is only supported for `dall-e-2` (default is `url` for
         # `dall-e-2`), as GPT image models 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, and one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`.
+        # 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,
         # A unique identifier representing your end-user, which can help OpenAI to monitor
         # and detect abuse.
@@ -167,7 +184,8 @@ module OpenAI
           quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
           response_format:
             T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
-          size: T.nilable(OpenAI::ImageEditParams::Size::OrSymbol),
+          size:
+            T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol)),
           user: String,
           stream: T.noreturn,
           request_options: OpenAI::RequestOptions::OrHash
@@ -178,10 +196,10 @@ module OpenAI
       def edit_stream_raw(
         # The image(s) to edit. Must be a supported image file or an array of images.
         #
-        # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, and
-        # `gpt-image-1.5`), each image should be a `png`, `webp`, or `jpg` file less than
-        # 50MB. You can provide up to 16 images. `chatgpt-image-latest` follows the same
-        # input constraints as GPT image models.
+        # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
+        # `gpt-image-2`, `gpt-image-2-2026-04-21`, and `chatgpt-image-latest`), each image
+        # should be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to
+        # 16 images.
         #
         # For `dall-e-2`, you can only provide one image, and it should be a square `png`
         # file less than 4MB.
@@ -190,9 +208,14 @@ module OpenAI
         # characters for `dall-e-2`, and 32000 characters for the GPT image models.
         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`.
@@ -207,7 +230,10 @@ module OpenAI
         # the mask will be applied on the first image. Must be a valid PNG file, less than
         # 4MB, and have the same dimensions as `image`.
         mask: nil,
-        # The model to use for image generation. Defaults to `gpt-image-1.5`.
+        # The model to use for image generation. One of `dall-e-2` or a GPT image model
+        # (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+        # `gpt-image-2-2026-04-21`, or `chatgpt-image-latest`). Defaults to
+        # `gpt-image-1.5`.
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
         n: nil,
@@ -234,9 +260,17 @@ module OpenAI
         # generated. This parameter is only supported for `dall-e-2` (default is `url` for
         # `dall-e-2`), as GPT image models 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, and one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`.
+        # 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,
         # A unique identifier representing your end-user, which can help OpenAI to monitor
         # and detect abuse.
@@ -269,7 +303,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,
           stream: T.noreturn,
@@ -282,16 +319,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
@@ -327,10 +370,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
@@ -368,7 +418,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,
           stream: T.noreturn,
@@ -383,16 +436,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
@@ -428,10 +487,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

data/rbi/openai/resources/realtime/calls.rbi

@@ -25,7 +25,9 @@ module OpenAI
               T::Array[
                 OpenAI::Realtime::RealtimeSessionCreateRequest::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,
@@ -90,9 +92,14 @@ module OpenAI
           # can be used to make the model respond with text only. It is not possible to
           # request both `text` and `audio` at the same time.
           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,

data/rbi/openai/resources/responses.rbi

@@ -275,8 +275,9 @@ module OpenAI
         #   [function calling](https://platform.openai.com/docs/guides/function-calling).
         #   You can also use custom tools to call your own code.
         tools: nil,
-        # An integer between 0 and 20 specifying the number of most likely tokens to
-        # return at each token position, each with an associated log probability.
+        # An integer between 0 and 20 specifying the maximum number of most likely tokens
+        # to return at each token position, each with an associated log probability. In
+        # some cases, the number of returned tokens may be fewer than requested.
         top_logprobs: nil,
         # An alternative to sampling with temperature, called nucleus sampling, where the
         # model considers the results of the tokens with top_p probability mass. So 0.1
@@ -577,8 +578,9 @@ module OpenAI
         #   [function calling](https://platform.openai.com/docs/guides/function-calling).
         #   You can also use custom tools to call your own code.
         tools: nil,
-        # An integer between 0 and 20 specifying the number of most likely tokens to
-        # return at each token position, each with an associated log probability.
+        # An integer between 0 and 20 specifying the maximum number of most likely tokens
+        # to return at each token position, each with an associated log probability. In
+        # some cases, the number of returned tokens may be fewer than requested.
         top_logprobs: nil,
         # An alternative to sampling with temperature, called nucleus sampling, where the
         # model considers the results of the tokens with top_p probability mass. So 0.1
@@ -992,6 +994,10 @@ module OpenAI
             T.nilable(
               OpenAI::Responses::ResponseCompactParams::PromptCacheRetention::OrSymbol
             ),
+          service_tier:
+            T.nilable(
+              OpenAI::Responses::ResponseCompactParams::ServiceTier::OrSymbol
+            ),
           request_options: OpenAI::RequestOptions::OrHash
         ).returns(OpenAI::Responses::CompactedResponse)
       end
@@ -1018,6 +1024,8 @@ module OpenAI
         prompt_cache_key: nil,
         # How long to retain a prompt cache entry created by this request.
         prompt_cache_retention: nil,
+        # The service tier to use for this request.
+        service_tier: nil,
         request_options: {}
       )
       end

data/sig/openai/models/admin/organization/usage_audio_speeches_response.rbs

@@ -466,7 +466,8 @@ module OpenAI
                   amount: OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::Amount,
                   api_key_id: String?,
                   line_item: String?,
-                  project_id: String?
+                  project_id: String?,
+                  quantity: Float?
                 }
 
               class OrganizationCostsResult < OpenAI::Internal::Type::BaseModel
@@ -484,11 +485,14 @@ module OpenAI
 
                 attr_accessor project_id: String?
 
+                attr_accessor quantity: Float?
+
                 def initialize: (
                   ?amount: OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::Amount,
                   ?api_key_id: String?,
                   ?line_item: String?,
                   ?project_id: String?,
+                  ?quantity: Float?,
                   ?object: :"organization.costs.result"
                 ) -> void
 
@@ -497,7 +501,8 @@ module OpenAI
                   amount: OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::Amount,
                   api_key_id: String?,
                   line_item: String?,
-                  project_id: String?
+                  project_id: String?,
+                  quantity: Float?
                 }
 
                 type amount = { currency: String, value: Float }