openai 0.10.0 → 0.12.0

data/rbi/openai/resources/responses.rbi

@@ -29,6 +29,7 @@ module OpenAI
           input: OpenAI::Responses::ResponseCreateParams::Input::Variants,
           instructions: T.nilable(String),
           max_output_tokens: T.nilable(Integer),
+          max_tool_calls: T.nilable(Integer),
           metadata: T.nilable(T::Hash[Symbol, String]),
           model:
             T.any(
@@ -55,7 +56,8 @@ module OpenAI
             T.any(
               OpenAI::Responses::ToolChoiceOptions::OrSymbol,
               OpenAI::Responses::ToolChoiceTypes::OrHash,
-              OpenAI::Responses::ToolChoiceFunction::OrHash
+              OpenAI::Responses::ToolChoiceFunction::OrHash,
+              OpenAI::Responses::ToolChoiceMcp::OrHash
             ),
           tools:
             T::Array[
@@ -70,6 +72,7 @@ module OpenAI
                 OpenAI::Responses::WebSearchTool::OrHash
               )
             ],
+          top_logprobs: T.nilable(Integer),
           top_p: T.nilable(Float),
           truncation:
             T.nilable(
@@ -87,18 +90,19 @@ module OpenAI
         # Specify additional output data to include in the model response. Currently
         # supported values are:
         #
+        # - `code_interpreter_call.outputs`: Includes the outputs of python code execution
+        #   in code interpreter tool call items.
+        # - `computer_call_output.output.image_url`: Include image urls from the computer
+        #   call output.
         # - `file_search_call.results`: Include the search results of the file search tool
         #   call.
         # - `message.input_image.image_url`: Include image urls from the input message.
-        # - `computer_call_output.output.image_url`: Include image urls from the computer
-        #   call output.
+        # - `message.output_text.logprobs`: Include logprobs with assistant messages.
         # - `reasoning.encrypted_content`: Includes an encrypted version of reasoning
         #   tokens in reasoning item outputs. This enables reasoning items to be used in
         #   multi-turn conversations when using the Responses API statelessly (like when
         #   the `store` parameter is set to `false`, or when an organization is enrolled
         #   in the zero data retention program).
-        # - `code_interpreter_call.outputs`: Includes the outputs of python code execution
-        #   in code interpreter tool call items.
         include: nil,
         # Text, image, or file inputs to the model, used to generate a response.
         #
@@ -120,6 +124,11 @@ module OpenAI
         # including visible output tokens and
         # [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
         max_output_tokens: nil,
+        # The maximum number of total calls to built-in tools that can be processed in a
+        # response. This maximum number applies across all built-in tool calls, not per
+        # individual tool. Any further attempts to call a tool by the model will be
+        # ignored.
+        max_tool_calls: nil,
         # Set of 16 key-value pairs that can be attached to an object. This can be useful
         # for storing additional information about the object in a structured format, and
         # querying for objects via API or the dashboard.
@@ -147,23 +156,23 @@ module OpenAI
         # Configuration options for
         # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
         reasoning: nil,
-        # Specifies the latency tier to use for processing the request. This parameter is
-        # relevant for customers subscribed to the scale tier service:
+        # Specifies the processing type used for serving the request.
         #
-        # - If set to 'auto', and the Project is Scale tier enabled, the system will
-        #   utilize scale tier credits until they are exhausted.
-        # - If set to 'auto', and the Project is not Scale tier enabled, the request will
-        #   be processed using the default service tier with a lower uptime SLA and no
-        #   latency guarantee.
-        # - If set to 'default', the request will be processed using the default service
-        #   tier with a lower uptime SLA and no latency guarantee.
-        # - If set to 'flex', the request will be processed with the Flex Processing
-        #   service tier.
-        #   [Learn more](https://platform.openai.com/docs/guides/flex-processing).
+        # - If set to 'auto', then the request will be processed with the service tier
+        #   configured in the Project settings. Unless otherwise configured, the Project
+        #   will use 'default'.
+        # - If set to 'default', then the requset will be processed with the standard
+        #   pricing and performance for the selected model.
+        # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+        #   'priority', then the request will be processed with the corresponding service
+        #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
+        #   Priority processing.
         # - When not set, the default behavior is 'auto'.
         #
-        # When this parameter is set, the response body will include the `service_tier`
-        # utilized.
+        # When the `service_tier` parameter is set, the response body will include the
+        # `service_tier` value based on the processing mode actually used to serve the
+        # request. This response value may be different from the value set in the
+        # parameter.
         service_tier: nil,
         # Whether to store the generated model response for later retrieval via API.
         store: nil,
@@ -197,6 +206,9 @@ module OpenAI
         #   the model to call your own code. Learn more about
         #   [function calling](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.
+        top_logprobs: nil,
         # An alternative to sampling with temperature, called nucleus sampling, where the
         # model considers the results of the tokens with top_p probability mass. So 0.1
         # means only the tokens comprising the top 10% probability mass are considered.
@@ -245,6 +257,7 @@ module OpenAI
           input: OpenAI::Responses::ResponseCreateParams::Input::Variants,
           instructions: T.nilable(String),
           max_output_tokens: T.nilable(Integer),
+          max_tool_calls: T.nilable(Integer),
           metadata: T.nilable(T::Hash[Symbol, String]),
           model:
             T.any(
@@ -262,12 +275,19 @@ module OpenAI
             ),
           store: T.nilable(T::Boolean),
           temperature: T.nilable(Float),
-          text: OpenAI::Responses::ResponseTextConfig::OrHash,
+          text:
+            T.nilable(
+              T.any(
+                OpenAI::Responses::ResponseTextConfig::OrHash,
+                OpenAI::StructuredOutput::JsonSchemaConverter
+              )
+            ),
           tool_choice:
             T.any(
               OpenAI::Responses::ToolChoiceOptions::OrSymbol,
               OpenAI::Responses::ToolChoiceTypes::OrHash,
-              OpenAI::Responses::ToolChoiceFunction::OrHash
+              OpenAI::Responses::ToolChoiceFunction::OrHash,
+              OpenAI::Responses::ToolChoiceMcp::OrHash
             ),
           tools:
             T::Array[
@@ -282,6 +302,7 @@ module OpenAI
                 OpenAI::Responses::WebSearchTool::OrHash
               )
             ],
