openai 0.98.0 → 0.99.0

data/lib/openai/models/image_edit_params.rb

@@ -19,9 +19,6 @@ module OpenAI
       #   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.
-      #
       #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
       #   content type.
@@ -30,8 +27,8 @@ module OpenAI
       required :image, union: -> { OpenAI::ImageEditParams::Image }
 
       # @!attribute prompt
-      #   A text description of the desired image(s). The maximum length is 1000
-      #   characters for `dall-e-2`, and 32000 characters for the GPT image models.
+      #   A text description of the desired image(s). The maximum length is 32000
+      #   characters for the GPT image models.
       #
       #   @return [String]
       required :prompt, String
@@ -72,12 +69,11 @@ module OpenAI
       optional :mask, OpenAI::Internal::Type::FileInput
 
       # @!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`, `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`.
+      #   The GPT image model to use for image editing (`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`).
       #
       #   @return [String, Symbol, OpenAI::Models::ImageModel, nil]
       optional :model, union: -> { OpenAI::ImageEditParams::Model }, nil?: true
@@ -125,27 +121,26 @@ module OpenAI
       optional :quality, enum: -> { OpenAI::ImageEditParams::Quality }, nil?: true
 
       # @!attribute response_format
-      #   The format in which the generated images are returned. Must be one of `url` or
-      #   `b64_json`. URLs are only valid for 60 minutes after the image has been
-      #   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.
+      #   @deprecated
+      #
+      #   Legacy response format parameter for retired image models. Unsupported for GPT
+      #   image models, which always return base64-encoded images.
       #
       #   @return [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil]
       optional :response_format, enum: -> { OpenAI::ImageEditParams::ResponseFormat }, nil?: true
 
       # @!attribute size
-      #   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`.
+      #   The size of the generated images. Defaults to `auto`. 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.
       #
       #   @return [String, Symbol, OpenAI::Models::ImageEditParams::Size, nil]
       optional :size, union: -> { OpenAI::ImageEditParams::Size }, nil?: true
@@ -169,16 +164,13 @@ module OpenAI
       #     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.
-      #
       #     `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       #     metadata. Use `OpenAI::FilePart` when you need to override the filename or
       #     content type.
       #
       #   @param prompt [String]
-      #     A text description of the desired image(s). The maximum length is 1000
-      #     characters for `dall-e-2`, and 32000 characters for the GPT image models.
+      #     A text description of the desired image(s). The maximum length is 32000
+      #     characters for the GPT image models.
       #
       #   @param background [Symbol, OpenAI::Models::ImageEditParams::Background, nil]
       #     Allows to set transparency for the background of the generated image(s). Must be
@@ -207,12 +199,11 @@ module OpenAI
       #     content type.
       #
       #   @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
-      #     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`.
+      #     The GPT image model to use for image editing (`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`).
       #
       #   @param n [Integer, nil]
       #     The number of images to generate. Must be between 1 and 10.
@@ -242,24 +233,21 @@ module OpenAI
       #     `xhigh` and `max`. Defaults to `auto`.
       #
       #   @param response_format [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil]
-      #     The format in which the generated images are returned. Must be one of `url` or
-      #     `b64_json`. URLs are only valid for 60 minutes after the image has been
-      #     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.
+      #     Legacy response format parameter for retired image models. Unsupported for GPT
+      #     image models, which always return base64-encoded images.
       #
       #   @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`,
-      #     `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`.
+      #     The size of the generated images. Defaults to `auto`. 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.
       #
       #   @param user [String]
       #     A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -276,9 +264,6 @@ module OpenAI
       # `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.
       module Image
         extend OpenAI::Internal::Type::Union
 
