openai 0.85.0 → 0.87.0

data/lib/openai/models/image_edit_completed_event.rb

@@ -34,10 +34,10 @@ module OpenAI
       required :quality, enum: -> { OpenAI::ImageEditCompletedEvent::Quality }
 
       # @!attribute size
-      #   The size of the edited image.
+      #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
-      #   @return [Symbol, OpenAI::Models::ImageEditCompletedEvent::Size]
-      required :size, enum: -> { OpenAI::ImageEditCompletedEvent::Size }
+      #   @return [String, Symbol, OpenAI::Models::ImageEditCompletedEvent::Size]
+      required :size, union: -> { OpenAI::ImageEditCompletedEvent::Size }
 
       # @!attribute type
       #   The type of the event. Always `image_edit.completed`.
@@ -68,7 +68,7 @@ module OpenAI
       #
       #   @param quality [Symbol, OpenAI::Models::ImageEditCompletedEvent::Quality] The quality setting for the edited image.
       #
-      #   @param size [Symbol, OpenAI::Models::ImageEditCompletedEvent::Size] The size of the edited image.
+      #   @param size [String, Symbol, OpenAI::Models::ImageEditCompletedEvent::Size] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       #   @param usage [OpenAI::Models::ImageEditCompletedEvent::Usage] For the GPT image models only, the token usage information for the image generat
       #
@@ -111,25 +111,51 @@ module OpenAI
         LOW = :low
         MEDIUM = :medium
         HIGH = :high
+        XHIGH = :xhigh
+        MAX = :max
         AUTO = :auto
 
         # @!method self.values
         #   @return [Array<Symbol>]
       end
 
-      # The size of the edited image.
+      # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       # @see OpenAI::Models::ImageEditCompletedEvent#size
       module Size
-        extend OpenAI::Internal::Type::Enum
+        extend OpenAI::Internal::Type::Union
+
+        variant const: -> { OpenAI::Models::ImageEditCompletedEvent::Size::SIZE_1024X1024 }
+
+        variant const: -> { OpenAI::Models::ImageEditCompletedEvent::Size::SIZE_1024X1536 }
+
+        variant const: -> { OpenAI::Models::ImageEditCompletedEvent::Size::SIZE_1536X1024 }
+
+        variant const: -> { OpenAI::Models::ImageEditCompletedEvent::Size::AUTO }
+
+        # Keep known dimensions as symbols when reading existing API responses.
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(String, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(String, OpenAI::ImageEditCompletedEvent::Size::TaggedSymbol) }
+        end
+
+        # @!group
 
         SIZE_1024X1024 = :"1024x1024"
         SIZE_1024X1536 = :"1024x1536"
         SIZE_1536X1024 = :"1536x1024"
         AUTO = :auto
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+        # @!endgroup
+
+        # Preserve the enum helper available before custom dimensions were supported.
+        #
+        # @return [Array<Symbol>]
+        def self.values = [SIZE_1024X1024, SIZE_1024X1536, SIZE_1536X1024, AUTO]
       end
 
       # @see OpenAI::Models::ImageEditCompletedEvent#usage

data/lib/openai/models/image_edit_params.rb

@@ -13,9 +13,11 @@ module OpenAI
       #   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`, `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.
+      #   `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`, 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.
@@ -39,9 +41,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`.
       #
       #   @return [Symbol, OpenAI::Models::ImageEditParams::Background, nil]
       optional :background, enum: -> { OpenAI::ImageEditParams::Background }, nil?: true
@@ -71,7 +75,9 @@ module OpenAI
       # @!attribute model
       #   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-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`). Defaults to
       #   `gpt-image-1.5`.
       #
       #   @return [String, Symbol, OpenAI::Models::ImageModel, nil]
@@ -111,8 +117,10 @@ module OpenAI
       optional :partial_images, Integer, nil?: true
 
       # @!attribute quality
-      #   The quality of the image that will be generated for GPT image models. Defaults
-      #   to `auto`.
+      #   The quality of the image that will be generated for GPT image models. 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`. Defaults to `auto`.
       #
       #   @return [Symbol, OpenAI::Models::ImageEditParams::Quality, nil]
       optional :quality, enum: -> { OpenAI::ImageEditParams::Quality }, nil?: true
