openai 0.60.0 → 0.62.0

data/rbi/openai/models/admin/organization/users/role_list_response.rbi

@@ -0,0 +1,128 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        module Users
+          class RoleListResponse < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Models::Admin::Organization::Users::RoleListResponse,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # Identifier for the role.
+            sig { returns(String) }
+            attr_accessor :id
+
+            # When the role was created.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :created_at
+
+            # Identifier of the actor who created the role.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :created_by
+
+            # User details for the actor that created the role, when available.
+            sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+            attr_accessor :created_by_user_obj
+
+            # Description of the role.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :description
+
+            # Arbitrary metadata stored on the role.
+            sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+            attr_accessor :metadata
+
+            # Name of the role.
+            sig { returns(String) }
+            attr_accessor :name
+
+            # Permissions associated with the role.
+            sig { returns(T::Array[String]) }
+            attr_accessor :permissions
+
+            # Whether the role is predefined by OpenAI.
+            sig { returns(T::Boolean) }
+            attr_accessor :predefined_role
+
+            # Resource type the role applies to.
+            sig { returns(String) }
+            attr_accessor :resource_type
+
+            # When the role was last updated.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :updated_at
+
+            # Detailed information about a role assignment entry returned when listing
+            # assignments.
+            sig do
+              params(
+                id: String,
+                created_at: T.nilable(Integer),
+                created_by: T.nilable(String),
+                created_by_user_obj: T.nilable(T::Hash[Symbol, T.anything]),
+                description: T.nilable(String),
+                metadata: T.nilable(T::Hash[Symbol, T.anything]),
+                name: String,
+                permissions: T::Array[String],
+                predefined_role: T::Boolean,
+                resource_type: String,
+                updated_at: T.nilable(Integer)
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Identifier for the role.
+              id:,
+              # When the role was created.
+              created_at:,
+              # Identifier of the actor who created the role.
+              created_by:,
+              # User details for the actor that created the role, when available.
+              created_by_user_obj:,
+              # Description of the role.
+              description:,
+              # Arbitrary metadata stored on the role.
+              metadata:,
+              # Name of the role.
+              name:,
+              # Permissions associated with the role.
+              permissions:,
+              # Whether the role is predefined by OpenAI.
+              predefined_role:,
+              # Resource type the role applies to.
+              resource_type:,
+              # When the role was last updated.
+              updated_at:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  id: String,
+                  created_at: T.nilable(Integer),
+                  created_by: T.nilable(String),
+                  created_by_user_obj: T.nilable(T::Hash[Symbol, T.anything]),
+                  description: T.nilable(String),
+                  metadata: T.nilable(T::Hash[Symbol, T.anything]),
+                  name: String,
+                  permissions: T::Array[String],
+                  predefined_role: T::Boolean,
+                  resource_type: String,
+                  updated_at: T.nilable(Integer)
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/chat/chat_completion_token_logprob.rbi

@@ -32,8 +32,7 @@ module OpenAI
         attr_accessor :logprob
 
         # 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`.
         sig do
           returns(
             T::Array[OpenAI::Chat::ChatCompletionTokenLogprob::TopLogprob]
@@ -65,8 +64,7 @@ module OpenAI
           # unlikely.
           logprob:,
           # 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`.
           top_logprobs:
         )
         end

data/rbi/openai/models/chat/completion_create_params.rbi

@@ -441,8 +441,9 @@ module OpenAI
         end
         attr_writer :tools
 
-        # 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.
         sig { returns(T.nilable(Integer)) }
         attr_accessor :top_logprobs
@@ -780,8 +781,9 @@ module OpenAI
           # [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
           # or [function tools](https://platform.openai.com/docs/guides/function-calling).
           tools: nil,
-          # 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.
           top_logprobs: nil,
           # An alternative to sampling with temperature, called nucleus sampling, where the

data/rbi/openai/models/image_edit_params.rbi

@@ -13,10 +13,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.
@@ -29,9 +29,14 @@ module OpenAI
       attr_accessor :prompt
 
       # 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`.
@@ -57,7 +62,10 @@ module OpenAI
       sig { params(mask: OpenAI::Internal::FileInput).void }
       attr_writer :mask
 
-      # 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`.
       sig { returns(T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol))) }
       attr_accessor :model
 
@@ -102,10 +110,22 @@ module OpenAI
       end
       attr_accessor :response_format
 
-      # 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`.
-      sig { returns(T.nilable(OpenAI::ImageEditParams::Size::OrSymbol)) }
+      # 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`.
+      sig do
+        returns(
+          T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol))
+        )
+      end
       attr_accessor :size
 
       # A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -134,7 +154,8 @@ module OpenAI
           quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
           response_format:
             T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
