openai 0.97.0 → 0.99.0

data/sig/openai/models/beta/agents/vaults/credential.rbs

@@ -8,7 +8,7 @@ module OpenAI
               id: String,
               auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth,
               created_at: Integer,
-              metadata: ::Hash[Symbol, String],
+              ?metadata: ::Hash[Symbol, String],
               name: String,
               ?object: :"vault.credential",
               updated_at: Integer,
@@ -46,24 +46,24 @@ module OpenAI
             #   The authentication method and non-secret configuration of the credential.
             # @param created_at
             #   The Unix timestamp, in seconds, when the credential was created.
-            # @param metadata
-            #   Application-defined key-value pairs associated with this credential.
             # @param name
             #   The human-readable name of the credential.
             # @param updated_at
             #   The Unix timestamp, in seconds, when the credential was last updated.
             # @param vault_id
             #   The ID of the vault containing this credential.
+            # @param metadata
+            #   Application-defined key-value pairs associated with this credential.
             # @param object
             #   The object type. Always `vault.credential`.
             def initialize: (
               id: String,
               auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth,
               created_at: Integer,
-              metadata: ::Hash[Symbol, String],
               name: String,
               updated_at: Integer,
               vault_id: String,
+              ?metadata: ::Hash[Symbol, String],
               ?object: :"vault.credential"
             ) -> void
 
@@ -71,7 +71,7 @@ module OpenAI
               id: String,
               auth: OpenAI::Models::Beta::Agents::Vaults::credential_auth,
               created_at: Integer,
-              metadata: ::Hash[Symbol, String],
+              ?metadata: ::Hash[Symbol, String],
               name: String,
               ?object: :"vault.credential",
               updated_at: Integer,

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

@@ -71,7 +71,7 @@ module OpenAI
             # The filename of the file cited.
             attr_accessor filename: String
 
-            # The index of the file in the list of files.
+            # The index in the output text at which to insert the file citation.
             attr_accessor index: Integer
 
             # The type of the file citation. Always `file_citation`.
@@ -82,7 +82,7 @@ module OpenAI
             # @param filename
             #   The filename of the file cited.
             # @param index
-            #   The index of the file in the list of files.
+            #   The index in the output text at which to insert the file citation.
             # @param type
             #   The type of the file citation. Always `file_citation`.
             def initialize: (

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

@@ -102,7 +102,7 @@ module OpenAI
             # The filename of the file cited.
             attr_accessor filename: String
 
-            # The index of the file in the list of files.
+            # The index in the output text at which to insert the file citation.
             attr_accessor index: Integer
 
             # The type of the file citation. Always `file_citation`.
@@ -113,7 +113,7 @@ module OpenAI
             # @param filename
             #   The filename of the file cited.
             # @param index
-            #   The index of the file in the list of files.
+            #   The index in the output text at which to insert the file citation.
             # @param type
             #   The type of the file citation. Always `file_citation`.
             def initialize: (

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/beta/environment.rbs

@@ -32,6 +32,7 @@ module OpenAI
             plugins: ::Array[OpenAI::Beta::HostedPlugin],
             skills: ::Array[OpenAI::Models::Beta::hosted_skill],
             ?type: :openai_hosted,
+            ?container_size: OpenAI::Models::Beta::Environment::OpenAIHosted::container_size?,
             ?desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop
           }
 
@@ -60,6 +61,10 @@ module OpenAI
           # The type of the object. Always `openai_hosted`.
           attr_accessor type: :openai_hosted
 
+          # The effective CPU and memory tier, or null when unknown or outside the public
+          # tiers.
+          attr_accessor container_size: OpenAI::Models::Beta::Environment::OpenAIHosted::container_size?
+
           # The effective desktop configuration.
           attr_reader desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop?
 
@@ -82,6 +87,9 @@ module OpenAI
           #   Plugins installed in the environment, excluding their archive contents.
           # @param skills
           #   Skills installed in the environment, excluding their archive contents.
+          # @param container_size
+          #   The effective CPU and memory tier, or null when unknown or outside the public
+          #   tiers.
           # @param desktop
           #   The effective desktop configuration.
           # @param type
@@ -94,6 +102,7 @@ module OpenAI
             packages: OpenAI::Beta::Environment::OpenAIHosted::Packages,
             plugins: ::Array[OpenAI::Beta::HostedPlugin],
             skills: ::Array[OpenAI::Models::Beta::hosted_skill],
+            ?container_size: OpenAI::Models::Beta::Environment::OpenAIHosted::container_size?,
             ?desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop,
             ?type: :openai_hosted
           ) -> void
@@ -107,6 +116,7 @@ module OpenAI
             plugins: ::Array[OpenAI::Beta::HostedPlugin],
             skills: ::Array[OpenAI::Models::Beta::hosted_skill],
             ?type: :openai_hosted,