@@ -127,17 +135,18 @@ module OpenAI
       optional :response_format, enum: -> { OpenAI::ImageEditParams::ResponseFormat }, nil?: true
 
       # @!attribute size
-      #   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`.
       #
       #   @return [String, Symbol, OpenAI::Models::ImageEditParams::Size, nil]
       optional :size, union: -> { OpenAI::ImageEditParams::Size }, nil?: true
@@ -158,7 +167,7 @@ module OpenAI
       #
       #   @param prompt [String] A text description of the desired image(s). The maximum length is 1000 character
       #
-      #   @param background [Symbol, OpenAI::Models::ImageEditParams::Background, nil] Allows to set transparency for the background of the generated image(s).
+      #   @param background [Symbol, OpenAI::Models::ImageEditParams::Background, nil] Allows to set transparency for the background of the generated image(s). Must
       #
       #   @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil] Control how much effort the model will exert to match the style and features, es
       #
@@ -174,11 +183,11 @@ module OpenAI
       #
       #   @param partial_images [Integer, nil] The number of partial images to generate. This parameter is used for
       #
-      #   @param quality [Symbol, OpenAI::Models::ImageEditParams::Quality, nil] The quality of the image that will be generated for GPT image models. Defaults t
+      #   @param quality [Symbol, OpenAI::Models::ImageEditParams::Quality, nil] The quality of the image that will be generated for GPT image models. The GPT im
       #
       #   @param response_format [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil] The format in which the generated images are returned. Must be one of `url` or `
       #
-      #   @param size [String, Symbol, OpenAI::Models::ImageEditParams::Size, nil] The size of the generated images. For `gpt-image-2` and `gpt-image-2-2026-04-21`
+      #   @param size [String, Symbol, OpenAI::Models::ImageEditParams::Size, nil] The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`, `
       #
       #   @param user [String] A unique identifier representing your end-user, which can help OpenAI to monitor
       #
@@ -187,9 +196,11 @@ module OpenAI
       # 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`, `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.
+      # `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`, 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.
@@ -211,9 +222,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
 
@@ -241,14 +254,16 @@ module OpenAI
 
       # 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-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`). Defaults to
       # `gpt-image-1.5`.
       module Model
         extend OpenAI::Internal::Type::Union
 
         variant String
 
-        # 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`.
+        # 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`, `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`). Defaults to `gpt-image-1.5`.
         variant enum: -> { OpenAI::ImageModel }
 
         # @!method self.variants
@@ -269,8 +284,10 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # The quality of the image that will be generated for GPT image models. Defaults
-      # to `auto`.
+      # The quality of the image that will be generated for GPT image models. 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`. Defaults to `auto`.
       module Quality
         extend OpenAI::Internal::Type::Enum
 
@@ -278,6 +295,8 @@ module OpenAI
         LOW = :low
         MEDIUM = :medium
         HIGH = :high
+        XHIGH = :xhigh
+        MAX = :max
         AUTO = :auto
 
         # @!method self.values
@@ -298,17 +317,18 @@ module OpenAI
         #   @return [Array<Symbol>]
       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/lib/openai/models/image_edit_partial_image_event.rb

@@ -40,10 +40,10 @@ module OpenAI
       required :quality, enum: -> { OpenAI::ImageEditPartialImageEvent::Quality }
 
       # @!attribute size
-      #   The size of the requested edited image.
+      #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
-      #   @return [Symbol, OpenAI::Models::ImageEditPartialImageEvent::Size]
-      required :size, enum: -> { OpenAI::ImageEditPartialImageEvent::Size }
+      #   @return [String, Symbol, OpenAI::Models::ImageEditPartialImageEvent::Size]
+      required :size, union: -> { OpenAI::ImageEditPartialImageEvent::Size }
 
       # @!attribute type
       #   The type of the event. Always `image_edit.partial_image`.
@@ -69,7 +69,7 @@ module OpenAI
       #
       #   @param quality [Symbol, OpenAI::Models::ImageEditPartialImageEvent::Quality] The quality setting for the requested edited image.
       #
