openai 0.60.0 → 0.62.0

data/rbi/openai/models/responses/tool.rbi

@@ -926,8 +926,18 @@ module OpenAI
           end
           attr_writer :action
 
-          # Background type for the generated image. One of `transparent`, `opaque`, or
-          # `auto`. Default: `auto`.
+          # Allows to set transparency for the background of the generated image(s). This
+          # 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`.
           sig do
             returns(
               T.nilable(
@@ -1072,12 +1082,24 @@ module OpenAI
           end
           attr_writer :quality
 
-          # The size of the generated image. One of `1024x1024`, `1024x1536`, `1536x1024`,
-          # or `auto`. Default: `auto`.
+          # 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(
-                OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                T.any(
+                  String,
+                  OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                )
               )
             )
           end
@@ -1085,7 +1107,11 @@ module OpenAI
 
           sig do
             params(
-              size: OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+              size:
+                T.any(
+                  String,
+                  OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                )
             ).void
           end
           attr_writer :size
@@ -1116,15 +1142,29 @@ module OpenAI
               partial_images: Integer,
               quality:
                 OpenAI::Responses::Tool::ImageGeneration::Quality::OrSymbol,
-              size: OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol,
+              size:
+                T.any(
+                  String,
+                  OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                ),
               type: Symbol
             ).returns(T.attached_class)
           end
           def self.new(
             # Whether to generate a new image or edit an existing image. Default: `auto`.
             action: nil,
-            # Background type for the generated image. One of `transparent`, `opaque`, or
-            # `auto`. Default: `auto`.
+            # Allows to set transparency for the background of the generated image(s). This
+            # 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,
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. This parameter is only supported
@@ -1149,8 +1189,17 @@ module OpenAI
             # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
             # Default: `auto`.
             quality: nil,
-            # The size of the generated image. One of `1024x1024`, `1024x1536`, `1536x1024`,
-            # or `auto`. Default: `auto`.
+            # 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 type of the image generation tool. Always `image_generation`.
             type: :image_generation
@@ -1184,7 +1233,11 @@ module OpenAI
                 partial_images: Integer,
                 quality:
                   OpenAI::Responses::Tool::ImageGeneration::Quality::OrSymbol,
-                size: OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                size:
+                  T.any(
+                    String,
+                    OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol
+                  )
               }
             )
           end
@@ -1228,8 +1281,18 @@ module OpenAI
             end
           end
 
-          # Background type for the generated image. One of `transparent`, `opaque`, or
-          # `auto`. Default: `auto`.
+          # Allows to set transparency for the background of the generated image(s). This
+          # 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`.
           module Background
             extend OpenAI::Internal::Type::Enum
 
@@ -1388,11 +1451,26 @@ module OpenAI
                 :"gpt-image-1-mini",
                 OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
               )
+            GPT_IMAGE_2 =
+              T.let(
+                :"gpt-image-2",
+                OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+              )
+            GPT_IMAGE_2_2026_04_21 =
+              T.let(
+                :"gpt-image-2-2026-04-21",
+                OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+              )
             GPT_IMAGE_1_5 =
               T.let(
                 :"gpt-image-1.5",
                 OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
               )
+            CHATGPT_IMAGE_LATEST =
+              T.let(
+                :"chatgpt-image-latest",
+                OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+              )
           end
 
           # Moderation level for the generated image. Default: `auto`.
@@ -1514,10 +1592,37 @@ module OpenAI
             end
           end
 
-          # The size of the generated image. One of `1024x1024`, `1024x1536`, `1536x1024`,
-          # or `auto`. Default: `auto`.
+          # 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::Responses::Tool::ImageGeneration::Size::TaggedSymbol
+                )
+              end
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::Tool::ImageGeneration::Size::Variants
+                ]
+              )
+            end
+            def self.variants
+            end
 
             TaggedSymbol =
               T.type_alias do
@@ -1545,16 +1650,6 @@ module OpenAI
                 :auto,
                 OpenAI::Responses::Tool::ImageGeneration::Size::TaggedSymbol
               )
-
-            sig do
-              override.returns(
-                T::Array[
-                  OpenAI::Responses::Tool::ImageGeneration::Size::TaggedSymbol
-                ]
-              )
-            end
-            def self.values
-            end
           end
         end
 

data/rbi/openai/models.rbi

@@ -1,6 +1,8 @@
 # typed: strong
 
 module OpenAI
+  Admin = OpenAI::Models::Admin
+
   AllModels = OpenAI::Models::AllModels
 
   Audio = OpenAI::Models::Audio

data/rbi/openai/resources/admin/organization/admin_api_keys.rbi