@@ -326,18 +311,17 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # 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`.
+      # The GPT image model to use for image editing (`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`).
       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`, `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`.
+        # The GPT image model to use for image editing (`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`).
         variant enum: -> { OpenAI::ImageModel }
 
         # @!method self.variants
@@ -365,22 +349,24 @@ module OpenAI
       module Quality
         extend OpenAI::Internal::Type::Enum
 
-        STANDARD = :standard
         LOW = :low
         MEDIUM = :medium
         HIGH = :high
         XHIGH = :xhigh
         MAX = :max
         AUTO = :auto
+        # @deprecated This quality was only supported by retired DALL·E models. Use a GPT image
+        # quality instead.
+        STANDARD = :standard
 
         # @!method self.values
         #   @return [Array<Symbol>]
       end
 
-      # The format in which the generated images are returned. Must be one of `url` or
-      # `b64_json`. URLs are only valid for 60 minutes after the image has been
-      # 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.
+      # @deprecated
+      #
+      # Legacy response format parameter for retired image models. Unsupported for GPT
+      # image models, which always return base64-encoded images.
       module ResponseFormat
         extend OpenAI::Internal::Type::Enum
 
@@ -391,27 +377,22 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # 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`.
+      # The size of the generated images. Defaults to `auto`. 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.
       module Size
         extend OpenAI::Internal::Type::Union
 
         variant String
 
-        variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_256X256 }
-
-        variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_512X512 }
-
         variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_1024X1024 }
 
         variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_1536X1024 }
@@ -420,6 +401,10 @@ module OpenAI
 
         variant const: -> { OpenAI::Models::ImageEditParams::Size::AUTO }
 
+        variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_256X256 }
+
+        variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_512X512 }
+
         # @!method self.variants
         #   @return [Array(String, Symbol)]
 
@@ -429,12 +414,16 @@ module OpenAI
 
         # @!group
 
-        SIZE_256X256 = :"256x256"
-        SIZE_512X512 = :"512x512"
         SIZE_1024X1024 = :"1024x1024"
         SIZE_1536X1024 = :"1536x1024"
         SIZE_1024X1536 = :"1024x1536"
         AUTO = :auto
+        # @deprecated This legacy size suggestion is retained for SDK compatibility. Check the
+        # selected GPT image model's supported sizes.
+        SIZE_256X256 = :"256x256"
+        # @deprecated This legacy size suggestion is retained for SDK compatibility. Check the
+        # selected GPT image model's supported sizes.
+        SIZE_512X512 = :"512x512"
 
         # @!endgroup
       end

data/lib/openai/models/image_generate_params.rb

@@ -11,8 +11,7 @@ module OpenAI
 
       # @!attribute prompt
       #   A text description of the desired image(s). The maximum length is 32000
-      #   characters for the GPT image models, 1000 characters for `dall-e-2` and 4000
-      #   characters for `dall-e-3`.
+      #   characters.
       #
       #   @return [String]
       required :prompt, String
@@ -32,12 +31,11 @@ module OpenAI
       optional :background, enum: -> { OpenAI::ImageGenerateParams::Background }, nil?: true
 
       # @!attribute model
-      #   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`, `gpt-image-2`,
-      #   `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+      #   The GPT image model to use for image generation. Specify a model explicitly.
+      #   Supported models include `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`). Defaults to `dall-e-2` unless a parameter
-      #   specific to the GPT image models is used.
+      #   `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`.
       #
       #   @return [String, Symbol, OpenAI::Models::ImageModel, nil]
       optional :model, union: -> { OpenAI::ImageGenerateParams::Model }, nil?: true
@@ -51,8 +49,7 @@ module OpenAI
       optional :moderation, enum: -> { OpenAI::ImageGenerateParams::Moderation }, nil?: true
 
       # @!attribute n
-      #   The number of images to generate. Must be between 1 and 10. For `dall-e-3`, only
-      #   `n=1` is supported.
+      #   The number of images to generate. Must be between 1 and 10.
       #
       #   @return [Integer, nil]
       optional :n, Integer, nil?: true