-          size: T.nilable(OpenAI::ImageEditParams::Size::OrSymbol),
+          size:
+            T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol)),
           user: String,
           request_options: OpenAI::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -142,10 +163,10 @@ module OpenAI
       def self.new(
         # 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.
@@ -154,9 +175,14 @@ module OpenAI
         # characters for `dall-e-2`, and 32000 characters for the GPT image models.
         prompt:,
         # 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`.
@@ -171,7 +197,10 @@ module OpenAI
         # the mask will be applied on the first image. Must be a valid PNG file, less than
         # 4MB, and have the same dimensions as `image`.
         mask: nil,
-        # 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`.
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
         n: nil,
@@ -198,9 +227,17 @@ module OpenAI
         # 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.
         response_format: nil,
-        # 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`.
         size: nil,
         # A unique identifier representing your end-user, which can help OpenAI to monitor
         # and detect abuse.
@@ -229,7 +266,8 @@ module OpenAI
             quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
             response_format:
               T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
-            size: T.nilable(OpenAI::ImageEditParams::Size::OrSymbol),
+            size:
+              T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol)),
             user: String,
             request_options: OpenAI::RequestOptions
           }
@@ -240,10 +278,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.
@@ -266,9 +304,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`.
@@ -318,7 +361,10 @@ module OpenAI
         end
       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
 
@@ -409,11 +455,30 @@ module OpenAI
         end
       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
+
+        Variants =
+          T.type_alias do
+            T.any(String, OpenAI::ImageEditParams::Size::TaggedSymbol)
+          end
+
+        sig do
+          override.returns(T::Array[OpenAI::ImageEditParams::Size::Variants])
+        end
+        def self.variants
+        end
 
         TaggedSymbol =
           T.type_alias { T.all(Symbol, OpenAI::ImageEditParams::Size) }
@@ -430,14 +495,6 @@ module OpenAI
         SIZE_1024X1536 =
           T.let(:"1024x1536", OpenAI::ImageEditParams::Size::TaggedSymbol)
         AUTO = T.let(:auto, OpenAI::ImageEditParams::Size::TaggedSymbol)
-
-        sig do
-          override.returns(
-            T::Array[OpenAI::ImageEditParams::Size::TaggedSymbol]
-          )
-        end
-        def self.values
-        end
       end
     end
   end

data/rbi/openai/models/image_generate_params.rbi

@@ -18,9 +18,14 @@ module OpenAI
       attr_accessor :prompt
 
       # 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`.
@@ -30,8 +35,9 @@ module OpenAI
       attr_accessor :background
 
       # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
-      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`). Defaults to
-      # `dall-e-2` unless a parameter specific to the GPT image models is used.
+      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+      # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
+      # to the GPT image models is used.
       sig { returns(T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol))) }
       attr_accessor :model
 
@@ -91,11 +97,22 @@ module OpenAI
       end
       attr_accessor :response_format
 
-      # The size of the generated images. Must be one of `1024x1024`, `1536x1024`
-      # (landscape), `1024x1536` (portrait), or `auto` (default value) for the GPT image
-      # models, one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`, and one of
-      # `1024x1024`, `1792x1024`, or `1024x1792` for `dall-e-3`.
-      sig { returns(T.nilable(OpenAI::ImageGenerateParams::Size::OrSymbol)) }
+      # 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`.
+      sig do
+        returns(
+          T.nilable(T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol))
+        )
+      end
       attr_accessor :size
 
       # The style of the generated images. This parameter is only supported for
@@ -130,7 +147,10 @@ module OpenAI
           quality: T.nilable(OpenAI::ImageGenerateParams::Quality::OrSymbol),
           response_format:
             T.nilable(OpenAI::ImageGenerateParams::ResponseFormat::OrSymbol),
-          size: T.nilable(OpenAI::ImageGenerateParams::Size::OrSymbol),
+          size:
+            T.nilable(
+              T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol)
+            ),
           style: T.nilable(OpenAI::ImageGenerateParams::Style::OrSymbol),
           user: String,
           request_options: OpenAI::RequestOptions::OrHash
@@ -142,16 +162,22 @@ module OpenAI
         # characters for `dall-e-3`.
         prompt:,
         # 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`.
         background: nil,
         # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
-        # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`). Defaults to
-        # `dall-e-2` unless a parameter specific to the GPT image models is used.
+        # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+        # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
+        # to the GPT image models is used.
         model: nil,
         # Control the content-moderation level for images generated by the GPT image
         # models. Must be either `low` for less restrictive filtering or `auto` (default