@@ -0,0 +1,83 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class AdminAPIKeys
+          # Create an organization admin API key
+          sig do
+            params(
+              name: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Models::Admin::Organization::AdminAPIKeyCreateResponse
+            )
+          end
+          def create(name:, request_options: {})
+          end
+
+          # Retrieve a single organization API key
+          sig do
+            params(
+              key_id: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Admin::Organization::AdminAPIKey)
+          end
+          def retrieve(
+            # The ID of the API key.
+            key_id,
+            request_options: {}
+          )
+          end
+
+          # List organization API keys
+          sig do
+            params(
+              after: T.nilable(String),
+              limit: Integer,
+              order:
+                OpenAI::Admin::Organization::AdminAPIKeyListParams::Order::OrSymbol,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Internal::CursorPage[
+                OpenAI::Admin::Organization::AdminAPIKey
+              ]
+            )
+          end
+          def list(
+            # Return keys with IDs that come after this ID in the pagination order.
+            after: nil,
+            # Maximum number of keys to return.
+            limit: nil,
+            # Order results by creation time, ascending or descending.
+            order: nil,
+            request_options: {}
+          )
+          end
+
+          # Delete an organization admin API key
+          sig do
+            params(
+              key_id: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Models::Admin::Organization::AdminAPIKeyDeleteResponse
+            )
+          end
+          def delete(
+            # The ID of the API key to be deleted.
+            key_id,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/admin/organization/audit_logs.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        # List user actions and configuration changes within this organization.
+        class AuditLogs
+          # List user actions and configuration changes within this organization.
+          sig do
+            params(
+              actor_emails: T::Array[String],
+              actor_ids: T::Array[String],
+              after: String,
+              before: String,
+              effective_at:
+                OpenAI::Admin::Organization::AuditLogListParams::EffectiveAt::OrHash,
+              event_types:
+                T::Array[
+                  OpenAI::Admin::Organization::AuditLogListParams::EventType::OrSymbol
+                ],
+              limit: Integer,
+              project_ids: T::Array[String],
+              resource_ids: T::Array[String],
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Internal::ConversationCursorPage[
+                OpenAI::Models::Admin::Organization::AuditLogListResponse
+              ]
+            )
+          end
+          def list(
+            # Return only events performed by users with these emails.
+            actor_emails: nil,
+            # Return only events performed by these actors. Can be a user ID, a service
+            # account ID, or an api key tracking ID.
+            actor_ids: nil,
+            # A cursor for use in pagination. `after` is an object ID that defines your place
+            # in the list. For instance, if you make a list request and receive 100 objects,
+            # ending with obj_foo, your subsequent call can include after=obj_foo in order to
+            # fetch the next page of the list.
+            after: nil,
+            # A cursor for use in pagination. `before` is an object ID that defines your place
+            # in the list. For instance, if you make a list request and receive 100 objects,
+            # starting with obj_foo, your subsequent call can include before=obj_foo in order
+            # to fetch the previous page of the list.
+            before: nil,
+            # Return only events whose `effective_at` (Unix seconds) is in this range.
+            effective_at: nil,
+            # Return only events with a `type` in one of these values. For example,
+            # `project.created`. For all options, see the documentation for the
+            # [audit log object](https://platform.openai.com/docs/api-reference/audit-logs/object).
+            event_types: nil,
+            # A limit on the number of objects to be returned. Limit can range between 1 and
+            # 100, and the default is 20.
+            limit: nil,
+            # Return only events for these projects.
+            project_ids: nil,
+            # Return only events performed on these targets. For example, a project ID
+            # updated.
+            resource_ids: nil,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/admin/organization/certificates.rbi

@@ -0,0 +1,156 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class Certificates
+          # Upload a certificate to the organization. This does **not** automatically
+          # activate the certificate.
+          #
+          # Organizations can upload up to 50 certificates.
+          sig do
+            params(
+              certificate: String,
+              name: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Admin::Organization::Certificate)
+          end
+          def create(
+            # The certificate content in PEM format
+            certificate:,
+            # An optional name for the certificate
+            name: nil,
+            request_options: {}
+          )
+          end
+
+          # Get a certificate that has been uploaded to the organization.
+          #
+          # You can get a certificate regardless of whether it is active or not.
+          sig do
+            params(
+              certificate_id: String,
+              include:
+                T::Array[
+                  OpenAI::Admin::Organization::CertificateRetrieveParams::Include::OrSymbol
+                ],
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Admin::Organization::Certificate)
+          end
+          def retrieve(
+            # Unique ID of the certificate to retrieve.
+            certificate_id,
+            # A list of additional fields to include in the response. Currently the only
+            # supported value is `content` to fetch the PEM content of the certificate.
+            include: nil,
+            request_options: {}
+          )
+          end
+
+          # Modify a certificate. Note that only the name can be modified.
+          sig do
+            params(
+              certificate_id: String,
+              name: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Admin::Organization::Certificate)
+          end
+          def update(
+            # Unique ID of the certificate to modify.
+            certificate_id,
+            # The updated name for the certificate
+            name: nil,
+            request_options: {}
+          )
+          end
+
+          # List uploaded certificates for this organization.
+          sig do
+            params(
+              after: String,
+              limit: Integer,
+              order:
+                OpenAI::Admin::Organization::CertificateListParams::Order::OrSymbol,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Internal::ConversationCursorPage[
+                OpenAI::Models::Admin::Organization::CertificateListResponse
+              ]
+            )
+          end
+          def list(
+            # A cursor for use in pagination. `after` is an object ID that defines your place
+            # in the list. For instance, if you make a list request and receive 100 objects,
+            # ending with obj_foo, your subsequent call can include after=obj_foo in order to
+            # fetch the next page of the list.
+            after: nil,
+            # A limit on the number of objects to be returned. Limit can range between 1 and
+            # 100, and the default is 20.
+            limit: nil,
+            # Sort order by the `created_at` timestamp of the objects. `asc` for ascending
+            # order and `desc` for descending order.
+            order: nil,
+            request_options: {}
+          )
+          end
+
+          # Delete a certificate from the organization.
+          #
+          # The certificate must be inactive for the organization and all projects.
+          sig do
+            params(
+              certificate_id: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Models::Admin::Organization::CertificateDeleteResponse
+            )
+          end
+          def delete(
+            # Unique ID of the certificate to delete.
+            certificate_id,
+            request_options: {}
+          )
+          end
+
+          # Activate certificates at the organization level.
+          #
+          # You can atomically and idempotently activate up to 10 certificates at a time.
+          sig do
+            params(
+              certificate_ids: T::Array[String],
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Internal::Page[
+                OpenAI::Models::Admin::Organization::CertificateActivateResponse
+              ]
+            )
+          end
+          def activate(certificate_ids:, request_options: {})
+          end
+
+          # Deactivate certificates at the organization level.
+          #
+          # You can atomically and idempotently deactivate up to 10 certificates at a time.
+          sig do
+            params(
+              certificate_ids: T::Array[String],
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Internal::Page[
+                OpenAI::Models::Admin::Organization::CertificateDeactivateResponse
+              ]
+            )
+          end
+          def deactivate(certificate_ids:, request_options: {})
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/admin/organization/groups/roles.rbi

@@ -0,0 +1,85 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Admin
+      class Organization
+        class Groups
+          class Roles
+            # Assigns an organization role to a group within the organization.
+            sig do
+              params(
+                group_id: String,
+                role_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Models::Admin::Organization::Groups::RoleCreateResponse
+              )
+            end
+            def create(
+              # The ID of the group that should receive the organization role.
+              group_id,
+              # Identifier of the role to assign.
+              role_id:,
+              request_options: {}
+            )
+            end
+
+            # Lists the organization roles assigned to a group within the organization.
+            sig do
+              params(
+                group_id: String,
+                after: String,
+                limit: Integer,
+                order:
+                  OpenAI::Admin::Organization::Groups::RoleListParams::Order::OrSymbol,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Internal::NextCursorPage[
+                  OpenAI::Models::Admin::Organization::Groups::RoleListResponse
+                ]
+              )
+            end
+            def list(
+              # The ID of the group whose organization role assignments you want to list.
+              group_id,
+              # Cursor for pagination. Provide the value from the previous response's `next`
+              # field to continue listing organization roles.
+              after: nil,
+              # A limit on the number of organization role assignments to return.
+              limit: nil,
+              # Sort order for the returned organization roles.
+              order: nil,
+              request_options: {}
+            )
+            end
+
+            # Unassigns an organization role from a group within the organization.
+            sig do
+              params(
+                role_id: String,
+                group_id: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              ).returns(
+                OpenAI::Models::Admin::Organization::Groups::RoleDeleteResponse
+              )
+            end
+            def delete(
+              # The ID of the organization role to remove from the group.
+              role_id,
+              # The ID of the group to modify.
+              group_id:,
+              request_options: {}
+            )
+            end
+
+            # @api private
+            sig { params(client: OpenAI::Client).returns(T.attached_class) }
+            def self.new(client:)
+            end
+          end
+        end
+      end
+    end
+  end
+end