openai 0.98.0 → 0.99.0

data/sig/openai/models/audio/voice_create_params.rbs

@@ -0,0 +1,203 @@
+module OpenAI
+  module Models
+    module Audio
+      type voice_create_params =
+        {
+          body: OpenAI::Models::Audio::VoiceCreateParams::body,
+          ?request_options: OpenAI::request_opts
+        }
+
+      class VoiceCreateParams < OpenAI::Internal::Type::BaseModel
+        extend OpenAI::Internal::Type::RequestParameters::Converter
+        include OpenAI::Internal::Type::RequestParameters
+
+        # Creates a voice from a consent recording and an audio sample. Requires
+        # multipart/form-data.
+        attr_accessor body: OpenAI::Models::Audio::VoiceCreateParams::body
+
+        # @param body
+        #   Creates a voice from a consent recording and an audio sample. Requires
+        #   multipart/form-data.
+        def initialize: (
+          body: OpenAI::Models::Audio::VoiceCreateParams::body,
+          ?request_options: OpenAI::request_opts
+        ) -> void
+
+        def to_hash: -> {
+          body: OpenAI::Models::Audio::VoiceCreateParams::body,
+          ?request_options: OpenAI::RequestOptions
+        }
+
+        type body =
+          OpenAI::Audio::VoiceCreateParams::Body::AudioSample
+          | OpenAI::Audio::VoiceCreateParams::Body::Prompt
+
+        module Body
+          extend OpenAI::Internal::Type::Union
+
+          type audio_sample =
+            {
+              audio_sample: OpenAI::Internal::file_input,
+              consent: String,
+              name: String,
+              ?type: OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample::type_
+            }
+
+          class AudioSample < OpenAI::Internal::Type::BaseModel
+            # The sample audio recording file. Maximum size is 10 MiB.
+            #
+            # Supported MIME types: `audio/mpeg`, `audio/wav`, `audio/x-wav`, `audio/ogg`,
+            # `audio/aac`, `audio/flac`, `audio/webm`, `audio/mp4`.
+            #
+            # `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 audio_sample: OpenAI::Internal::file_input
+
+            # The consent recording ID (for example, `cons_1234`).
+            attr_accessor consent: String
+
+            # The name of the new voice.
+            attr_accessor name: String
+
+            # The voice creation method. Defaults to `audio_sample` when omitted.
+            attr_reader type: OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample::type_?
+
+            # The voice creation method. Defaults to `audio_sample` when omitted.
+            def type=: (
+              OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample::type_
+            ) -> OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample::type_
+
+            # @param audio_sample
+            #   The sample audio recording file. Maximum size is 10 MiB.
+            #
+            #   Supported MIME types: `audio/mpeg`, `audio/wav`, `audio/x-wav`, `audio/ogg`,
+            #   `audio/aac`, `audio/flac`, `audio/webm`, `audio/mp4`.
+            #
+            #   `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 consent
+            #   The consent recording ID (for example, `cons_1234`).
+            # @param name
+            #   The name of the new voice.
+            # @param type
+            #   The voice creation method. Defaults to `audio_sample` when omitted.
+            def initialize: (
+              audio_sample: OpenAI::Internal::file_input,
+              consent: String,
+              name: String,
+              ?type: OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample::type_
+            ) -> void
+
+            def to_hash: -> {
+              audio_sample: OpenAI::Internal::file_input,
+              consent: String,
+              name: String,
+              ?type: OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample::type_
+            }
+
+            type type_ = :audio_sample
+
+            module Type
+              extend OpenAI::Internal::Type::Enum
+
+              AUDIO_SAMPLE: :audio_sample
+
+              def self?.values: -> ::Array[OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample::type_]
+            end
+          end
+
+          type prompt =
+            {
+              name: String,
+              prompt: String,
+              type: OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::type_,
+              ?model: OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::model,
+              ?script_hint: String
+            }
+
+          class Prompt < OpenAI::Internal::Type::BaseModel
+            # The name of the new voice.
+            attr_accessor name: String
+
+            # A description of the desired voice. Must not contain only whitespace.
+            attr_accessor prompt: String
+
+            # Set to `prompt` to create a voice from a text description.
+            attr_accessor type: OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::type_
+
+            # The voice creation model to use. Defaults to `auto`.
+            attr_reader model: OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::model?
+
+            # The voice creation model to use. Defaults to `auto`.
+            def model=: (
+              OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::model
+            ) -> OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::model
+
+            # Optional text for the voice to speak during creation. If omitted, a script is
+            # generated from the prompt. Must not be blank after trimming whitespace; scripts
+            # that are too short are rejected.
+            attr_reader script_hint: String?
+
+            # Optional text for the voice to speak during creation. If omitted, a script is
+            # generated from the prompt. Must not be blank after trimming whitespace; scripts
+            # that are too short are rejected.
+            def script_hint=: (String) -> String
+
+            # @param name
+            #   The name of the new voice.
+            # @param prompt
+            #   A description of the desired voice. Must not contain only whitespace.
+            # @param type
+            #   Set to `prompt` to create a voice from a text description.
+            # @param model
+            #   The voice creation model to use. Defaults to `auto`.
+            # @param script_hint
+            #   Optional text for the voice to speak during creation. If omitted, a script is
+            #   generated from the prompt. Must not be blank after trimming whitespace; scripts
+            #   that are too short are rejected.
+            def initialize: (
+              name: String,
+              prompt: String,
+              type: OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::type_,
+              ?model: OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::model,
+              ?script_hint: String
+            ) -> void
+
+            def to_hash: -> {
+              name: String,
+              prompt: String,
+              type: OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::type_,
+              ?model: OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::model,
+              ?script_hint: String
+            }
+
+            type type_ = :prompt
+
+            module Type
+              extend OpenAI::Internal::Type::Enum
+
+              PROMPT: :prompt
+
+              def self?.values: -> ::Array[OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::type_]
+            end
+
+            type model = String | :auto | :"2026-10-01"
+
+            module Model
+              extend OpenAI::Internal::Type::Union
+
+              def self?.variants: -> ::Array[OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::model]
+
+              AUTO: :auto
+              MODEL_2026_10_01: :"2026-10-01"
+            end
+          end
+
+          def self?.variants: -> ::Array[OpenAI::Models::Audio::VoiceCreateParams::body]
+        end
+      end
+    end
+  end
+end