+          top_logprobs: T.nilable(Integer),
           top_p: T.nilable(Float),
           truncation:
             T.nilable(
@@ -303,18 +324,19 @@ module OpenAI
         # Specify additional output data to include in the model response. Currently
         # supported values are:
         #
+        # - `code_interpreter_call.outputs`: Includes the outputs of python code execution
+        #   in code interpreter tool call items.
+        # - `computer_call_output.output.image_url`: Include image urls from the computer
+        #   call output.
         # - `file_search_call.results`: Include the search results of the file search tool
         #   call.
         # - `message.input_image.image_url`: Include image urls from the input message.
-        # - `computer_call_output.output.image_url`: Include image urls from the computer
-        #   call output.
+        # - `message.output_text.logprobs`: Include logprobs with assistant messages.
         # - `reasoning.encrypted_content`: Includes an encrypted version of reasoning
         #   tokens in reasoning item outputs. This enables reasoning items to be used in
         #   multi-turn conversations when using the Responses API statelessly (like when
         #   the `store` parameter is set to `false`, or when an organization is enrolled
         #   in the zero data retention program).
-        # - `code_interpreter_call.outputs`: Includes the outputs of python code execution
-        #   in code interpreter tool call items.
         include: nil,
         # Text, image, or file inputs to the model, used to generate a response.
         #
@@ -336,6 +358,11 @@ module OpenAI
         # including visible output tokens and
         # [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
         max_output_tokens: nil,
+        # The maximum number of total calls to built-in tools that can be processed in a
+        # response. This maximum number applies across all built-in tool calls, not per
+        # individual tool. Any further attempts to call a tool by the model will be
+        # ignored.
+        max_tool_calls: nil,
         # Set of 16 key-value pairs that can be attached to an object. This can be useful
         # for storing additional information about the object in a structured format, and
         # querying for objects via API or the dashboard.
@@ -363,23 +390,23 @@ module OpenAI
         # Configuration options for
         # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
         reasoning: nil,
-        # Specifies the latency tier to use for processing the request. This parameter is
-        # relevant for customers subscribed to the scale tier service:
+        # Specifies the processing type used for serving the request.
         #
-        # - If set to 'auto', and the Project is Scale tier enabled, the system will
-        #   utilize scale tier credits until they are exhausted.
-        # - If set to 'auto', and the Project is not Scale tier enabled, the request will
-        #   be processed using the default service tier with a lower uptime SLA and no
-        #   latency guarantee.
-        # - If set to 'default', the request will be processed using the default service
-        #   tier with a lower uptime SLA and no latency guarantee.
-        # - If set to 'flex', the request will be processed with the Flex Processing
-        #   service tier.
-        #   [Learn more](https://platform.openai.com/docs/guides/flex-processing).
+        # - If set to 'auto', then the request will be processed with the service tier
+        #   configured in the Project settings. Unless otherwise configured, the Project
+        #   will use 'default'.
+        # - If set to 'default', then the requset will be processed with the standard
+        #   pricing and performance for the selected model.
+        # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+        #   'priority', then the request will be processed with the corresponding service
+        #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
+        #   Priority processing.
         # - When not set, the default behavior is 'auto'.
         #
-        # When this parameter is set, the response body will include the `service_tier`
-        # utilized.
+        # When the `service_tier` parameter is set, the response body will include the
+        # `service_tier` value based on the processing mode actually used to serve the
+        # request. This response value may be different from the value set in the
+        # parameter.
         service_tier: nil,
         # Whether to store the generated model response for later retrieval via API.
         store: nil,
@@ -413,6 +440,9 @@ module OpenAI
         #   the model to call your own code. Learn more about
         #   [function calling](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.
+        top_logprobs: nil,
         # An alternative to sampling with temperature, called nucleus sampling, where the
         # model considers the results of the tokens with top_p probability mass. So 0.1
         # means only the tokens comprising the top 10% probability mass are considered.
@@ -438,6 +468,125 @@ module OpenAI
       )
       end
 
