openai 0.85.0 → 0.87.0

data/rbi/openai/models/beta/beta_tool.rbi

@@ -953,9 +953,11 @@ module OpenAI
           # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
           # the model will automatically determine the best background for the image.
           #
-          # Transparent backgrounds are available for supported GPT Image models. For
-          # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-          # using `transparent`, set the output format to `png` or `webp`.
+          # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+          # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+          # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+          # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+          # set the output format to `png` or `webp`.
           sig { returns(T.nilable(OpenAI::Beta::BetaTool::ImageGeneration::Background::OrSymbol)) }
           attr_reader :background
 
@@ -978,7 +980,9 @@ module OpenAI
           attr_writer :input_image_mask
 
           # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+          # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
           # `chatgpt-image-latest`. Default: `gpt-image-1`.
           sig { returns(T.nilable(T.any(String, OpenAI::Beta::BetaTool::ImageGeneration::Model::OrSymbol))) }
           attr_reader :model
@@ -1016,25 +1020,28 @@ module OpenAI
           sig { params(partial_images: Integer).void }
           attr_writer :partial_images
 
-          # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-          # Default: `auto`.
+          # The quality of the generated image. The GPT image models support `low`,
+          # `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+          # including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+          # `auto`.
           sig { returns(T.nilable(OpenAI::Beta::BetaTool::ImageGeneration::Quality::OrSymbol)) }
           attr_reader :quality
 
           sig { params(quality: OpenAI::Beta::BetaTool::ImageGeneration::Quality::OrSymbol).void }
           attr_writer :quality
 
-          # 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`.
+          # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+          # `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, 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 { returns(T.nilable(T.any(String, OpenAI::Beta::BetaTool::ImageGeneration::Size::OrSymbol))) }
           attr_reader :size
 
@@ -1080,9 +1087,11 @@ module OpenAI
             # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
             # the model will automatically determine the best background for the image.
             #
-            # Transparent backgrounds are available for supported GPT Image models. For
-            # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-            # using `transparent`, set the output format to `png` or `webp`.
+            # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+            # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+            # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+            # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+            # set the output format to `png` or `webp`.
             background: nil,
 
             # Control how much effort the model will exert to match the style and features,
@@ -1096,7 +1105,9 @@ module OpenAI
             input_image_mask: nil,
 
             # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-            # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+            # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+            # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+            # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
             # `chatgpt-image-latest`. Default: `gpt-image-1`.
             model: nil,
 
@@ -1114,21 +1125,24 @@ module OpenAI
             # to 3.
             partial_images: nil,
 
-            # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-            # Default: `auto`.
+            # The quality of the generated image. The GPT image models support `low`,
+            # `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+            # including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+            # `auto`.
             quality: nil,
 
-            # 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`.
+            # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+            # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+            # `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, 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`.
@@ -1178,9 +1192,11 @@ module OpenAI
           # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
           # the model will automatically determine the best background for the image.
           #
-          # Transparent backgrounds are available for supported GPT Image models. For
-          # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-          # using `transparent`, set the output format to `png` or `webp`.
+          # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+          # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+          # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+          # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+          # set the output format to `png` or `webp`.
           module Background
             extend OpenAI::Internal::Type::Enum
 
@@ -1269,7 +1285,9 @@ module OpenAI
           end
 
           # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+          # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
           # `chatgpt-image-latest`. Default: `gpt-image-1`.
           module Model
             extend OpenAI::Internal::Type::Union
@@ -1293,6 +1311,22 @@ module OpenAI
               :"gpt-image-2-2026-04-21",
               OpenAI::Beta::BetaTool::ImageGeneration::Model::TaggedSymbol
             )