-      #   @param size [Symbol, OpenAI::Models::ImageEditPartialImageEvent::Size] The size of the requested edited image.
+      #   @param size [String, Symbol, OpenAI::Models::ImageEditPartialImageEvent::Size] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       #   @param type [Symbol, :"image_edit.partial_image"] The type of the event. Always `image_edit.partial_image`.
 
@@ -110,25 +110,51 @@ module OpenAI
         LOW = :low
         MEDIUM = :medium
         HIGH = :high
+        XHIGH = :xhigh
+        MAX = :max
         AUTO = :auto
 
         # @!method self.values
         #   @return [Array<Symbol>]
       end
 
-      # The size of the requested edited image.
+      # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       # @see OpenAI::Models::ImageEditPartialImageEvent#size
       module Size
-        extend OpenAI::Internal::Type::Enum
+        extend OpenAI::Internal::Type::Union
+
+        variant const: -> { OpenAI::Models::ImageEditPartialImageEvent::Size::SIZE_1024X1024 }
+
+        variant const: -> { OpenAI::Models::ImageEditPartialImageEvent::Size::SIZE_1024X1536 }
+
+        variant const: -> { OpenAI::Models::ImageEditPartialImageEvent::Size::SIZE_1536X1024 }
+
+        variant const: -> { OpenAI::Models::ImageEditPartialImageEvent::Size::AUTO }
+
+        # Keep known dimensions as symbols when reading existing API responses.
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(String, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(String, OpenAI::ImageEditPartialImageEvent::Size::TaggedSymbol) }
+        end
+
+        # @!group
 
         SIZE_1024X1024 = :"1024x1024"
         SIZE_1024X1536 = :"1024x1536"
         SIZE_1536X1024 = :"1536x1024"
         AUTO = :auto
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+        # @!endgroup
+
+        # Preserve the enum helper available before custom dimensions were supported.
+        #
+        # @return [Array<Symbol>]
+        def self.values = [SIZE_1024X1024, SIZE_1024X1536, SIZE_1536X1024, AUTO]
       end
     end
   end

data/lib/openai/models/image_gen_completed_event.rb

@@ -34,10 +34,10 @@ module OpenAI
       required :quality, enum: -> { OpenAI::ImageGenCompletedEvent::Quality }
 
       # @!attribute size
-      #   The size of the generated image.
+      #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
-      #   @return [Symbol, OpenAI::Models::ImageGenCompletedEvent::Size]
-      required :size, enum: -> { OpenAI::ImageGenCompletedEvent::Size }
+      #   @return [String, Symbol, OpenAI::Models::ImageGenCompletedEvent::Size]
+      required :size, union: -> { OpenAI::ImageGenCompletedEvent::Size }
 
       # @!attribute type
       #   The type of the event. Always `image_generation.completed`.
@@ -68,7 +68,7 @@ module OpenAI
       #
       #   @param quality [Symbol, OpenAI::Models::ImageGenCompletedEvent::Quality] The quality setting for the generated image.
       #
-      #   @param size [Symbol, OpenAI::Models::ImageGenCompletedEvent::Size] The size of the generated image.
+      #   @param size [String, Symbol, OpenAI::Models::ImageGenCompletedEvent::Size] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       #   @param usage [OpenAI::Models::ImageGenCompletedEvent::Usage] For the GPT image models only, the token usage information for the image generat
       #
@@ -111,25 +111,51 @@ module OpenAI
         LOW = :low
         MEDIUM = :medium
         HIGH = :high
+        XHIGH = :xhigh
+        MAX = :max
         AUTO = :auto
 
         # @!method self.values
         #   @return [Array<Symbol>]
       end
 
-      # The size of the generated image.
+      # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       # @see OpenAI::Models::ImageGenCompletedEvent#size
       module Size