+      # See {OpenAI::Resources::Responses#create} for non-streaming counterpart.
+      #
+      # Creates a model response with a higher-level streaming interface that provides
+      # helper methods for processing events and aggregating stream outputs.
+      sig do
+        params(
+          input:
+            T.nilable(OpenAI::Responses::ResponseCreateParams::Input::Variants),
+          model:
+            T.nilable(
+              T.any(
+                String,
+                OpenAI::ChatModel::OrSymbol,
+                OpenAI::ResponsesModel::ResponsesOnlyModel::OrSymbol
+              )
+            ),
+          background: T.nilable(T::Boolean),
+          include:
+            T.nilable(
+              T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol]
+            ),
+          instructions: T.nilable(String),
+          max_output_tokens: T.nilable(Integer),
+          metadata: T.nilable(T::Hash[Symbol, String]),
+          parallel_tool_calls: T.nilable(T::Boolean),
+          previous_response_id: T.nilable(String),
+          prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
+          reasoning: T.nilable(OpenAI::Reasoning::OrHash),
+          service_tier:
+            T.nilable(
+              OpenAI::Responses::ResponseCreateParams::ServiceTier::OrSymbol
+            ),
+          store: T.nilable(T::Boolean),
+          temperature: T.nilable(Float),
+          text:
+            T.any(
+              OpenAI::Responses::ResponseTextConfig::OrHash,
+              OpenAI::StructuredOutput::JsonSchemaConverter
+            ),
+          tool_choice:
+            T.any(
+              OpenAI::Responses::ToolChoiceOptions::OrSymbol,
+              OpenAI::Responses::ToolChoiceTypes::OrHash,
+              OpenAI::Responses::ToolChoiceFunction::OrHash
+            ),
+          tools:
+            T.nilable(
+              T::Array[
+                T.any(
+                  OpenAI::Responses::FunctionTool::OrHash,
+                  OpenAI::Responses::FileSearchTool::OrHash,
+                  OpenAI::Responses::ComputerTool::OrHash,
+                  OpenAI::Responses::Tool::Mcp::OrHash,
+                  OpenAI::Responses::Tool::CodeInterpreter::OrHash,
+                  OpenAI::Responses::Tool::ImageGeneration::OrHash,
+                  OpenAI::Responses::Tool::LocalShell::OrHash,
+                  OpenAI::Responses::WebSearchTool::OrHash,
+                  OpenAI::StructuredOutput::JsonSchemaConverter
+                )
+              ]
+            ),
+          top_p: T.nilable(Float),
+          truncation:
+            T.nilable(
+              OpenAI::Responses::ResponseCreateParams::Truncation::OrSymbol
+            ),
+          user: T.nilable(String),
+          starting_after: T.nilable(Integer),
+          request_options: T.nilable(OpenAI::RequestOptions::OrHash)
+        ).returns(OpenAI::Streaming::ResponseStream)
+      end
+      def stream(
+        # Text, image, or file inputs to the model, used to generate a response.
+        input: nil,
+        # Model ID used to generate the response, like `gpt-4o` or `o3`.
+        model: nil,
+        # Whether to run the model response in the background.
+        background: nil,
+        # Specify additional output data to include in the model response.
+        include: nil,
+        # A system (or developer) message inserted into the model's context.
+        instructions: nil,
+        # An upper bound for the number of tokens that can be generated for a response.
+        max_output_tokens: nil,
+        # Set of 16 key-value pairs that can be attached to an object.
+        metadata: nil,
+        # Whether to allow the model to run tool calls in parallel.
+        parallel_tool_calls: nil,
+        # The unique ID of the previous response to the model. Use this to create
+        # multi-turn conversations.
+        previous_response_id: nil,
+        # Reference to a prompt template and its variables.
+        prompt: nil,
+        # Configuration options for reasoning models.
+        reasoning: nil,
+        # Specifies the latency tier to use for processing the request.
+        service_tier: nil,
+        # Whether to store the generated model response for later retrieval via API.
+        store: nil,
+        # What sampling temperature to use, between 0 and 2.
+        temperature: nil,
+        # Configuration options for a text response from the model.
+        text: nil,
+        # How the model should select which tool (or tools) to use when generating a response.
+        tool_choice: nil,
+        # An array of tools the model may call while generating a response.
+        tools: nil,
+        # An alternative to sampling with temperature, called nucleus sampling.
+        top_p: nil,
+        # The truncation strategy to use for the model response.
+        truncation: nil,
+        # A stable identifier for your end-users.
+        user: nil,
+        # The sequence number of the event after which to start streaming (for resuming streams).
+        starting_after: nil,
+        request_options: {}
+      )
+      end
+
       # See {OpenAI::Resources::Responses#retrieve_streaming} for streaming counterpart.
       #
       # Retrieves a model response with the given ID.

