openai 0.98.0 → 0.100.0

data/rbi/openai/models/image_edit_params.rbi

@@ -24,17 +24,14 @@ 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.
       sig { returns(OpenAI::ImageEditParams::Image::Variants) }
       attr_accessor :image
 
-      # 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.
       sig { returns(String) }
       attr_accessor :prompt
 
@@ -50,9 +47,10 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageEditParams::Background::OrSymbol)) }
       attr_accessor :background
 
-      # Controls fidelity to the original input image(s). This parameter is supported
-      # for GPT image models that support input fidelity. `gpt-image-2` and
-      # `gpt-image-2-2026-04-21` ignore this parameter.
+      # Control how much effort the model will exert to match the style and features,
+      # especially facial features, of input images. Supports `high` and `low` on
+      # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+      # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
       sig { returns(T.nilable(OpenAI::ImageEditParams::InputFidelity::OrSymbol)) }
       attr_accessor :input_fidelity
 
@@ -70,12 +68,11 @@ module OpenAI
       sig { params(mask: OpenAI::Internal::FileInput).void }
       attr_writer :mask
 
-      # 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`).
       sig { returns(T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol))) }
       attr_accessor :model
 
@@ -111,25 +108,22 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol)) }
       attr_accessor :quality
 
-      # 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.
       sig { returns(T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol)) }
       attr_accessor :response_format
 
-      # 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.
       sig { returns(T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol))) }
       attr_accessor :size
 
@@ -188,16 +182,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.
         image:,
 
-        # 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.
         prompt:,
 
         # Allows to set transparency for the background of the generated image(s). Must be
@@ -211,9 +202,10 @@ module OpenAI
         # set the output format to `png` or `webp`.
         background: nil,
 
-        # Controls fidelity to the original input image(s). This parameter is supported
-        # for GPT image models that support input fidelity. `gpt-image-2` and
-        # `gpt-image-2-2026-04-21` ignore this parameter.
+        # Control how much effort the model will exert to match the style and features,
+        # especially facial features, of input images. Supports `high` and `low` on
+        # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+        # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
         input_fidelity: nil,
 
         # An additional image whose fully transparent areas (e.g. where alpha is zero)
@@ -226,12 +218,11 @@ module OpenAI
         # content type.
         mask: 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`).
         model: nil,
 
         # The number of images to generate. Must be between 1 and 10.
@@ -261,24 +252,21 @@ module OpenAI
         # `xhigh` and `max`. Defaults to `auto`.
         quality: 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.
         response_format: 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.
         size: nil,
 
         # A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -322,9 +310,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
 
@@ -365,9 +350,10 @@ module OpenAI
         end
       end
 
-      # Controls fidelity to the original input image(s). This parameter is supported
-      # for GPT image models that support input fidelity. `gpt-image-2` and
-      # `gpt-image-2-2026-04-21` ignore this parameter.
+      # Control how much effort the model will exert to match the style and features,
+      # especially facial features, of input images. Supports `high` and `low` on
+      # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+      # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
       module InputFidelity
         extend OpenAI::Internal::Type::Enum
 
@@ -382,12 +368,11 @@ module OpenAI
         end
       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
 
@@ -427,23 +412,21 @@ module OpenAI
         TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::ImageEditParams::Quality) }
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-        STANDARD = T.let(:standard, OpenAI::ImageEditParams::Quality::TaggedSymbol)
         LOW = T.let(:low, OpenAI::ImageEditParams::Quality::TaggedSymbol)
         MEDIUM = T.let(:medium, OpenAI::ImageEditParams::Quality::TaggedSymbol)
         HIGH = T.let(:high, OpenAI::ImageEditParams::Quality::TaggedSymbol)
         XHIGH = T.let(:xhigh, OpenAI::ImageEditParams::Quality::TaggedSymbol)
         MAX = T.let(:max, OpenAI::ImageEditParams::Quality::TaggedSymbol)
         AUTO = T.let(:auto, OpenAI::ImageEditParams::Quality::TaggedSymbol)
+        STANDARD = T.let(:standard, OpenAI::ImageEditParams::Quality::TaggedSymbol)
 
         sig { override.returns(T::Array[OpenAI::ImageEditParams::Quality::TaggedSymbol]) }
         def self.values
         end
       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.
+      # 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
 
@@ -458,18 +441,17 @@ module OpenAI
         end
       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
 
@@ -485,12 +467,12 @@ module OpenAI
 
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-        SIZE_256X256 = T.let(:"256x256", OpenAI::ImageEditParams::Size::TaggedSymbol)
-        SIZE_512X512 = T.let(:"512x512", OpenAI::ImageEditParams::Size::TaggedSymbol)
         SIZE_1024X1024 = T.let(:"1024x1024", OpenAI::ImageEditParams::Size::TaggedSymbol)
         SIZE_1536X1024 = T.let(:"1536x1024", OpenAI::ImageEditParams::Size::TaggedSymbol)
         SIZE_1024X1536 = T.let(:"1024x1536", OpenAI::ImageEditParams::Size::TaggedSymbol)
         AUTO = T.let(:auto, OpenAI::ImageEditParams::Size::TaggedSymbol)
+        SIZE_256X256 = T.let(:"256x256", OpenAI::ImageEditParams::Size::TaggedSymbol)
+        SIZE_512X512 = T.let(:"512x512", OpenAI::ImageEditParams::Size::TaggedSymbol)
 
       end
 

data/rbi/openai/models/image_generate_params.rbi

@@ -16,8 +16,7 @@ module OpenAI
       end
 
       # 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.
       sig { returns(String) }
       attr_accessor :prompt
 
@@ -33,12 +32,11 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageGenerateParams::Background::OrSymbol)) }
       attr_accessor :background
 
-      # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
-      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `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`.
       sig { returns(T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol))) }
       attr_accessor :model
 
@@ -48,8 +46,7 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageGenerateParams::Moderation::OrSymbol)) }
       attr_accessor :moderation
 
-      # 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.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :n
 
@@ -80,14 +77,10 @@ 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`.
       sig { returns(T.nilable(OpenAI::ImageGenerateParams::Quality::OrSymbol)) }
       attr_accessor :quality
 