data/sig/openai/models/beta/agent_create_params.rbs

@@ -98,8 +98,7 @@ module OpenAI
           ?request_options: OpenAI::RequestOptions
         }
 
-        type service_tier =
-          :auto | :default | :flex | :priority | :fast | :ultrafast
+        type service_tier = :auto | :default | :flex | :priority | :fast
 
         module ServiceTier
           extend OpenAI::Internal::Type::Enum
@@ -119,9 +118,6 @@ module OpenAI
           # Uses the fast service tier.
           FAST: :fast
 
-          # Uses the ultrafast service tier.
-          ULTRAFAST: :ultrafast
-
           def self?.values: -> ::Array[OpenAI::Models::Beta::AgentCreateParams::service_tier]
         end
       end

data/sig/openai/models/beta/agent_update_params.rbs

@@ -106,8 +106,7 @@ module OpenAI
           ?request_options: OpenAI::RequestOptions
         }
 
-        type service_tier =
-          :auto | :default | :flex | :priority | :fast | :ultrafast
+        type service_tier = :auto | :default | :flex | :priority | :fast
 
         module ServiceTier
           extend OpenAI::Internal::Type::Enum
@@ -127,9 +126,6 @@ module OpenAI
           # Uses the fast service tier.
           FAST: :fast
 
-          # Uses the ultrafast service tier.
-          ULTRAFAST: :ultrafast
-
           def self?.values: -> ::Array[OpenAI::Models::Beta::AgentUpdateParams::service_tier]
         end
       end

data/sig/openai/models/beta/agents/session_create_params.rbs

@@ -163,8 +163,7 @@ module OpenAI
               ?tools: ::Array[OpenAI::Models::Beta::agent_tool_param]?
             }
 
-            type service_tier =
-              :auto | :default | :flex | :priority | :fast | :ultrafast
+            type service_tier = :auto | :default | :flex | :priority | :fast
 
             module ServiceTier
               extend OpenAI::Internal::Type::Enum
@@ -184,9 +183,6 @@ module OpenAI
               # Uses the fast service tier.
               FAST: :fast
 
-              # Uses the ultrafast service tier.
-              ULTRAFAST: :ultrafast
-
               def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::service_tier]
             end
           end

data/sig/openai/models/beta/agents/session_update_params.rbs

@@ -129,8 +129,7 @@ module OpenAI
               end
             end
 
-            type service_tier =
-              :auto | :default | :flex | :priority | :fast | :ultrafast
+            type service_tier = :auto | :default | :flex | :priority | :fast
 
             module ServiceTier
               extend OpenAI::Internal::Type::Enum
@@ -150,9 +149,6 @@ module OpenAI
               # Uses the fast service tier.
               FAST: :fast
 
-              # Uses the ultrafast service tier.
-              ULTRAFAST: :ultrafast
-
               def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent::service_tier]
             end
           end

data/sig/openai/models/beta/beta_tool.rbs

@@ -729,9 +729,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.
           attr_reader size: OpenAI::Models::Beta::BetaTool::ImageGeneration::size?
 
           # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
@@ -743,9 +741,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.
           def size=: (
             OpenAI::Models::Beta::BetaTool::ImageGeneration::size
           ) -> OpenAI::Models::Beta::BetaTool::ImageGeneration::size
@@ -800,9 +796,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.
           # @param type
           #   The type of the image generation tool. Always `image_generation`.
           def initialize: (

data/sig/openai/models/chat/chat_completion_audio_param.rbs

@@ -17,7 +17,8 @@ module OpenAI
         # The voice the model uses to respond. Supported built-in voices are `alloy`,
         # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
         # `marin`, and `cedar`. You may also provide a custom voice object with an `id`,
-        # for example `{ "id": "voice_1234" }`.
+        # for example `{ "id": "voice_1234" }`. Custom voices must be created from audio
+        # samples. Voices created from text prompts are supported only in Live.
         attr_accessor voice: OpenAI::Models::Chat::ChatCompletionAudioParam::voice
 
         # @param format_
@@ -27,7 +28,8 @@ module OpenAI
         #   The voice the model uses to respond. Supported built-in voices are `alloy`,
         #   `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
         #   `marin`, and `cedar`. You may also provide a custom voice object with an `id`,
-        #   for example `{ "id": "voice_1234" }`.
+        #   for example `{ "id": "voice_1234" }`. Custom voices must be created from audio
+        #   samples. Voices created from text prompts are supported only in Live.
         def initialize: (
           format_: OpenAI::Models::Chat::ChatCompletionAudioParam::format_,
           voice: OpenAI::Models::Chat::ChatCompletionAudioParam::voice

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
@@ -80,12 +77,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 +111,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 +148,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,
@@ -188,12 +178,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 +206,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 +314,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 +343,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