data/rbi/openai/resources/webhooks.rbi

@@ -0,0 +1,68 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Webhooks
+      # Validates that the given payload was sent by OpenAI and parses the payload.
+      sig do
+        params(
+          payload: String,
+          headers: T.nilable(T::Hash[T.any(String, Symbol), String]),
+          webhook_secret: T.nilable(String)
+        ).returns(
+          T.any(
+            OpenAI::Webhooks::BatchCancelledWebhookEvent,
+            OpenAI::Webhooks::BatchCompletedWebhookEvent,
+            OpenAI::Webhooks::BatchExpiredWebhookEvent,
+            OpenAI::Webhooks::BatchFailedWebhookEvent,
+            OpenAI::Webhooks::EvalRunCanceledWebhookEvent,
+            OpenAI::Webhooks::EvalRunFailedWebhookEvent,
+            OpenAI::Webhooks::EvalRunSucceededWebhookEvent,
+            OpenAI::Webhooks::FineTuningJobCancelledWebhookEvent,
+            OpenAI::Webhooks::FineTuningJobFailedWebhookEvent,
+            OpenAI::Webhooks::FineTuningJobSucceededWebhookEvent,
+            OpenAI::Webhooks::ResponseCancelledWebhookEvent,
+            OpenAI::Webhooks::ResponseCompletedWebhookEvent,
+            OpenAI::Webhooks::ResponseFailedWebhookEvent,
+            OpenAI::Webhooks::ResponseIncompleteWebhookEvent
+          )
+        )
+      end
+      def unwrap(
+        # The raw webhook payload as a string
+        payload,
+        # The webhook headers
+        headers = {},
+        # The webhook secret (optional, will use ENV["OPENAI_WEBHOOK_SECRET"] if not provided)
+        webhook_secret = nil
+      )
+      end
+
+      # Validates whether or not the webhook payload was sent by OpenAI.
+      sig do
+        params(
+          payload: String,
+          headers: T::Hash[T.any(String, Symbol), String],
+          webhook_secret: T.nilable(String),
+          tolerance: Integer
+        ).void
+      end
+      def verify_signature(
+        # The webhook payload as a string
+        payload,
+        # The webhook headers
+        headers,
+        # The webhook secret (optional, will use ENV["OPENAI_WEBHOOK_SECRET"] if not provided)
+        webhook_secret = nil,
+        # Maximum age of the webhook in seconds (default: 300 = 5 minutes)
+        tolerance = 300
+      )
+      end
+
+      # @api private
+      sig { params(client: OpenAI::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/openai/streaming.rbi

@@ -0,0 +1,5 @@
+# typed: strong
+
+module OpenAI
+  Streaming = OpenAI::Helpers::Streaming
+end

data/sig/openai/client.rbs

@@ -36,6 +36,8 @@ module OpenAI
 
     attr_reader vector_stores: OpenAI::Resources::VectorStores
 
+    attr_reader webhooks: OpenAI::Resources::Webhooks
+
     attr_reader beta: OpenAI::Resources::Beta
 
     attr_reader batches: OpenAI::Resources::Batches

data/sig/openai/internal/type/base_stream.rbs

@@ -23,6 +23,10 @@ module OpenAI
           url: URI::Generic,
           status: Integer,
           response: top,
+          unwrap: Symbol
+          | Integer
+          | ::Array[Symbol | Integer]
+          | ^(top arg0) -> top,
           stream: Enumerable[Message]
         ) -> void
 

data/sig/openai/models/all_models.rbs

@@ -13,6 +13,10 @@ module OpenAI
         | :"o1-pro-2025-03-19"
         | :"o3-pro"
         | :"o3-pro-2025-06-10"
+        | :"o3-deep-research"
+        | :"o3-deep-research-2025-06-26"
+        | :"o4-mini-deep-research"
+        | :"o4-mini-deep-research-2025-06-26"
         | :"computer-use-preview"
         | :"computer-use-preview-2025-03-11"
 
@@ -23,6 +27,10 @@ module OpenAI
         O1_PRO_2025_03_19: :"o1-pro-2025-03-19"
         O3_PRO: :"o3-pro"
         O3_PRO_2025_06_10: :"o3-pro-2025-06-10"
+        O3_DEEP_RESEARCH: :"o3-deep-research"
+        O3_DEEP_RESEARCH_2025_06_26: :"o3-deep-research-2025-06-26"
+        O4_MINI_DEEP_RESEARCH: :"o4-mini-deep-research"
+        O4_MINI_DEEP_RESEARCH_2025_06_26: :"o4-mini-deep-research-2025-06-26"
         COMPUTER_USE_PREVIEW: :"computer-use-preview"
         COMPUTER_USE_PREVIEW_2025_03_11: :"computer-use-preview-2025-03-11"
 

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

@@ -127,7 +127,7 @@ module OpenAI
           end
         end
 
-        type service_tier = :auto | :default | :flex | :scale
+        type service_tier = :auto | :default | :flex | :scale | :priority
 
         module ServiceTier
           extend OpenAI::Internal::Type::Enum
@@ -136,6 +136,7 @@ module OpenAI
           DEFAULT: :default
           FLEX: :flex
           SCALE: :scale
+          PRIORITY: :priority
 
           def self?.values: -> ::Array[OpenAI::Models::Chat::ChatCompletion::service_tier]
         end

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

@@ -272,7 +272,7 @@ module OpenAI
           end
         end
 
-        type service_tier = :auto | :default | :flex | :scale
+        type service_tier = :auto | :default | :flex | :scale | :priority
 
         module ServiceTier
           extend OpenAI::Internal::Type::Enum
@@ -281,6 +281,7 @@ module OpenAI
           DEFAULT: :default
           FLEX: :flex
           SCALE: :scale
+          PRIORITY: :priority
 
           def self?.values: -> ::Array[OpenAI::Models::Chat::ChatCompletionChunk::service_tier]
         end

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

@@ -280,7 +280,7 @@ module OpenAI
           def self?.variants: -> ::Array[OpenAI::Models::Chat::CompletionCreateParams::response_format]
         end
 
-        type service_tier = :auto | :default | :flex | :scale
+        type service_tier = :auto | :default | :flex | :scale | :priority
 
         module ServiceTier
           extend OpenAI::Internal::Type::Enum
@@ -289,6 +289,7 @@ module OpenAI
           DEFAULT: :default
           FLEX: :flex
           SCALE: :scale
+          PRIORITY: :priority
 
           def self?.values: -> ::Array[OpenAI::Models::Chat::CompletionCreateParams::service_tier]
         end

data/sig/openai/models/images_response.rbs

@@ -3,17 +3,45 @@ module OpenAI
     type images_response =
       {
         created: Integer,
+        background: OpenAI::Models::ImagesResponse::background,
         data: ::Array[OpenAI::Image],
+        output_format: OpenAI::Models::ImagesResponse::output_format,
+        quality: OpenAI::Models::ImagesResponse::quality,
+        size: OpenAI::Models::ImagesResponse::size,
         usage: OpenAI::ImagesResponse::Usage
       }
 
     class ImagesResponse < OpenAI::Internal::Type::BaseModel
       attr_accessor created: Integer
 
+      attr_reader background: OpenAI::Models::ImagesResponse::background?
+
+      def background=: (
+        OpenAI::Models::ImagesResponse::background
+      ) -> OpenAI::Models::ImagesResponse::background
+
       attr_reader data: ::Array[OpenAI::Image]?
 
       def data=: (::Array[OpenAI::Image]) -> ::Array[OpenAI::Image]
 
+      attr_reader output_format: OpenAI::Models::ImagesResponse::output_format?
+
+      def output_format=: (
+        OpenAI::Models::ImagesResponse::output_format
+      ) -> OpenAI::Models::ImagesResponse::output_format
+
+      attr_reader quality: OpenAI::Models::ImagesResponse::quality?
+
+      def quality=: (
+        OpenAI::Models::ImagesResponse::quality
+      ) -> OpenAI::Models::ImagesResponse::quality
+
+      attr_reader size: OpenAI::Models::ImagesResponse::size?
+
+      def size=: (
+        OpenAI::Models::ImagesResponse::size
+      ) -> OpenAI::Models::ImagesResponse::size
+
       attr_reader usage: OpenAI::ImagesResponse::Usage?
 
       def usage=: (
@@ -22,16 +50,71 @@ module OpenAI
 
       def initialize: (
         created: Integer,
+        ?background: OpenAI::Models::ImagesResponse::background,
         ?data: ::Array[OpenAI::Image],
+        ?output_format: OpenAI::Models::ImagesResponse::output_format,
+        ?quality: OpenAI::Models::ImagesResponse::quality,
+        ?size: OpenAI::Models::ImagesResponse::size,
         ?usage: OpenAI::ImagesResponse::Usage
       ) -> void
 
       def to_hash: -> {
         created: Integer,
+        background: OpenAI::Models::ImagesResponse::background,
         data: ::Array[OpenAI::Image],
+        output_format: OpenAI::Models::ImagesResponse::output_format,
+        quality: OpenAI::Models::ImagesResponse::quality,
+        size: OpenAI::Models::ImagesResponse::size,
         usage: OpenAI::ImagesResponse::Usage
       }
 
+      type background = :transparent | :opaque
+
+      module Background
+        extend OpenAI::Internal::Type::Enum
+
+        TRANSPARENT: :transparent
+        OPAQUE: :opaque
+
+        def self?.values: -> ::Array[OpenAI::Models::ImagesResponse::background]
+      end
+
+      type output_format = :png | :webp | :jpeg
+
+      module OutputFormat
+        extend OpenAI::Internal::Type::Enum
+
+        PNG: :png
+        WEBP: :webp
+        JPEG: :jpeg
+
+        def self?.values: -> ::Array[OpenAI::Models::ImagesResponse::output_format]
+      end
+
+      type quality = :low | :medium | :high
+
+      module Quality
+        extend OpenAI::Internal::Type::Enum
+
+        LOW: :low
+        MEDIUM: :medium
+        HIGH: :high
+
+        def self?.values: -> ::Array[OpenAI::Models::ImagesResponse::quality]
+      end
+
+      type size = :"1024x1024" | :"1024x1536" | :"1536x1024"
+
+      module Size
+        extend OpenAI::Internal::Type::Enum
+
+        SIZE_1024X1024: :"1024x1024"
+        SIZE_1024X1536: :"1024x1536"
+        SIZE_1536X1024: :"1536x1024"
+
+        def self?.values: -> ::Array[OpenAI::Models::ImagesResponse::size]
+      end
+
       type usage =
         {
           input_tokens: Integer,