openai 0.61.0 → 0.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05f5bfabea5cbd601fcd33a8ed3e6f8bbf52dde251998c77e16163c10dfb6a65
-  data.tar.gz: 0c83764f6e4316cc7bc6fa3d0bfc19f855f144f4964df5c98e3dee4a8a7839d9
+  metadata.gz: 8b8ba7d86e2a095f264f3249f65a5b7023ed92f5d72b254537d2131343d008d1
+  data.tar.gz: b2473fbb12916be311368b3ce12ec183118c94fecba86145f0765ddb261d34be
 SHA512:
-  metadata.gz: 01cd6adcb14ef5e12dda7fc68c127bd57dd2a9920b2909dd75f4297943eb701a6dd94f0eda0e7a94541a209deab6e9f0c0f8f584b86f672c7cb6852a918e3374
-  data.tar.gz: e3644e138d68134533429bbd705268c3d03514664a7cb9b188d55fa978827fb95ffa7a92d3f361413fce836229cb4f45fa636cb105470f07220a5d3df964c578
+  metadata.gz: 4c6c2cdd0fb69bcf6df1bedab9f82904812aedcca80e43dc378eb36c213b1975b439040c26432ab29ddac79c938c361000f7de2508255632eea04dc220593bfa
+  data.tar.gz: 99dba44fb87261cefba089bfea34b90d09848e85e4be6e682f277c1a8f9a6cbfb9d7a51b9f99b918e0fe5ebc80f3321180af4ebde21268d920ed9e09cf103321

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.62.0 (2026-05-07)
+
+Full Changelog: [v0.61.0...v0.62.0](https://github.com/openai/openai-ruby/compare/v0.61.0...v0.62.0)
+
+### Features
+
+* **api:** add quantity field to organization usage costs results ([2085700](https://github.com/openai/openai-ruby/commit/2085700725c2325e880a715ce3b13b4efce7b5d4))
+* **api:** add web_search_call.results includable option ([b486412](https://github.com/openai/openai-ruby/commit/b4864127789424527497aa6097d93ea06e9aa4f7))
+* **api:** launch realtime translate + update image 2 ([0e642fb](https://github.com/openai/openai-ruby/commit/0e642fbf02845ff94b8eda0fca7e8348adc3ac37))
+* **api:** manual updates ([4baf155](https://github.com/openai/openai-ruby/commit/4baf155ef74ffdf533dfba330e15f7accf1e5351))
+* **api:** manual updates ([20c8209](https://github.com/openai/openai-ruby/commit/20c82091b6c24668e90ed895dfc7e88b0aafd977))
+* **api:** realtime 2 ([1718781](https://github.com/openai/openai-ruby/commit/17187817c580b642d61ea754aa63782a16af94bc))
+
+
+### Bug Fixes
+
+* **api:** fix imagegen `size` enum regression ([51548cd](https://github.com/openai/openai-ruby/commit/51548cd04ab8f3a16e980bd2318ddb42ee75ce6c))
+
 ## 0.61.0 (2026-05-01)
 
 Full Changelog: [v0.60.0...v0.61.0](https://github.com/openai/openai-ruby/compare/v0.60.0...v0.61.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.61.0"
+gem "openai", "~> 0.62.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/models/admin/organization/usage_audio_speeches_response.rb

@@ -684,7 +684,14 @@ module OpenAI
                 #   @return [String, nil]
                 optional :project_id, String, nil?: true
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, object: :"organization.costs.result")
+                # @!attribute quantity
+                #   When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #   result.
+                #
+                #   @return [Float, nil]
+                optional :quantity, Float, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, object: :"organization.costs.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult}
                 #   for more details.
@@ -699,6 +706,8 @@ module OpenAI
                 #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped co
                 #
+                #   @param quantity [Float, nil] When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult#amount

data/lib/openai/models/admin/organization/usage_audio_transcriptions_response.rb

@@ -684,7 +684,14 @@ module OpenAI
                 #   @return [String, nil]
                 optional :project_id, String, nil?: true
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, object: :"organization.costs.result")
+                # @!attribute quantity
+                #   When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #   result.
+                #
+                #   @return [Float, nil]
+                optional :quantity, Float, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, object: :"organization.costs.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageAudioTranscriptionsResponse::Data::Result::OrganizationCostsResult}
                 #   for more details.
@@ -699,6 +706,8 @@ module OpenAI
                 #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped co
                 #
+                #   @param quantity [Float, nil] When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageAudioTranscriptionsResponse::Data::Result::OrganizationCostsResult#amount

data/lib/openai/models/admin/organization/usage_code_interpreter_sessions_response.rb

@@ -684,7 +684,14 @@ module OpenAI
                 #   @return [String, nil]
                 optional :project_id, String, nil?: true
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, object: :"organization.costs.result")
+                # @!attribute quantity
+                #   When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #   result.
+                #
+                #   @return [Float, nil]
+                optional :quantity, Float, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, object: :"organization.costs.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult}
                 #   for more details.
@@ -699,6 +706,8 @@ module OpenAI
                 #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped co
                 #
+                #   @param quantity [Float, nil] When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageCodeInterpreterSessionsResponse::Data::Result::OrganizationCostsResult#amount

data/lib/openai/models/admin/organization/usage_completions_response.rb

@@ -684,7 +684,14 @@ module OpenAI
                 #   @return [String, nil]
                 optional :project_id, String, nil?: true
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, object: :"organization.costs.result")
+                # @!attribute quantity
+                #   When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #   result.
+                #
+                #   @return [Float, nil]
+                optional :quantity, Float, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, object: :"organization.costs.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult}
                 #   for more details.
@@ -699,6 +706,8 @@ module OpenAI
                 #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped co
                 #
+                #   @param quantity [Float, nil] When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageCompletionsResponse::Data::Result::OrganizationCostsResult#amount

data/lib/openai/models/admin/organization/usage_costs_response.rb

@@ -684,7 +684,14 @@ module OpenAI
                 #   @return [String, nil]
                 optional :project_id, String, nil?: true
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, object: :"organization.costs.result")
+                # @!attribute quantity
+                #   When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #   result.
+                #
+                #   @return [Float, nil]
+                optional :quantity, Float, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, object: :"organization.costs.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageCostsResponse::Data::Result::OrganizationCostsResult}
                 #   for more details.
@@ -699,6 +706,8 @@ module OpenAI
                 #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped co
                 #
+                #   @param quantity [Float, nil] When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageCostsResponse::Data::Result::OrganizationCostsResult#amount

data/lib/openai/models/admin/organization/usage_embeddings_response.rb

@@ -684,7 +684,14 @@ module OpenAI
                 #   @return [String, nil]
                 optional :project_id, String, nil?: true
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, object: :"organization.costs.result")
+                # @!attribute quantity
+                #   When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #   result.
+                #
+                #   @return [Float, nil]
+                optional :quantity, Float, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, object: :"organization.costs.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageEmbeddingsResponse::Data::Result::OrganizationCostsResult}
                 #   for more details.
@@ -699,6 +706,8 @@ module OpenAI
                 #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped co
                 #
+                #   @param quantity [Float, nil] When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageEmbeddingsResponse::Data::Result::OrganizationCostsResult#amount

data/lib/openai/models/admin/organization/usage_images_response.rb

@@ -684,7 +684,14 @@ module OpenAI
                 #   @return [String, nil]
                 optional :project_id, String, nil?: true
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, object: :"organization.costs.result")
+                # @!attribute quantity
+                #   When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #   result.
+                #
+                #   @return [Float, nil]
+                optional :quantity, Float, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, object: :"organization.costs.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageImagesResponse::Data::Result::OrganizationCostsResult}
                 #   for more details.
@@ -699,6 +706,8 @@ module OpenAI
                 #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped co
                 #
+                #   @param quantity [Float, nil] When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageImagesResponse::Data::Result::OrganizationCostsResult#amount

data/lib/openai/models/admin/organization/usage_moderations_response.rb

@@ -684,7 +684,14 @@ module OpenAI
                 #   @return [String, nil]
                 optional :project_id, String, nil?: true
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, object: :"organization.costs.result")
+                # @!attribute quantity
+                #   When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #   result.
+                #
+                #   @return [Float, nil]
+                optional :quantity, Float, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, object: :"organization.costs.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageModerationsResponse::Data::Result::OrganizationCostsResult}
                 #   for more details.
@@ -699,6 +706,8 @@ module OpenAI
                 #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped co
                 #
+                #   @param quantity [Float, nil] When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageModerationsResponse::Data::Result::OrganizationCostsResult#amount

data/lib/openai/models/admin/organization/usage_vector_stores_response.rb

@@ -684,7 +684,14 @@ module OpenAI
                 #   @return [String, nil]
                 optional :project_id, String, nil?: true
 
-                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, object: :"organization.costs.result")
+                # @!attribute quantity
+                #   When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #   result.
+                #
+                #   @return [Float, nil]
+                optional :quantity, Float, nil?: true
+
+                # @!method initialize(amount: nil, api_key_id: nil, line_item: nil, project_id: nil, quantity: nil, object: :"organization.costs.result")
                 #   Some parameter documentations has been truncated, see
                 #   {OpenAI::Models::Admin::Organization::UsageVectorStoresResponse::Data::Result::OrganizationCostsResult}
                 #   for more details.
@@ -699,6 +706,8 @@ module OpenAI
                 #
                 #   @param project_id [String, nil] When `group_by=project_id`, this field provides the project ID of the grouped co
                 #
+                #   @param quantity [Float, nil] When `group_by=line_item`, this field provides the quantity of the grouped costs
+                #
                 #   @param object [Symbol, :"organization.costs.result"]
 
                 # @see OpenAI::Models::Admin::Organization::UsageVectorStoresResponse::Data::Result::OrganizationCostsResult#amount

data/lib/openai/models/chat/chat_completion_token_logprob.rb

@@ -29,8 +29,7 @@ module OpenAI
 
         # @!attribute top_logprobs
         #   List of the most likely tokens and their log probability, at this token
-        #   position. In rare cases, there may be fewer than the number of requested
-        #   `top_logprobs` returned.
+        #   position. The number of entries may be fewer than the requested `top_logprobs`.
         #
         #   @return [Array<OpenAI::Models::Chat::ChatCompletionTokenLogprob::TopLogprob>]
         required :top_logprobs,

data/lib/openai/models/chat/completion_create_params.rb

@@ -340,8 +340,9 @@ module OpenAI
                  }
 
         # @!attribute top_logprobs
-        #   An integer between 0 and 20 specifying the number of most likely tokens to
-        #   return at each token position, each with an associated log probability.
+        #   An integer between 0 and 20 specifying the maximum number of most likely tokens
+        #   to return at each token position, each with an associated log probability. In
+        #   some cases, the number of returned tokens may be fewer than requested.
         #   `logprobs` must be set to `true` if this parameter is used.
         #
         #   @return [Integer, nil]
@@ -447,7 +448,7 @@ module OpenAI
         #
         #   @param tools [Array<OpenAI::StructuredOutput::JsonSchemaConverter, OpenAI::Models::Chat::ChatCompletionFunctionTool, OpenAI::Models::Chat::ChatCompletionCustomTool>] A list of tools the model may call. You can provide either
         #
-        #   @param top_logprobs [Integer, nil] An integer between 0 and 20 specifying the number of most likely tokens to
+        #   @param top_logprobs [Integer, nil] An integer between 0 and 20 specifying the maximum number of most likely
         #
         #   @param top_p [Float, nil] An alternative to sampling with temperature, called nucleus sampling,
         #

data/lib/openai/models/image_edit_params.rb

@@ -12,10 +12,10 @@ module OpenAI
       # @!attribute image
       #   The image(s) to edit. Must be a supported image file or an array of images.
       #
-      #   For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, and
-      #   `gpt-image-1.5`), each image should be a `png`, `webp`, or `jpg` file less than
-      #   50MB. You can provide up to 16 images. `chatgpt-image-latest` follows the same
-      #   input constraints as GPT image models.
+      #   For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
+      #   `gpt-image-2`, `gpt-image-2-2026-04-21`, and `chatgpt-image-latest`), each image
+      #   should be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to
+      #   16 images.
       #
       #   For `dall-e-2`, you can only provide one image, and it should be a square `png`
       #   file less than 4MB.
@@ -32,9 +32,14 @@ module OpenAI
 
       # @!attribute background
       #   Allows to set transparency for the background of the generated image(s). This
-      #   parameter is only supported for the GPT image models. Must be one of
-      #   `transparent`, `opaque` or `auto` (default value). When `auto` is used, the
-      #   model will automatically determine the best background for the image.
+      #   parameter is only supported for GPT image models that support transparent
+      #   backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value).
+      #   When `auto` is used, the model will automatically determine the best background
+      #   for the image.
+      #
+      #   `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent
+      #   backgrounds. Requests with `background` set to `transparent` will return an
+      #   error for these models; use `opaque` or `auto` instead.
       #
       #   If `transparent`, the output format needs to support transparency, so it should
       #   be set to either `png` (default value) or `webp`.
@@ -61,7 +66,10 @@ module OpenAI
       optional :mask, OpenAI::Internal::Type::FileInput
 
       # @!attribute model
-      #   The model to use for image generation. Defaults to `gpt-image-1.5`.
+      #   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`, or `chatgpt-image-latest`). Defaults to
+      #   `gpt-image-1.5`.
       #
       #   @return [String, Symbol, OpenAI::Models::ImageModel, nil]
       optional :model, union: -> { OpenAI::ImageEditParams::Model }, nil?: true
@@ -116,12 +124,20 @@ module OpenAI
       optional :response_format, enum: -> { OpenAI::ImageEditParams::ResponseFormat }, nil?: true
 
       # @!attribute size
-      #   The size of the generated images. Must be one of `1024x1024`, `1536x1024`
-      #   (landscape), `1024x1536` (portrait), or `auto` (default value) for the GPT image
-      #   models, and one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`.
-      #
-      #   @return [Symbol, OpenAI::Models::ImageEditParams::Size, nil]
-      optional :size, enum: -> { OpenAI::ImageEditParams::Size }, nil?: true
+      #   The size of the generated images. For `gpt-image-2` and
+      #   `gpt-image-2-2026-04-21`, 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`.
+      #
+      #   @return [String, Symbol, OpenAI::Models::ImageEditParams::Size, nil]
+      optional :size, union: -> { OpenAI::ImageEditParams::Size }, nil?: true
 
       # @!attribute user
       #   A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -145,7 +161,7 @@ module OpenAI
       #
       #   @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart] An additional image whose fully transparent areas (e.g. where alpha is zero) ind
       #
-      #   @param model [String, Symbol, OpenAI::Models::ImageModel, nil] The model to use for image generation. Defaults to `gpt-image-1.5`.
+      #   @param model [String, Symbol, OpenAI::Models::ImageModel, nil] The model to use for image generation. One of `dall-e-2` or a GPT image model (`
       #
       #   @param n [Integer, nil] The number of images to generate. Must be between 1 and 10.
       #
@@ -159,7 +175,7 @@ module OpenAI
       #
       #   @param response_format [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil] The format in which the generated images are returned. Must be one of `url` or `
       #
-      #   @param size [Symbol, OpenAI::Models::ImageEditParams::Size, nil] The size of the generated images. Must be one of `1024x1024`, `1536x1024` (lands
+      #   @param size [String, Symbol, OpenAI::Models::ImageEditParams::Size, nil] The size of the generated images. For `gpt-image-2` and `gpt-image-2-2026-04-21`
       #
       #   @param user [String] A unique identifier representing your end-user, which can help OpenAI to monitor
       #
@@ -167,10 +183,10 @@ module OpenAI
 
       # The image(s) to edit. Must be a supported image file or an array of images.
       #
-      # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, and
-      # `gpt-image-1.5`), each image should be a `png`, `webp`, or `jpg` file less than
-      # 50MB. You can provide up to 16 images. `chatgpt-image-latest` follows the same
-      # input constraints as GPT image models.
+      # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
+      # `gpt-image-2`, `gpt-image-2-2026-04-21`, and `chatgpt-image-latest`), each image
+      # should be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to
+      # 16 images.
       #
       # For `dall-e-2`, you can only provide one image, and it should be a square `png`
       # file less than 4MB.
@@ -189,9 +205,14 @@ module OpenAI
       end
 
       # Allows to set transparency for the background of the generated image(s). This
-      # parameter is only supported for the GPT image models. Must be one of
-      # `transparent`, `opaque` or `auto` (default value). When `auto` is used, the
-      # model will automatically determine the best background for the image.
+      # parameter is only supported for GPT image models that support transparent
+      # backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value).
+      # When `auto` is used, the model will automatically determine the best background
+      # for the image.
+      #
+      # `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent
+      # backgrounds. Requests with `background` set to `transparent` will return an
+      # error for these models; use `opaque` or `auto` instead.
       #
       # If `transparent`, the output format needs to support transparency, so it should
       # be set to either `png` (default value) or `webp`.
@@ -220,13 +241,16 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # The model to use for image generation. Defaults to `gpt-image-1.5`.
+      # 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`, or `chatgpt-image-latest`). Defaults to
+      # `gpt-image-1.5`.
       module Model
         extend OpenAI::Internal::Type::Union
 
         variant String
 
-        # The model to use for image generation. Defaults to `gpt-image-1.5`.
+        # 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`, or `chatgpt-image-latest`). Defaults to `gpt-image-1.5`.
         variant enum: -> { OpenAI::ImageModel }
 
         # @!method self.variants
@@ -276,11 +300,42 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # The size of the generated images. Must be one of `1024x1024`, `1536x1024`
-      # (landscape), `1024x1536` (portrait), or `auto` (default value) for the GPT image
-      # models, and one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`.
+      # The size of the generated images. For `gpt-image-2` and
+      # `gpt-image-2-2026-04-21`, 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`.
       module Size
-        extend OpenAI::Internal::Type::Enum
+        extend OpenAI::Internal::Type::Union
+
+        variant String
+
+        variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_256X256 }
+
+        variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_512X512 }
+
+        variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_1024X1024 }
+
+        variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_1536X1024 }
+
+        variant const: -> { OpenAI::Models::ImageEditParams::Size::SIZE_1024X1536 }
+
+        variant const: -> { OpenAI::Models::ImageEditParams::Size::AUTO }
+
+        # @!method self.variants
+        #   @return [Array(String, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(String, OpenAI::ImageEditParams::Size::TaggedSymbol) }
+        end
+
+        # @!group
 
         SIZE_256X256 = :"256x256"
         SIZE_512X512 = :"512x512"
@@ -289,8 +344,7 @@ module OpenAI
         SIZE_1024X1536 = :"1024x1536"
         AUTO = :auto
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+        # @!endgroup
       end
     end
   end