@@ -91,16 +88,14 @@ module OpenAI
       #   - `high`, `medium` and `low` are supported for the GPT image models.
       #   - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
       #     `2026-09-08` snapshots, also support `xhigh` and `max`.
-      #   - `hd` and `standard` are supported for `dall-e-3`.
-      #   - `standard` is the only option for `dall-e-2`.
       #
       #   @return [Symbol, OpenAI::Models::ImageGenerateParams::Quality, nil]
       optional :quality, enum: -> { OpenAI::ImageGenerateParams::Quality }, nil?: true
 
       # @!attribute response_format
-      #   The format in which generated images with `dall-e-2` and `dall-e-3` are
-      #   returned. Must be one of `url` or `b64_json`. URLs are only valid for 60 minutes
-      #   after the image has been generated. This parameter isn't supported for the GPT
+      #   @deprecated
+      #
+      #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
       #   @return [Symbol, OpenAI::Models::ImageGenerateParams::ResponseFormat, nil]
@@ -116,18 +111,16 @@ module OpenAI
       #   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`.
+      #   `auto` is supported for models that allow automatic sizing.
       #
       #   @return [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, nil]
       optional :size, union: -> { OpenAI::ImageGenerateParams::Size }, nil?: true
 
       # @!attribute style
-      #   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
-      #   towards generating hyper-real and dramatic images. Natural causes the model to
-      #   produce more natural, less hyper-real looking images.
+      #   @deprecated
+      #
+      #   Legacy style parameter for retired image models. Unsupported for GPT image
+      #   models; describe the desired style in the prompt instead.
       #
       #   @return [Symbol, OpenAI::Models::ImageGenerateParams::Style, nil]
       optional :style, enum: -> { OpenAI::ImageGenerateParams::Style }, nil?: true
@@ -143,8 +136,7 @@ module OpenAI
       # @!method initialize(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, style: nil, user: nil, request_options: {})
       #   @param prompt [String]
       #     A text description of the desired image(s). The maximum length is 32000
-      #     characters for the GPT image models, 1000 characters for `dall-e-2` and 4000
-      #     characters for `dall-e-3`.
+      #     characters.
       #
       #   @param background [Symbol, OpenAI::Models::ImageGenerateParams::Background, nil]
       #     Allows to set transparency for the background of the generated image(s). Must be
@@ -158,12 +150,11 @@ module OpenAI
       #     set the output format to `png` or `webp`.
       #
       #   @param model [String, Symbol, OpenAI::Models::ImageModel, 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`, `gpt-image-2`,
-      #     `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+      #     The GPT image model to use for image generation. Specify a model explicitly.
+      #     Supported models include `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`). Defaults to `dall-e-2` unless a parameter
-      #     specific to the GPT image models is used.
+      #     `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`.
       #
       #   @param moderation [Symbol, OpenAI::Models::ImageGenerateParams::Moderation, nil]
       #     Control the content-moderation level for images generated by the GPT image
@@ -171,8 +162,7 @@ module OpenAI
       #     value).
       #
       #   @param n [Integer, nil]
-      #     The number of images to generate. Must be between 1 and 10. For `dall-e-3`, only
-      #     `n=1` is supported.
+      #     The number of images to generate. Must be between 1 and 10.
       #
       #   @param output_compression [Integer, nil]
       #     The compression level (0-100%) for the generated images. This parameter is only
@@ -199,13 +189,9 @@ module OpenAI
       #     - `high`, `medium` and `low` are supported for the GPT image models.
       #     - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
       #       `2026-09-08` snapshots, also support `xhigh` and `max`.
-      #     - `hd` and `standard` are supported for `dall-e-3`.
-      #     - `standard` is the only option for `dall-e-2`.
       #
       #   @param response_format [Symbol, OpenAI::Models::ImageGenerateParams::ResponseFormat, nil]
