openai 0.9.0 → 0.11.0

data/rbi/openai/resources/responses.rbi

@@ -21,21 +21,22 @@ module OpenAI
       # your own data as input for the model's response.
       sig do
         params(
-          input: OpenAI::Responses::ResponseCreateParams::Input::Variants,
-          model:
-            T.any(
-              String,
-              OpenAI::ChatModel::OrSymbol,
-              OpenAI::ResponsesModel::ResponsesOnlyModel::OrSymbol
-            ),
           background: T.nilable(T::Boolean),
           include:
             T.nilable(
               T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol]
             ),
+          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(
+              String,
+              OpenAI::ChatModel::OrSymbol,
+              OpenAI::ResponsesModel::ResponsesOnlyModel::OrSymbol
+            ),
           parallel_tool_calls: T.nilable(T::Boolean),
           previous_response_id: T.nilable(String),
           prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
@@ -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(
@@ -81,41 +84,36 @@ module OpenAI
         ).returns(OpenAI::Responses::Response)
       end
       def create(
-        # Text, image, or file inputs to the model, used to generate a response.
-        #
-        # Learn more:
-        #
-        # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-        # - [Image inputs](https://platform.openai.com/docs/guides/images)
-        # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
-        # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
-        # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
-        input:,
-        # Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a
-        # wide range of models with different capabilities, performance characteristics,
-        # and price points. Refer to the
-        # [model guide](https://platform.openai.com/docs/models) to browse and compare
-        # available models.
-        model:,
         # Whether to run the model response in the background.
         # [Learn more](https://platform.openai.com/docs/guides/background).
         background: nil,
         # 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.
+        #
+        # Learn more:
+        #
+        # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+        # - [Image inputs](https://platform.openai.com/docs/guides/images)
+        # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+        # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+        # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+        input: nil,
         # A system (or developer) message inserted into the model's context.
         #
         # When using along with `previous_response_id`, the instructions from a previous
@@ -126,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.
@@ -133,6 +136,12 @@ module OpenAI
         # Keys are strings with a maximum length of 64 characters. Values are strings with
         # a maximum length of 512 characters.
         metadata: nil,
+        # Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a
+        # wide range of models with different capabilities, performance characteristics,
+        # and price points. Refer to the
+        # [model guide](https://platform.openai.com/docs/models) to browse and compare
+        # available models.
+        model: 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
@@ -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.
@@ -237,21 +249,22 @@ module OpenAI
       # your own data as input for the model's response.
       sig do
         params(
-          input: OpenAI::Responses::ResponseCreateParams::Input::Variants,
-          model:
-            T.any(
-              String,
-              OpenAI::ChatModel::OrSymbol,
-              OpenAI::ResponsesModel::ResponsesOnlyModel::OrSymbol
-            ),
           background: T.nilable(T::Boolean),
           include:
             T.nilable(
               T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol]
             ),
+          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(
+              String,
+              OpenAI::ChatModel::OrSymbol,
+              OpenAI::ResponsesModel::ResponsesOnlyModel::OrSymbol
+            ),
           parallel_tool_calls: T.nilable(T::Boolean),
           previous_response_id: T.nilable(String),
           prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
@@ -267,7 +280,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[
@@ -282,6 +296,7 @@ module OpenAI
                 OpenAI::Responses::WebSearchTool::OrHash
               )
             ],
