openai 0.98.0 → 0.100.0

data/sig/openai/models/graders/score_model_grader.rbs

@@ -27,10 +27,10 @@ module OpenAI
         # The object type, which is always `score_model`.
         attr_accessor type: :score_model
 
-        # The range of the score. Defaults to `[0, 1]`.
+        # The service requires two numbers for the score range. Defaults to `[0, 1]`.
         attr_reader range: ::Array[Float]?
 
-        # The range of the score. Defaults to `[0, 1]`.
+        # The service requires two numbers for the score range. Defaults to `[0, 1]`.
         def range=: (::Array[Float]) -> ::Array[Float]
 
         # The sampling parameters for the model.
@@ -49,7 +49,7 @@ module OpenAI
         # @param name
         #   The name of the grader.
         # @param range
-        #   The range of the score. Defaults to `[0, 1]`.
+        #   The service requires two numbers for the score range. Defaults to `[0, 1]`.
         # @param sampling_params
         #   The sampling parameters for the model.
         # @param type

data/sig/openai/models/image.rbs

@@ -3,42 +3,42 @@ module OpenAI
     type image = { ?:b64_json => String, ?revised_prompt: String, ?url: String }
 
     class Image < OpenAI::Internal::Type::BaseModel
-      # The base64-encoded JSON of the generated image. Returned by default for the GPT
-      # image models, and only present if `response_format` is set to `b64_json` for
-      # `dall-e-2` and `dall-e-3`.
+      # The base64-encoded JSON of the generated image. Returned by default for GPT
+      # image models, or when `response_format` is set to `b64_json` for models that
+      # support that parameter.
       attr_reader b64_json: String?
 
-      # The base64-encoded JSON of the generated image. Returned by default for the GPT
-      # image models, and only present if `response_format` is set to `b64_json` for
-      # `dall-e-2` and `dall-e-3`.
+      # The base64-encoded JSON of the generated image. Returned by default for GPT
+      # image models, or when `response_format` is set to `b64_json` for models that
+      # support that parameter.
       def b64_json=: (String) -> String
 
-      # For `dall-e-3` only, the revised prompt that was used to generate the image.
+      # The revised prompt used to generate the image, for models that support prompt
+      # revision. Not returned by GPT image models.
       attr_reader revised_prompt: String?
 
-      # For `dall-e-3` only, the revised prompt that was used to generate the image.
+      # The revised prompt used to generate the image, for models that support prompt
+      # revision. Not returned by GPT image models.
       def revised_prompt=: (String) -> String
 
-      # When using `dall-e-2` or `dall-e-3`, the URL of the generated image if
-      # `response_format` is set to `url` (default value). Unsupported for the GPT image
-      # models.
+      # The URL of the generated image when `response_format` is set to `url` for models
+      # that support that parameter. Unsupported for GPT image models.
       attr_reader url: String?
 
-      # When using `dall-e-2` or `dall-e-3`, the URL of the generated image if
-      # `response_format` is set to `url` (default value). Unsupported for the GPT image
-      # models.
+      # The URL of the generated image when `response_format` is set to `url` for models
+      # that support that parameter. Unsupported for GPT image models.
       def url=: (String) -> String
 
       # @param b64_json
-      #   The base64-encoded JSON of the generated image. Returned by default for the GPT
-      #   image models, and only present if `response_format` is set to `b64_json` for
-      #   `dall-e-2` and `dall-e-3`.
+      #   The base64-encoded JSON of the generated image. Returned by default for GPT
+      #   image models, or when `response_format` is set to `b64_json` for models that
+      #   support that parameter.
       # @param revised_prompt
-      #   For `dall-e-3` only, the revised prompt that was used to generate the image.
+      #   The revised prompt used to generate the image, for models that support prompt
+      #   revision. Not returned by GPT image models.
       # @param url