+            GPT_IMAGE_2_5_SUNBURST = T.let(
+              :"gpt-image-2.5-sunburst",
+              OpenAI::Beta::BetaTool::ImageGeneration::Model::TaggedSymbol
+            )
+            GPT_IMAGE_2_5_SUNBURST_2026_09_08 = T.let(
+              :"gpt-image-2.5-sunburst-2026-09-08",
+              OpenAI::Beta::BetaTool::ImageGeneration::Model::TaggedSymbol
+            )
+            GPT_IMAGE_2_5_FLARE = T.let(
+              :"gpt-image-2.5-flare",
+              OpenAI::Beta::BetaTool::ImageGeneration::Model::TaggedSymbol
+            )
+            GPT_IMAGE_2_5_FLARE_2026_09_08 = T.let(
+              :"gpt-image-2.5-flare-2026-09-08",
+              OpenAI::Beta::BetaTool::ImageGeneration::Model::TaggedSymbol
+            )
             GPT_IMAGE_1_5 = T.let(:"gpt-image-1.5", OpenAI::Beta::BetaTool::ImageGeneration::Model::TaggedSymbol)
             CHATGPT_IMAGE_LATEST = T.let(
               :"chatgpt-image-latest",
@@ -1333,8 +1367,10 @@ module OpenAI
             end
           end
 
-          # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-          # Default: `auto`.
+          # The quality of the generated image. The GPT image models support `low`,
+          # `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+          # including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+          # `auto`.
           module Quality
             extend OpenAI::Internal::Type::Enum
 
@@ -1344,6 +1380,8 @@ module OpenAI
             LOW = T.let(:low, OpenAI::Beta::BetaTool::ImageGeneration::Quality::TaggedSymbol)
             MEDIUM = T.let(:medium, OpenAI::Beta::BetaTool::ImageGeneration::Quality::TaggedSymbol)
             HIGH = T.let(:high, OpenAI::Beta::BetaTool::ImageGeneration::Quality::TaggedSymbol)
+            XHIGH = T.let(:xhigh, OpenAI::Beta::BetaTool::ImageGeneration::Quality::TaggedSymbol)
+            MAX = T.let(:max, OpenAI::Beta::BetaTool::ImageGeneration::Quality::TaggedSymbol)
             AUTO = T.let(:auto, OpenAI::Beta::BetaTool::ImageGeneration::Quality::TaggedSymbol)
 
             sig { override.returns(T::Array[OpenAI::Beta::BetaTool::ImageGeneration::Quality::TaggedSymbol]) }
@@ -1351,17 +1389,18 @@ module OpenAI
             end
           end
 
-          # 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`.
+          # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+          # `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, 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::Union
 

data/rbi/openai/models/beta/response_compact_params.rbi

@@ -77,12 +77,13 @@ module OpenAI
         # request will be processed with the Flex Processing service tier. - To opt-in to
         # [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
         # `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-        # Completions. The response will show `service_tier=priority` regardless of if you
-        # specify `service_tier=fast` or `priority` in your request. - When not set, the
-        # default behavior is 'auto'. When the `service_tier` parameter is set, the
-        # response body will include the `service_tier` value based on the processing mode
-        # actually used to serve the request. This response value may be different from
-        # the value set in the parameter.
+        # Completions. For models with a dedicated Fast tier, either value resolves to
+        # `service_tier=fast`; for other models, either value resolves to
+        # `service_tier=priority`. - When not set, the default behavior is 'auto'. When
+        # the `service_tier` parameter is set, the response body will include the
+        # `service_tier` value based on the processing mode actually used to serve the
+        # request. This response value may be different from the value set in the
+        # parameter.
         sig { returns(T.nilable(OpenAI::Beta::ResponseCompactParams::ServiceTier::OrSymbol)) }
         attr_accessor :service_tier
 
@@ -167,12 +168,13 @@ module OpenAI
           # request will be processed with the Flex Processing service tier. - To opt-in to
           # [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
           # `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-          # Completions. The response will show `service_tier=priority` regardless of if you
-          # specify `service_tier=fast` or `priority` in your request. - When not set, the
-          # default behavior is 'auto'. When the `service_tier` parameter is set, the
-          # response body will include the `service_tier` value based on the processing mode
-          # actually used to serve the request. This response value may be different from
-          # the value set in the parameter.
+          # Completions. For models with a dedicated Fast tier, either value resolves to
+          # `service_tier=fast`; for other models, either value resolves to
+          # `service_tier=priority`. - When not set, the default behavior is 'auto'. When
+          # the `service_tier` parameter is set, the response body will include the
+          # `service_tier` value based on the processing mode actually used to serve the
+          # request. This response value may be different from the value set in the
+          # parameter.
           service_tier: nil,
 
           betas: nil,
@@ -582,12 +584,13 @@ module OpenAI
         # request will be processed with the Flex Processing service tier. - To opt-in to
         # [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
         # `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-        # Completions. The response will show `service_tier=priority` regardless of if you
-        # specify `service_tier=fast` or `priority` in your request. - When not set, the
-        # default behavior is 'auto'. When the `service_tier` parameter is set, the
-        # response body will include the `service_tier` value based on the processing mode
-        # actually used to serve the request. This response value may be different from
-        # the value set in the parameter.
+        # Completions. For models with a dedicated Fast tier, either value resolves to
+        # `service_tier=fast`; for other models, either value resolves to
+        # `service_tier=priority`. - When not set, the default behavior is 'auto'. When
+        # the `service_tier` parameter is set, the response body will include the
+        # `service_tier` value based on the processing mode actually used to serve the
+        # request. This response value may be different from the value set in the
+        # parameter.
         module ServiceTier
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/beta/response_create_params.rbi

@@ -229,6 +229,9 @@ module OpenAI
         attr_accessor :service_tier
 
         # Whether to store the generated model response for later retrieval via API.
+        # Defaults to true when omitted. If set to true, response data will be stored for
+        # at least 30 days, subject to the
+        # [data retention exceptions](/api/docs/guides/your-data#v1responses).
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :store
 
@@ -684,6 +687,9 @@ module OpenAI
           service_tier: nil,
 
           # Whether to store the generated model response for later retrieval via API.
+          # Defaults to true when omitted. If set to true, response data will be stored for
+          # at least 30 days, subject to the
+          # [data retention exceptions](/api/docs/guides/your-data#v1responses).
           store: nil,
 
           # Options for streaming responses. Only set this when you set `stream: true`.
@@ -1413,6 +1419,11 @@ module OpenAI
             )
           end
 