-      #     The format in which generated images with `dall-e-2` and `dall-e-3` are
-      #     returned. Must be one of `url` or `b64_json`. URLs are only valid for 60 minutes
-      #     after the image has been generated. This parameter isn't supported for the GPT
+      #     Legacy response format parameter for retired image models. Unsupported for GPT
       #     image models, which always return base64-encoded images.
       #
       #   @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, nil]
@@ -218,15 +204,11 @@ module OpenAI
       #     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`.
+      #     `auto` is supported for models that allow automatic sizing.
       #
       #   @param style [Symbol, OpenAI::Models::ImageGenerateParams::Style, 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
-      #     towards generating hyper-real and dramatic images. Natural causes the model to
-      #     produce more natural, less hyper-real looking images.
+      #     Legacy style parameter for retired image models. Unsupported for GPT image
+      #     models; describe the desired style in the prompt instead.
       #
       #   @param user [String]
       #     A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -255,18 +237,17 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
-      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
-      # `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+      # The GPT image model to use for image generation. Specify a model explicitly.
+      # Supported models include `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`). Defaults to `dall-e-2` unless a parameter
-      # specific to the GPT image models is used.
+      # `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`.
       module Model
         extend OpenAI::Internal::Type::Union
 
         variant String
 
-        # 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`, `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`). Defaults to `dall-e-2` unless a parameter specific to the GPT image models is used.
+        # The GPT image model to use for image generation. Specify a model explicitly. Supported models include `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`, and `chatgpt-image-latest`.
         variant enum: -> { OpenAI::ImageModel }
 
         # @!method self.variants
@@ -306,27 +287,29 @@ module OpenAI
       # - `high`, `medium` and `low` are supported for the GPT image models.
       # - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
       #   `2026-09-08` snapshots, also support `xhigh` and `max`.
-      # - `hd` and `standard` are supported for `dall-e-3`.
-      # - `standard` is the only option for `dall-e-2`.
       module Quality
         extend OpenAI::Internal::Type::Enum
 
-        STANDARD = :standard
-        HD = :hd
         LOW = :low
         MEDIUM = :medium
         HIGH = :high
         XHIGH = :xhigh
         MAX = :max
         AUTO = :auto
+        # @deprecated This quality was only supported by retired DALL·E models. Use a GPT image
+        # quality instead.
+        STANDARD = :standard
+        # @deprecated This quality was only supported by retired DALL·E models. Use a GPT image
+        # quality instead.
+        HD = :hd
 
         # @!method self.values
         #   @return [Array<Symbol>]
       end
 
-      # The format in which generated images with `dall-e-2` and `dall-e-3` are
-      # returned. Must be one of `url` or `b64_json`. URLs are only valid for 60 minutes
-      # after the image has been generated. This parameter isn't supported for the GPT
+      # @deprecated
+      #
+      # Legacy response format parameter for retired image models. Unsupported for GPT
       # image models, which always return base64-encoded images.
       module ResponseFormat
         extend OpenAI::Internal::Type::Enum
@@ -347,9 +330,7 @@ module OpenAI
       # 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`.
+      # `auto` is supported for models that allow automatic sizing.
       module Size
         extend OpenAI::Internal::Type::Union
 
@@ -384,18 +365,26 @@ module OpenAI
         SIZE_1024X1024 = :"1024x1024"
         SIZE_1536X1024 = :"1536x1024"
         SIZE_1024X1536 = :"1024x1536"
+        # @deprecated This legacy size suggestion is retained for SDK compatibility. Check the
+        # selected GPT image model's supported sizes.
         SIZE_256X256 = :"256x256"
+        # @deprecated This legacy size suggestion is retained for SDK compatibility. Check the
+        # selected GPT image model's supported sizes.
         SIZE_512X512 = :"512x512"
+        # @deprecated This legacy size suggestion is retained for SDK compatibility. Check the
+        # selected GPT image model's supported sizes.
         SIZE_1792X1024 = :"1792x1024"