@@ -187,10 +213,17 @@ module OpenAI
         # after the image has been generated. This parameter isn't supported for the GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
-        # The size of the generated images. Must be one of `1024x1024`, `1536x1024`
-        # (landscape), `1024x1536` (portrait), or `auto` (default value) for the GPT image
-        # models, one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`, and one of
-        # `1024x1024`, `1792x1024`, or `1024x1792` for `dall-e-3`.
+        # 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`.
         size: nil,
         # The style of the generated images. This parameter is only supported for
         # `dall-e-3`. Must be one of `vivid` or `natural`. Vivid causes the model to lean
@@ -222,7 +255,10 @@ module OpenAI
             quality: T.nilable(OpenAI::ImageGenerateParams::Quality::OrSymbol),
             response_format:
               T.nilable(OpenAI::ImageGenerateParams::ResponseFormat::OrSymbol),
-            size: T.nilable(OpenAI::ImageGenerateParams::Size::OrSymbol),
+            size:
+              T.nilable(
+                T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol)
+              ),
             style: T.nilable(OpenAI::ImageGenerateParams::Style::OrSymbol),
             user: String,
             request_options: OpenAI::RequestOptions
@@ -233,9 +269,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`.
@@ -268,8 +309,9 @@ module OpenAI
       end
 
       # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
-      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`). Defaults to
-      # `dall-e-2` unless a parameter specific to the GPT image models is used.
+      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+      # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
+      # to the GPT image models is used.
       module Model
         extend OpenAI::Internal::Type::Union
 
@@ -399,12 +441,32 @@ module OpenAI
         end
       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, one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`, and one of
-      # `1024x1024`, `1792x1024`, or `1024x1792` for `dall-e-3`.
+      # 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
+
+        Variants =
+          T.type_alias do
+            T.any(String, OpenAI::ImageGenerateParams::Size::TaggedSymbol)
+          end
+
+        sig do
+          override.returns(
+            T::Array[OpenAI::ImageGenerateParams::Size::Variants]
+          )
+        end
+        def self.variants
+        end
 
         TaggedSymbol =
           T.type_alias { T.all(Symbol, OpenAI::ImageGenerateParams::Size) }
@@ -425,14 +487,6 @@ module OpenAI
           T.let(:"1792x1024", OpenAI::ImageGenerateParams::Size::TaggedSymbol)
         SIZE_1024X1792 =
           T.let(:"1024x1792", OpenAI::ImageGenerateParams::Size::TaggedSymbol)
-
-        sig do
-          override.returns(
-            T::Array[OpenAI::ImageGenerateParams::Size::TaggedSymbol]
-          )
-        end
-        def self.values
-        end
       end
 
       # The style of the generated images. This parameter is only supported for

data/rbi/openai/models/image_model.rbi

@@ -8,12 +8,17 @@ module OpenAI
       TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::ImageModel) }
       OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-      GPT_IMAGE_1_5 = T.let(:"gpt-image-1.5", OpenAI::ImageModel::TaggedSymbol)
-      DALL_E_2 = T.let(:"dall-e-2", OpenAI::ImageModel::TaggedSymbol)
-      DALL_E_3 = T.let(:"dall-e-3", OpenAI::ImageModel::TaggedSymbol)
       GPT_IMAGE_1 = T.let(:"gpt-image-1", OpenAI::ImageModel::TaggedSymbol)
       GPT_IMAGE_1_MINI =
         T.let(:"gpt-image-1-mini", OpenAI::ImageModel::TaggedSymbol)
+      GPT_IMAGE_2 = T.let(:"gpt-image-2", OpenAI::ImageModel::TaggedSymbol)
+      GPT_IMAGE_2_2026_04_21 =
+        T.let(:"gpt-image-2-2026-04-21", OpenAI::ImageModel::TaggedSymbol)
+      GPT_IMAGE_1_5 = T.let(:"gpt-image-1.5", OpenAI::ImageModel::TaggedSymbol)
+      CHATGPT_IMAGE_LATEST =
+        T.let(:"chatgpt-image-latest", OpenAI::ImageModel::TaggedSymbol)
+      DALL_E_2 = T.let(:"dall-e-2", OpenAI::ImageModel::TaggedSymbol)
+      DALL_E_3 = T.let(:"dall-e-3", OpenAI::ImageModel::TaggedSymbol)
 
       sig { override.returns(T::Array[OpenAI::ImageModel::TaggedSymbol]) }
       def self.values