-      #   When using `dall-e-2` or `dall-e-3`, the URL of the generated image if
-      #   `response_format` is set to `url` (default value). Unsupported for the GPT image
-      #   models.
+      #   The URL of the generated image when `response_format` is set to `url` for models
+      #   that support that parameter. Unsupported for GPT image models.
       def initialize: (
         ?b64_json: String,
         ?revised_prompt: String,

data/sig/openai/models/image_create_variation_params.rbs

@@ -23,8 +23,8 @@ module OpenAI
       # content type.
       attr_accessor image: OpenAI::Internal::file_input
 
-      # The model to use for image generation. Only `dall-e-2` is supported at this
-      # time.
+      # The legacy model used by the retired image variations endpoint. This endpoint no
+      # longer accepts requests.
       attr_accessor model: OpenAI::Models::ImageCreateVariationParams::model?
 
       # The number of images to generate. Must be between 1 and 10.
@@ -57,8 +57,8 @@ module OpenAI
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
       #   content type.
       # @param model
-      #   The model to use for image generation. Only `dall-e-2` is supported at this
-      #   time.
+      #   The legacy model used by the retired image variations endpoint. This endpoint no
+      #   longer accepts requests.
       # @param n
       #   The number of images to generate. Must be between 1 and 10.
       # @param response_format

data/sig/openai/models/image_edit_params.rbs

@@ -32,16 +32,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.
       attr_accessor image: OpenAI::Models::ImageEditParams::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.
       attr_accessor prompt: String
 
       # Allows to set transparency for the background of the generated image(s). Must be
@@ -55,9 +52,10 @@ module OpenAI
       # set the output format to `png` or `webp`.
       attr_accessor background: OpenAI::Models::ImageEditParams::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.
       attr_accessor input_fidelity: OpenAI::Models::ImageEditParams::input_fidelity?
 
       # An additional image whose fully transparent areas (e.g. where alpha is zero)
@@ -80,12 +78,11 @@ module OpenAI
       # content type.
       def mask=: (OpenAI::Internal::file_input) -> OpenAI::Internal::file_input
 
-      # 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`).
       attr_accessor model: OpenAI::Models::ImageEditParams::model?
 
       # The number of images to generate. Must be between 1 and 10.
@@ -115,24 +112,21 @@ module OpenAI
       # `xhigh` and `max`. Defaults to `auto`.
       attr_accessor quality: OpenAI::Models::ImageEditParams::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.
       attr_accessor response_format: OpenAI::Models::ImageEditParams::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.
       attr_accessor size: OpenAI::Models::ImageEditParams::size?
 
       # A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -155,15 +149,12 @@ 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
-      #   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
       #   Allows to set transparency for the background of the generated image(s). Must be
       #   one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
@@ -175,9 +166,10 @@ module OpenAI
       #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
       #   set the output format to `png` or `webp`.
       # @param input_fidelity
-      #   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.
       # @param mask
       #   An additional image whose fully transparent areas (e.g. where alpha is zero)
       #   indicate where `image` should be edited. If there are multiple images provided,
@@ -188,12 +180,11 @@ module OpenAI
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
       #   content type.
       # @param 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`).
       # @param n
       #   The number of images to generate. Must be between 1 and 10.
       # @param output_compression
@@ -217,23 +208,20 @@ module OpenAI
       #   `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, also support
       #   `xhigh` and `max`. Defaults to `auto`.
       # @param 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.
+      #   Legacy response format parameter for retired image models. Unsupported for GPT
+      #   image models, which always return base64-encoded images.
       # @param 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.
       # @param user
       #   A unique identifier representing your end-user, which can help OpenAI to monitor
       #   and detect abuse.
@@ -328,18 +316,18 @@ module OpenAI
         def self?.values: -> ::Array[OpenAI::Models::ImageEditParams::output_format]
       end
 
-      type quality = :standard | :low | :medium | :high | :xhigh | :max | :auto
+      type quality = :low | :medium | :high | :xhigh | :max | :auto | :standard
 
       module Quality
         extend OpenAI::Internal::Type::Enum
 
-        STANDARD: :standard
         LOW: :low
         MEDIUM: :medium
         HIGH: :high
         XHIGH: :xhigh
         MAX: :max
         AUTO: :auto
+        STANDARD: :standard
 
         def self?.values: -> ::Array[OpenAI::Models::ImageEditParams::quality]
       end
@@ -357,24 +345,24 @@ module OpenAI
 
       type size =
         String
-        | :"256x256"
-        | :"512x512"
         | :"1024x1024"
         | :"1536x1024"
         | :"1024x1536"
         | :auto
+        | :"256x256"
+        | :"512x512"
 
       module Size
         extend OpenAI::Internal::Type::Union
 
         def self?.variants: -> ::Array[OpenAI::Models::ImageEditParams::size]
 
-        SIZE_256X256: :"256x256"
-        SIZE_512X512: :"512x512"
         SIZE_1024X1024: :"1024x1024"
         SIZE_1536X1024: :"1536x1024"
         SIZE_1024X1536: :"1024x1536"
         AUTO: :auto
+        SIZE_256X256: :"256x256"
+        SIZE_512X512: :"512x512"
       end
     end
   end

data/sig/openai/models/image_generate_params.rbs

@@ -23,8 +23,7 @@ module OpenAI
       include OpenAI::Internal::Type::RequestParameters
 
       # 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.
       attr_accessor prompt: String
 
       # Allows to set transparency for the background of the generated image(s). Must be
@@ -38,12 +37,11 @@ module OpenAI
       # set the output format to `png` or `webp`.
       attr_accessor background: OpenAI::Models::ImageGenerateParams::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`.
       attr_accessor model: OpenAI::Models::ImageGenerateParams::model?
 
       # Control the content-moderation level for images generated by the GPT image
@@ -51,8 +49,7 @@ module OpenAI
       # value).
       attr_accessor moderation: OpenAI::Models::ImageGenerateParams::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.
       attr_accessor n: Integer?
 
       # The compression level (0-100%) for the generated images. This parameter is only
@@ -79,13 +76,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`.
       attr_accessor quality: OpenAI::Models::ImageGenerateParams::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.
       attr_accessor response_format: OpenAI::Models::ImageGenerateParams::response_format?
 
@@ -98,15 +91,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.
       attr_accessor size: OpenAI::Models::ImageGenerateParams::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.
       attr_accessor style: OpenAI::Models::ImageGenerateParams::style?
 
       # A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -121,8 +110,7 @@ module OpenAI
 
       # @param 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.
       # @param background
       #   Allows to set transparency for the background of the generated image(s). Must be
       #   one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
@@ -134,19 +122,17 @@ module OpenAI
       #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
       #   set the output format to `png` or `webp`.
       # @param 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`.
       # @param moderation
       #   Control the content-moderation level for images generated by the GPT image
       #   models. Must be either `low` for less restrictive filtering or `auto` (default
       #   value).
       # @param 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.
       # @param output_compression
       #   The compression level (0-100%) for the generated images. This parameter is only
       #   supported for the GPT image models with the `webp` or `jpeg` output formats, and
@@ -169,12 +155,8 @@ 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
-      #   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
       #   The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
@@ -186,14 +168,10 @@ 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
-      #   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
       #   A unique identifier representing your end-user, which can help OpenAI to monitor
       #   and detect abuse.
@@ -276,19 +254,19 @@ module OpenAI
       end
 
       type quality =
-        :standard | :hd | :low | :medium | :high | :xhigh | :max | :auto
+        :low | :medium | :high | :xhigh | :max | :auto | :standard | :hd
 
       module Quality
         extend OpenAI::Internal::Type::Enum
 
-        STANDARD: :standard
-        HD: :hd
         LOW: :low
         MEDIUM: :medium
         HIGH: :high
         XHIGH: :xhigh
         MAX: :max
         AUTO: :auto
+        STANDARD: :standard
+        HD: :hd
 
         def self?.values: -> ::Array[OpenAI::Models::ImageGenerateParams::quality]
       end

data/sig/openai/models/image_model.rbs

@@ -1,15 +1,15 @@
 module OpenAI
   module Models
     type 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"
-      | :"gpt-image-1.5"
+      | :"gpt-image-1"
+      | :"gpt-image-1-mini"
       | :"chatgpt-image-latest"
       | :"dall-e-2"
       | :"dall-e-3"
@@ -17,15 +17,15 @@ 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"
       DALL_E_2: :"dall-e-2"
       DALL_E_3: :"dall-e-3"

data/sig/openai/models/realtime/realtime_audio_config_output.rbs

@@ -39,16 +39,18 @@ 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.
         attr_reader voice: OpenAI::Models::Realtime::RealtimeAudioConfigOutput::voice?
 
         # 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.
         def voice=: (
           OpenAI::Models::Realtime::RealtimeAudioConfigOutput::voice
         ) -> OpenAI::Models::Realtime::RealtimeAudioConfigOutput::voice
@@ -68,8 +70,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.
         def initialize: (
           ?format_: OpenAI::Models::Realtime::realtime_audio_formats,
           ?speed: Float,

data/sig/openai/models/realtime/realtime_response_create_audio_output.rbs

@@ -38,16 +38,18 @@ 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.
           attr_reader voice: OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::voice?
 
           # 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.
           def voice=: (
             OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::voice
           ) -> OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::voice
@@ -59,8 +61,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.
           def initialize: (
             ?format_: OpenAI::Models::Realtime::realtime_audio_formats,
             ?voice: OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::voice

data/sig/openai/models/responses/response_computer_tool_call_output_item.rbs

@@ -13,7 +13,7 @@ module OpenAI
         }
 
       class ResponseComputerToolCallOutputItem < OpenAI::Internal::Type::BaseModel
-        # The unique ID of the computer call tool output.
+        # The ID of the computer tool call output.
         attr_accessor id: String
 
         # The ID of the computer tool call that produced the output.
@@ -46,7 +46,7 @@ module OpenAI
         def created_by=: (String) -> String
 
         # @param id
-        #   The unique ID of the computer call tool output.
+        #   The ID of the computer tool call output.
         # @param call_id
         #   The ID of the computer tool call that produced the output.
         # @param output