+        # @deprecated This legacy size suggestion is retained for SDK compatibility. Check the
+        # selected GPT image model's supported sizes.
         SIZE_1024X1792 = :"1024x1792"
 
         # @!endgroup
       end
 
-      # 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
-      # towards generating hyper-real and dramatic images. Natural causes the model to
-      # produce more natural, less hyper-real looking images.
+      # @deprecated
+      #
+      # Legacy style parameter for retired image models. Unsupported for GPT image
+      # models; describe the desired style in the prompt instead.
       module Style
         extend OpenAI::Internal::Type::Enum
 

data/lib/openai/models/image_model.rb

@@ -5,17 +5,19 @@ module OpenAI
     module ImageModel
       extend OpenAI::Internal::Type::Enum
 
-      GPT_IMAGE_1 = :"gpt-image-1"
-      GPT_IMAGE_1_MINI = :"gpt-image-1-mini"
+      GPT_IMAGE_1_5 = :"gpt-image-1.5"
       GPT_IMAGE_2 = :"gpt-image-2"
       GPT_IMAGE_2_2026_04_21 = :"gpt-image-2-2026-04-21"
       GPT_IMAGE_2_5_SUNBURST = :"gpt-image-2.5-sunburst"
       GPT_IMAGE_2_5_SUNBURST_2026_09_08 = :"gpt-image-2.5-sunburst-2026-09-08"
       GPT_IMAGE_2_5_FLARE = :"gpt-image-2.5-flare"
       GPT_IMAGE_2_5_FLARE_2026_09_08 = :"gpt-image-2.5-flare-2026-09-08"
-      GPT_IMAGE_1_5 = :"gpt-image-1.5"
+      GPT_IMAGE_1 = :"gpt-image-1"
+      GPT_IMAGE_1_MINI = :"gpt-image-1-mini"
       CHATGPT_IMAGE_LATEST = :"chatgpt-image-latest"
+      # @deprecated This model was retired on May 12, 2026. Use a GPT image model instead.
       DALL_E_2 = :"dall-e-2"
+      # @deprecated This model was retired on May 12, 2026. Use a GPT image model instead.
       DALL_E_3 = :"dall-e-3"
 
       # @!method self.values

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

@@ -27,8 +27,9 @@ module OpenAI
         #   `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
         #   `cedar`. You may also provide a custom voice object with an `id`, for example
         #   `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
-        #   model has responded with audio at least once. We recommend `marin` and `cedar`
-        #   for best quality.
+        #   model has responded with audio at least once. Custom voices must be created from
+        #   audio samples. Voices created from text prompts are supported only in Live. We
+        #   recommend `marin` and `cedar` for best quality.
         #
         #   @return [String, Symbol, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice::ID, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice, nil]
         optional :voice, union: -> { OpenAI::Realtime::RealtimeAudioConfigOutput::Voice }
@@ -51,15 +52,17 @@ module OpenAI
         #     `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
         #     `cedar`. You may also provide a custom voice object with an `id`, for example
         #     `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
-        #     model has responded with audio at least once. We recommend `marin` and `cedar`
-        #     for best quality.
+        #     model has responded with audio at least once. Custom voices must be created from
+        #     audio samples. Voices created from text prompts are supported only in Live. We
+        #     recommend `marin` and `cedar` for best quality.
 
         # The voice the model uses to respond. Supported built-in voices are `alloy`,
         # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
         # `cedar`. You may also provide a custom voice object with an `id`, for example
         # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
-        # model has responded with audio at least once. We recommend `marin` and `cedar`
-        # for best quality.
+        # model has responded with audio at least once. Custom voices must be created from
+        # audio samples. Voices created from text prompts are supported only in Live. We
+        # recommend `marin` and `cedar` for best quality.
         #
         # @see OpenAI::Models::Realtime::RealtimeAudioConfigOutput#voice
         module Voice