+          top_logprobs: T.nilable(Integer),
           top_p: T.nilable(Float),
           truncation:
             T.nilable(
@@ -297,41 +312,36 @@ module OpenAI
         )
       end
       def stream_raw(
-        # Text, image, or file inputs to the model, used to generate a response.
-        #
-        # Learn more:
-        #
-        # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-        # - [Image inputs](https://platform.openai.com/docs/guides/images)
-        # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
-        # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
-        # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
-        input:,
-        # Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a
-        # wide range of models with different capabilities, performance characteristics,
-        # and price points. Refer to the
-        # [model guide](https://platform.openai.com/docs/models) to browse and compare
-        # available models.
-        model:,
         # Whether to run the model response in the background.
         # [Learn more](https://platform.openai.com/docs/guides/background).
         background: nil,
         # 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.
+        #
+        # Learn more:
+        #
+        # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+        # - [Image inputs](https://platform.openai.com/docs/guides/images)
+        # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+        # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+        # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+        input: nil,
         # A system (or developer) message inserted into the model's context.
         #
         # When using along with `previous_response_id`, the instructions from a previous
@@ -342,6 +352,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.
@@ -349,6 +364,12 @@ module OpenAI
         # Keys are strings with a maximum length of 64 characters. Values are strings with
         # a maximum length of 512 characters.
         metadata: nil,
+        # Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a
+        # wide range of models with different capabilities, performance characteristics,
+        # and price points. Refer to the
+        # [model guide](https://platform.openai.com/docs/models) to browse and compare
+        # available models.
+        model: 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
@@ -363,23 +384,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 +434,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.

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/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/errors.rbs

@@ -5,6 +5,15 @@ module OpenAI
     end
 
     class ConversionError < OpenAI::Errors::Error
+      def cause: -> StandardError?
+
+      def initialize: (
+        on: Class,
+        method: Symbol,
+        target: top,
+        value: top,
+        ?cause: StandardError?
+      ) -> void
     end
 
     class APIError < OpenAI::Errors::Error

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

@@ -8,8 +8,10 @@ module OpenAI
 
         type coerce_state =
           {
-            strictness: bool | :strong,
+            translate_names: bool,
+            strictness: bool,
             exactness: { yes: Integer, no: Integer, maybe: Integer },
+            error: Class,
             branched: Integer
           }
 
@@ -37,6 +39,10 @@ module OpenAI
           | OpenAI::Internal::Type::Converter::input spec
         ) -> (^-> top)
 
+        def self.new_coerce_state: (
+          ?translate_names: bool
+        ) -> OpenAI::Internal::Type::Converter::coerce_state
+
         def self.coerce: (
           OpenAI::Internal::Type::Converter::input target,
           top value,

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/audio/speech_create_params.rbs

@@ -8,7 +8,8 @@ module OpenAI
           voice: OpenAI::Models::Audio::SpeechCreateParams::voice,
           instructions: String,
           response_format: OpenAI::Models::Audio::SpeechCreateParams::response_format,
-          speed: Float
+          speed: Float,
+          stream_format: OpenAI::Models::Audio::SpeechCreateParams::stream_format
         }
         & OpenAI::Internal::Type::request_parameters
 
@@ -36,6 +37,12 @@ module OpenAI
 
         def speed=: (Float) -> Float
 
+        attr_reader stream_format: OpenAI::Models::Audio::SpeechCreateParams::stream_format?
+
+        def stream_format=: (
+          OpenAI::Models::Audio::SpeechCreateParams::stream_format
+        ) -> OpenAI::Models::Audio::SpeechCreateParams::stream_format
+
         def initialize: (
           input: String,
           model: OpenAI::Models::Audio::SpeechCreateParams::model,
@@ -43,6 +50,7 @@ module OpenAI
           ?instructions: String,
           ?response_format: OpenAI::Models::Audio::SpeechCreateParams::response_format,
           ?speed: Float,
+          ?stream_format: OpenAI::Models::Audio::SpeechCreateParams::stream_format,
           ?request_options: OpenAI::request_opts
         ) -> void
 
@@ -53,6 +61,7 @@ module OpenAI
           instructions: String,
           response_format: OpenAI::Models::Audio::SpeechCreateParams::response_format,
           speed: Float,
+          stream_format: OpenAI::Models::Audio::SpeechCreateParams::stream_format,
           request_options: OpenAI::RequestOptions
         }
 
@@ -110,6 +119,17 @@ module OpenAI
 
           def self?.values: -> ::Array[OpenAI::Models::Audio::SpeechCreateParams::response_format]
         end
+
+        type stream_format = :sse | :audio
+
+        module StreamFormat
+          extend OpenAI::Internal::Type::Enum
+
+          SSE: :sse
+          AUDIO: :audio
+
+          def self?.values: -> ::Array[OpenAI::Models::Audio::SpeechCreateParams::stream_format]
+        end
       end
     end
   end

data/sig/openai/models/audio/transcription.rbs