-        extend OpenAI::Internal::Type::Enum
+        extend OpenAI::Internal::Type::Union
+
+        variant const: -> { OpenAI::Models::ImageGenCompletedEvent::Size::SIZE_1024X1024 }
+
+        variant const: -> { OpenAI::Models::ImageGenCompletedEvent::Size::SIZE_1024X1536 }
+
+        variant const: -> { OpenAI::Models::ImageGenCompletedEvent::Size::SIZE_1536X1024 }
+
+        variant const: -> { OpenAI::Models::ImageGenCompletedEvent::Size::AUTO }
+
+        # Keep known dimensions as symbols when reading existing API responses.
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(String, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(String, OpenAI::ImageGenCompletedEvent::Size::TaggedSymbol) }
+        end
+
+        # @!group
 
         SIZE_1024X1024 = :"1024x1024"
         SIZE_1024X1536 = :"1024x1536"
         SIZE_1536X1024 = :"1536x1024"
         AUTO = :auto
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+        # @!endgroup
+
+        # Preserve the enum helper available before custom dimensions were supported.
+        #
+        # @return [Array<Symbol>]
+        def self.values = [SIZE_1024X1024, SIZE_1024X1536, SIZE_1536X1024, AUTO]
       end
 
       # @see OpenAI::Models::ImageGenCompletedEvent#usage

data/lib/openai/models/image_gen_partial_image_event.rb

@@ -40,10 +40,10 @@ module OpenAI
       required :quality, enum: -> { OpenAI::ImageGenPartialImageEvent::Quality }
 
       # @!attribute size
-      #   The size of the requested image.
+      #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
-      #   @return [Symbol, OpenAI::Models::ImageGenPartialImageEvent::Size]
-      required :size, enum: -> { OpenAI::ImageGenPartialImageEvent::Size }
+      #   @return [String, Symbol, OpenAI::Models::ImageGenPartialImageEvent::Size]
+      required :size, union: -> { OpenAI::ImageGenPartialImageEvent::Size }
 
       # @!attribute type
       #   The type of the event. Always `image_generation.partial_image`.
@@ -69,7 +69,7 @@ module OpenAI
       #
       #   @param quality [Symbol, OpenAI::Models::ImageGenPartialImageEvent::Quality] The quality setting for the requested image.
       #
-      #   @param size [Symbol, OpenAI::Models::ImageGenPartialImageEvent::Size] The size of the requested image.
+      #   @param size [String, Symbol, OpenAI::Models::ImageGenPartialImageEvent::Size] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       #   @param type [Symbol, :"image_generation.partial_image"] The type of the event. Always `image_generation.partial_image`.
 
@@ -110,25 +110,51 @@ module OpenAI
         LOW = :low
         MEDIUM = :medium
         HIGH = :high
+        XHIGH = :xhigh
+        MAX = :max
         AUTO = :auto
 
         # @!method self.values
         #   @return [Array<Symbol>]
       end
 
-      # The size of the requested image.
+      # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       # @see OpenAI::Models::ImageGenPartialImageEvent#size
       module Size
-        extend OpenAI::Internal::Type::Enum
+        extend OpenAI::Internal::Type::Union
+
+        variant const: -> { OpenAI::Models::ImageGenPartialImageEvent::Size::SIZE_1024X1024 }
+
+        variant const: -> { OpenAI::Models::ImageGenPartialImageEvent::Size::SIZE_1024X1536 }
+
+        variant const: -> { OpenAI::Models::ImageGenPartialImageEvent::Size::SIZE_1536X1024 }
+
+        variant const: -> { OpenAI::Models::ImageGenPartialImageEvent::Size::AUTO }
+
+        # Keep known dimensions as symbols when reading existing API responses.
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(String, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(String, OpenAI::ImageGenPartialImageEvent::Size::TaggedSymbol) }
+        end
+
+        # @!group
 
         SIZE_1024X1024 = :"1024x1024"
         SIZE_1024X1536 = :"1024x1536"
         SIZE_1536X1024 = :"1536x1024"
         AUTO = :auto
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+        # @!endgroup
+
+        # Preserve the enum helper available before custom dimensions were supported.
+        #
+        # @return [Array<Symbol>]
+        def self.values = [SIZE_1024X1024, SIZE_1024X1536, SIZE_1536X1024, AUTO]
       end
     end
   end