+            ?container_size: OpenAI::Models::Beta::Environment::OpenAIHosted::container_size?,
             ?desktop: OpenAI::Beta::Environment::OpenAIHosted::Desktop
           }
 
@@ -191,6 +201,18 @@ module OpenAI
             }
           end
 
+          type container_size = :small | :medium | :large
+
+          module ContainerSize
+            extend OpenAI::Internal::Type::Enum
+
+            SMALL: :small
+            MEDIUM: :medium
+            LARGE: :large
+
+            def self?.values: -> ::Array[OpenAI::Models::Beta::Environment::OpenAIHosted::container_size]
+          end
+
           type desktop = { enabled: bool }
 
           class Desktop < OpenAI::Internal::Type::BaseModel

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

@@ -26,6 +26,7 @@ module OpenAI
           {
             ?type: :openai_hosted,
             ?capability_directories: ::Array[String]?,
+            ?container_size: OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::container_size,
             ?desktop: OpenAI::Beta::EnvironmentParam::OpenAIHosted::Desktop?,
             ?env: ::Hash[Symbol, String]?,
             ?environment_template_id: String,
@@ -45,6 +46,14 @@ module OpenAI
           # list.
           attr_accessor capability_directories: ::Array[String]?
 
+          # The hosted container size. Omission selects the medium tier.
+          attr_reader container_size: OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::container_size?
+
+          # The hosted container size. Omission selects the medium tier.
+          def container_size=: (
+            OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::container_size
+          ) -> OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::container_size
+
           # Desktop provisioning. Omission or null inherits the template setting, or
           # defaults to disabled.
           attr_accessor desktop: OpenAI::Beta::EnvironmentParam::OpenAIHosted::Desktop?
@@ -83,6 +92,8 @@ module OpenAI
           # @param capability_directories
           #   Directories that contain capabilities exposed to the agent. Defaults to an empty
           #   list.
+          # @param container_size
+          #   The hosted container size. Omission selects the medium tier.
           # @param desktop
           #   Desktop provisioning. Omission or null inherits the template setting, or
           #   defaults to disabled.
@@ -109,6 +120,7 @@ module OpenAI
           #   The type of the object. Always `openai_hosted`.
           def initialize: (
             ?capability_directories: ::Array[String]?,
+            ?container_size: OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::container_size,
             ?desktop: OpenAI::Beta::EnvironmentParam::OpenAIHosted::Desktop?,
             ?env: ::Hash[Symbol, String]?,
             ?environment_template_id: String,
@@ -124,6 +136,7 @@ module OpenAI
           def to_hash: -> {
             ?type: :openai_hosted,
             ?capability_directories: ::Array[String]?,
+            ?container_size: OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::container_size,
             ?desktop: OpenAI::Beta::EnvironmentParam::OpenAIHosted::Desktop?,
             ?env: ::Hash[Symbol, String]?,
             ?environment_template_id: String,
@@ -135,6 +148,18 @@ module OpenAI
             ?skills: ::Array[OpenAI::Models::Beta::hosted_skill_param]?
           }
 
+          type container_size = :small | :medium | :large
+
+          module ContainerSize
+            extend OpenAI::Internal::Type::Enum
+
+            SMALL: :small
+            MEDIUM: :medium
+            LARGE: :large
+
+            def self?.values: -> ::Array[OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::container_size]
+          end
+
           type desktop = { enabled: bool }
 
           class Desktop < OpenAI::Internal::Type::BaseModel

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

@@ -31,6 +31,7 @@ module OpenAI
           | :usage_limit_exceeded
           | :credit_balance_exhausted
           | :rate_limit_exceeded
+          | :flex_unavailable
           | :server_overloaded
           | :cyber_policy
           | :misalignment_policy_violation
@@ -63,6 +64,9 @@ module OpenAI
           # The request exceeds the available rate limit.
           RATE_LIMIT_EXCEEDED: :rate_limit_exceeded
 
+          # Flex processing is temporarily unavailable.
+          FLEX_UNAVAILABLE: :flex_unavailable
+
           # The model service is temporarily overloaded.
           SERVER_OVERLOADED: :server_overloaded
 

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/chat/chat_completion_content_part_image.rbs

@@ -81,7 +81,7 @@ module OpenAI
             ?detail: OpenAI::Models::Chat::ChatCompletionContentPartImage::ImageURL::detail
           }
 
-          type detail = :auto | :low | :high
+          type detail = :auto | :low | :high | :original
 
           module Detail
             extend OpenAI::Internal::Type::Enum
@@ -89,6 +89,7 @@ module OpenAI
             AUTO: :auto
             LOW: :low
             HIGH: :high
+            ORIGINAL: :original
 
             def self?.values: -> ::Array[OpenAI::Models::Chat::ChatCompletionContentPartImage::ImageURL::detail]
           end

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