@@ -4,7 +4,8 @@ module OpenAI
       type transcription =
         {
           text: String,
-          logprobs: ::Array[OpenAI::Audio::Transcription::Logprob]
+          logprobs: ::Array[OpenAI::Audio::Transcription::Logprob],
+          usage: OpenAI::Models::Audio::Transcription::usage
         }
 
       class Transcription < OpenAI::Internal::Type::BaseModel
@@ -16,14 +17,22 @@ module OpenAI
           ::Array[OpenAI::Audio::Transcription::Logprob]
         ) -> ::Array[OpenAI::Audio::Transcription::Logprob]
 
+        attr_reader usage: OpenAI::Models::Audio::Transcription::usage?
+
+        def usage=: (
+          OpenAI::Models::Audio::Transcription::usage
+        ) -> OpenAI::Models::Audio::Transcription::usage
+
         def initialize: (
           text: String,
-          ?logprobs: ::Array[OpenAI::Audio::Transcription::Logprob]
+          ?logprobs: ::Array[OpenAI::Audio::Transcription::Logprob],
+          ?usage: OpenAI::Models::Audio::Transcription::usage
         ) -> void
 
         def to_hash: -> {
           text: String,
-          logprobs: ::Array[OpenAI::Audio::Transcription::Logprob]
+          logprobs: ::Array[OpenAI::Audio::Transcription::Logprob],
+          usage: OpenAI::Models::Audio::Transcription::usage
         }
 
         type logprob = { token: String, bytes: ::Array[Float], logprob: Float }
@@ -53,6 +62,89 @@ module OpenAI
             logprob: Float
           }
         end
+
+        type usage =
+          OpenAI::Audio::Transcription::Usage::Tokens
+          | OpenAI::Audio::Transcription::Usage::Duration
+
+        module Usage
+          extend OpenAI::Internal::Type::Union
+
+          type tokens =
+            {
+              input_tokens: Integer,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              type: :tokens,
+              input_token_details: OpenAI::Audio::Transcription::Usage::Tokens::InputTokenDetails
+            }
+
+          class Tokens < OpenAI::Internal::Type::BaseModel
+            attr_accessor input_tokens: Integer
+
+            attr_accessor output_tokens: Integer
+
+            attr_accessor total_tokens: Integer
+
+            attr_accessor type: :tokens
+
+            attr_reader input_token_details: OpenAI::Audio::Transcription::Usage::Tokens::InputTokenDetails?
+
+            def input_token_details=: (
+              OpenAI::Audio::Transcription::Usage::Tokens::InputTokenDetails
+            ) -> OpenAI::Audio::Transcription::Usage::Tokens::InputTokenDetails
+
+            def initialize: (
+              input_tokens: Integer,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              ?input_token_details: OpenAI::Audio::Transcription::Usage::Tokens::InputTokenDetails,
+              ?type: :tokens
+            ) -> void
+
+            def to_hash: -> {
+              input_tokens: Integer,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              type: :tokens,
+              input_token_details: OpenAI::Audio::Transcription::Usage::Tokens::InputTokenDetails
+            }
+
+            type input_token_details =
+              { audio_tokens: Integer, text_tokens: Integer }
+
+            class InputTokenDetails < OpenAI::Internal::Type::BaseModel
+              attr_reader audio_tokens: Integer?
+
+              def audio_tokens=: (Integer) -> Integer
+
+              attr_reader text_tokens: Integer?
+
+              def text_tokens=: (Integer) -> Integer
+
+              def initialize: (
+                ?audio_tokens: Integer,
+                ?text_tokens: Integer
+              ) -> void
+
+              def to_hash: -> { audio_tokens: Integer, text_tokens: Integer }
+            end
+          end
+
+          type duration = { duration: Float, type: :duration }
+
+          class Duration < OpenAI::Internal::Type::BaseModel
+            attr_accessor duration: Float
+
+            attr_accessor type: :duration
+
+            def initialize: (duration: Float, ?type: :duration) -> void
+
+            def to_hash: -> { duration: Float, type: :duration }
+          end
+
+          def self?.variants: -> ::Array[OpenAI::Models::Audio::Transcription::usage]
+        end
       end
     end
   end