+          # The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+          # this field requests prompt cache diagnostics when the feature is enabled.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :comparison_response_id
+
           # Controls whether OpenAI automatically creates an implicit cache breakpoint.
           # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
           # and writes up to the latest three explicit breakpoints in the request. With
@@ -1446,6 +1457,8 @@ module OpenAI
           sig do
             params(
 
+              comparison_response_id: T.nilable(String),
+
               mode: OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Mode::OrSymbol,
 
               ttl: OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl::OrSymbol
@@ -1454,6 +1467,10 @@ module OpenAI
           end
           def self.new(
 
+            # The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+            # this field requests prompt cache diagnostics when the feature is enabled.
+            comparison_response_id: nil,
+
             # Controls whether OpenAI automatically creates an implicit cache breakpoint.
             # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
             # and writes up to the latest three explicit breakpoints in the request. With
@@ -1473,6 +1490,7 @@ module OpenAI
           sig do
             override.returns(
               {
+                comparison_response_id: T.nilable(String),
                 mode: OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Mode::OrSymbol,
                 ttl: OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl::OrSymbol
               }

data/rbi/openai/models/conversations/conversation_item.rbi

@@ -71,6 +71,17 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :type
 
+          # The quality of the image generated by the image generation tool call. One of
+          # `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+          sig {
+            returns(T.nilable(OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::TaggedSymbol))
+          }
+          attr_accessor :quality
+
+          # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          sig { returns(T.nilable(OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::Variants)) }
+          attr_accessor :size
+
           # An image generation request made by the model.
           sig do
             params(
@@ -81,6 +92,12 @@ module OpenAI
 
               status: OpenAI::Conversations::ConversationItem::ImageGenerationCall::Status::OrSymbol,
 
+              quality: T.nilable(OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::OrSymbol),
+
+              size: T.nilable(
+                T.any(String, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::OrSymbol)
+              ),
+
               type: Symbol
             )
               .returns(T.attached_class)
@@ -96,6 +113,13 @@ module OpenAI
             # The status of the image generation call.
             status:,
 
+            # The quality of the image generated by the image generation tool call. One of
+            # `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+            quality: nil,
+
+            # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+            size: nil,
+
             # The type of the image generation call. Always `image_generation_call`.
 
             type: :image_generation_call
@@ -108,7 +132,9 @@ module OpenAI
                 id: String,
                 result: T.nilable(String),
                 status: OpenAI::Conversations::ConversationItem::ImageGenerationCall::Status::TaggedSymbol,
-                type: Symbol
+                type: Symbol,
+                quality: T.nilable(OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::TaggedSymbol),
+                size: T.nilable(OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::Variants)
               }
             )
           end
@@ -146,6 +172,67 @@ module OpenAI
             def self.values
             end
           end