-      # 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.
       sig { returns(T.nilable(OpenAI::ImageGenerateParams::ResponseFormat::OrSymbol)) }
       attr_accessor :response_format
@@ -101,16 +94,12 @@ 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.
       sig { returns(T.nilable(T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol))) }
       attr_accessor :size
 
-      # 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.
       sig { returns(T.nilable(OpenAI::ImageGenerateParams::Style::OrSymbol)) }
       attr_accessor :style
 
@@ -159,8 +148,7 @@ module OpenAI
       def self.new(
 
         # 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.
         prompt:,
 
         # Allows to set transparency for the background of the generated image(s). Must be
@@ -174,12 +162,11 @@ module OpenAI
         # set the output format to `png` 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`, `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`.
         model: nil,
 
         # Control the content-moderation level for images generated by the GPT image
@@ -187,8 +174,7 @@ module OpenAI
         # value).
         moderation: 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.
         n: nil,
 
         # The compression level (0-100%) for the generated images. This parameter is only
@@ -215,13 +201,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`.
         quality: 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.
         response_format: nil,
 
@@ -234,15 +216,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.
         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
-        # 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.
         style: nil,
 
         # A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -301,12 +279,11 @@ module OpenAI
         end
       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
 
@@ -359,31 +336,27 @@ 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
 
         TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::ImageGenerateParams::Quality) }
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-        STANDARD = T.let(:standard, OpenAI::ImageGenerateParams::Quality::TaggedSymbol)
-        HD = T.let(:hd, OpenAI::ImageGenerateParams::Quality::TaggedSymbol)
         LOW = T.let(:low, OpenAI::ImageGenerateParams::Quality::TaggedSymbol)
         MEDIUM = T.let(:medium, OpenAI::ImageGenerateParams::Quality::TaggedSymbol)
         HIGH = T.let(:high, OpenAI::ImageGenerateParams::Quality::TaggedSymbol)
         XHIGH = T.let(:xhigh, OpenAI::ImageGenerateParams::Quality::TaggedSymbol)
         MAX = T.let(:max, OpenAI::ImageGenerateParams::Quality::TaggedSymbol)
         AUTO = T.let(:auto, OpenAI::ImageGenerateParams::Quality::TaggedSymbol)
+        STANDARD = T.let(:standard, OpenAI::ImageGenerateParams::Quality::TaggedSymbol)
+        HD = T.let(:hd, OpenAI::ImageGenerateParams::Quality::TaggedSymbol)
 
         sig { override.returns(T::Array[OpenAI::ImageGenerateParams::Quality::TaggedSymbol]) }
         def self.values
         end
       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
+      # 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
@@ -408,9 +381,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
 
@@ -437,10 +408,8 @@ module OpenAI
 
       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.
+      # 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/rbi/openai/models/image_model.rbi

@@ -9,15 +9,15 @@ module OpenAI
       TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::ImageModel) }
       OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-      GPT_IMAGE_1 = T.let(:"gpt-image-1", OpenAI::ImageModel::TaggedSymbol)
-      GPT_IMAGE_1_MINI = T.let(:"gpt-image-1-mini", OpenAI::ImageModel::TaggedSymbol)
+      GPT_IMAGE_1_5 = T.let(:"gpt-image-1.5", OpenAI::ImageModel::TaggedSymbol)
       GPT_IMAGE_2 = T.let(:"gpt-image-2", OpenAI::ImageModel::TaggedSymbol)
       GPT_IMAGE_2_2026_04_21 = T.let(:"gpt-image-2-2026-04-21", OpenAI::ImageModel::TaggedSymbol)
       GPT_IMAGE_2_5_SUNBURST = T.let(:"gpt-image-2.5-sunburst", OpenAI::ImageModel::TaggedSymbol)
       GPT_IMAGE_2_5_SUNBURST_2026_09_08 = T.let(:"gpt-image-2.5-sunburst-2026-09-08", OpenAI::ImageModel::TaggedSymbol)
       GPT_IMAGE_2_5_FLARE = T.let(:"gpt-image-2.5-flare", OpenAI::ImageModel::TaggedSymbol)
       GPT_IMAGE_2_5_FLARE_2026_09_08 = T.let(:"gpt-image-2.5-flare-2026-09-08", OpenAI::ImageModel::TaggedSymbol)
-      GPT_IMAGE_1_5 = T.let(:"gpt-image-1.5", OpenAI::ImageModel::TaggedSymbol)
+      GPT_IMAGE_1 = T.let(:"gpt-image-1", OpenAI::ImageModel::TaggedSymbol)
+      GPT_IMAGE_1_MINI = T.let(:"gpt-image-1-mini", OpenAI::ImageModel::TaggedSymbol)
       CHATGPT_IMAGE_LATEST = T.let(:"chatgpt-image-latest", OpenAI::ImageModel::TaggedSymbol)
       DALL_E_2 = T.let(:"dall-e-2", OpenAI::ImageModel::TaggedSymbol)
       DALL_E_3 = T.let(:"dall-e-3", OpenAI::ImageModel::TaggedSymbol)

data/rbi/openai/models/realtime/realtime_audio_config_output.rbi

@@ -57,8 +57,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.
         sig {
           returns(
             T.nilable(
@@ -121,8 +122,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.
 
           voice: nil
         )
@@ -152,8 +154,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.
         module Voice
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/realtime/realtime_response_create_audio_output.rbi

@@ -80,8 +80,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.
           sig {
             returns(
               T.nilable(
@@ -133,8 +134,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.
 
             voice: nil
           )
@@ -163,8 +165,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.
           module Voice
             extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/realtime/session_update_event.rbi

@@ -49,6 +49,22 @@ module OpenAI
         # fields that are present in the `session.update` are updated. To clear a field
         # like `instructions`, pass an empty string. To clear a field like `tools`, pass
         # an empty array. To clear a field like `turn_detection`, pass `null`.
+        #
+        # To turn off input audio noise reduction, send this Realtime event:
+        #
+        # ```json
+        # {
+        #   "type": "session.update",
+        #   "session": {
+        #     "type": "realtime",
+        #     "audio": { "input": { "noise_reduction": null } }
+        #   }
+        # }
+        # ```
+        #
+        # For a transcription session, use `"type":"transcription"` inside `session`.
+        # Omitting `audio.input.noise_reduction` from an update leaves its current setting
+        # unchanged.
         sig do
           params(