+
+          # The quality of the image generated by the image generation tool call. One of
+          # `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+          module Quality
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias {
+              T.all(Symbol, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            LOW = T.let(:low, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::TaggedSymbol)
+            MEDIUM = T.let(:medium, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::TaggedSymbol)
+            HIGH = T.let(:high, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::TaggedSymbol)
+            XHIGH = T.let(:xhigh, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::TaggedSymbol)
+            MAX = T.let(:max, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::TaggedSymbol)
+            AUTO = T.let(:auto, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::TaggedSymbol)
+
+            sig {
+              override.returns(
+                T::Array[OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::TaggedSymbol]
+              )
+            }
+            def self.values
+            end
+          end
+
+          # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          module Size
+            extend OpenAI::Internal::Type::Union
+
+            Variants = T.type_alias {
+              T.any(String, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::TaggedSymbol)
+            }
+
+            sig {
+              override.returns(T::Array[OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::Variants])
+            }
+            def self.variants
+            end
+
+            TaggedSymbol = T.type_alias do
+              T.all(Symbol, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size)
+            end
+
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            SIZE_1024X1024 = T.let(
+              :"1024x1024",
+              OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::TaggedSymbol
+            )
+            SIZE_1024X1536 = T.let(
+              :"1024x1536",
+              OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::TaggedSymbol
+            )
+            SIZE_1536X1024 = T.let(
+              :"1536x1024",
+              OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::TaggedSymbol
+            )
+
+          end
         end
 
         class AdditionalTools < OpenAI::Internal::Type::BaseModel

data/rbi/openai/models/image_edit_completed_event.rbi

@@ -32,8 +32,8 @@ module OpenAI
       sig { returns(OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol) }
       attr_accessor :quality
 
-      # The size of the edited image.
-      sig { returns(OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol) }
+      # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+      sig { returns(OpenAI::ImageEditCompletedEvent::Size::Variants) }
       attr_accessor :size
 
       # The type of the event. Always `image_edit.completed`.
@@ -62,7 +62,7 @@ module OpenAI
 
           quality: OpenAI::ImageEditCompletedEvent::Quality::OrSymbol,
 
-          size: OpenAI::ImageEditCompletedEvent::Size::OrSymbol,
+          size: T.any(String, OpenAI::ImageEditCompletedEvent::Size::OrSymbol),
 
           usage: OpenAI::ImageEditCompletedEvent::Usage::OrHash,
 
@@ -87,7 +87,7 @@ module OpenAI
         # The quality setting for the edited image.
         quality:,
 
-        # The size of the edited image.
+        # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
         size:,
 
         # For the GPT image models only, the token usage information for the image
@@ -108,7 +108,7 @@ module OpenAI
             created_at: Integer,
             output_format: OpenAI::ImageEditCompletedEvent::OutputFormat::TaggedSymbol,
             quality: OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol,
-            size: OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol,
+            size: OpenAI::ImageEditCompletedEvent::Size::Variants,
             type: Symbol,
             usage: OpenAI::ImageEditCompletedEvent::Usage
           }
@@ -159,6 +159,8 @@ module OpenAI
         LOW = T.let(:low, OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol)
         MEDIUM = T.let(:medium, OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol)
         HIGH = T.let(:high, OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol)
+        XHIGH = T.let(:xhigh, OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol)
+        MAX = T.let(:max, OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol)
         AUTO = T.let(:auto, OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol)
 
         sig { override.returns(T::Array[OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol]) }
@@ -166,11 +168,20 @@ module OpenAI
         end
       end
 
-      # The size of the edited image.
+      # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       module Size
-        extend OpenAI::Internal::Type::Enum
+        extend OpenAI::Internal::Type::Union
+
+        Variants = T.type_alias { T.any(String, OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol) }
+
+        sig { override.returns(T::Array[OpenAI::ImageEditCompletedEvent::Size::Variants]) }
+        def self.variants
+        end
+
+        TaggedSymbol = T.type_alias do
+          T.all(Symbol, OpenAI::ImageEditCompletedEvent::Size)
+        end
 
-        TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::ImageEditCompletedEvent::Size) }
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         SIZE_1024X1024 = T.let(:"1024x1024", OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol)
@@ -178,7 +189,7 @@ module OpenAI
         SIZE_1536X1024 = T.let(:"1536x1024", OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol)
         AUTO = T.let(:auto, OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol)
 
-        sig { override.returns(T::Array[OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol]) }
+        sig { returns(T::Array[OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol]) }
         def self.values
         end
       end