openai 0.34.1 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 239d8995ddf81e712fa9ef923ab3a86fed0dd8c65b6ce186121783d598cf695f
-  data.tar.gz: 533d8fdd429bab5d03bd4be0135ec093b6c382860fe221afcdbd7e0bd25feee6
+  metadata.gz: abaa011e78b024745cccd6b1efad5fb9a3c5201aeb60257d0237c6c78097bb0c
+  data.tar.gz: 9dde864dac2f4b5535cf3793093a7d06c4675f1d1f1f7d0f25eaed5e51e76d6e
 SHA512:
-  metadata.gz: 667d676e2c21799e6f549ad48cc60f066218934adbf132f2333c68dee6f84f5580fb7a4ba00d11f63516434fa02110b6570c836cd35e40bc54d2c724c77842b0
-  data.tar.gz: 67414f450369b9d4158d59645a8204ffd85dfb0bee569ea141abf2f83dc897d1c99bedc7786ce520385a6fbae66581c21dbfd21cd3b1cdc5cbbcf72b0ba16b6f
+  metadata.gz: 77f016fb4b47043ee5e6ce97095a948d1b255f919e17548e2c495c3545d3cad7506fcf01c6b473df5114be3d70910c0a858da727f5284a1bbae16178c96ec739
+  data.tar.gz: 7b4ff9197e751ebc3266d56b5e714b784215c868e5df1aecc716fba0cfd3e4dcaeefb5d051e9132e126191e098441fc1429a1d93ab49c71af67afdc4b1354a4a

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.35.0 (2025-11-03)
+
+Full Changelog: [v0.34.1...v0.35.0](https://github.com/openai/openai-ruby/compare/v0.34.1...v0.35.0)
+
+### Features
+
+* **api:** Realtime API token_limits, Hybrid searching ranking options ([f7f04ea](https://github.com/openai/openai-ruby/commit/f7f04ea1816e005cfc7325f3c97b1f463aa6afe3))
+* **api:** remove InputAudio from ResponseInputContent ([e8f5e9f](https://github.com/openai/openai-ruby/commit/e8f5e9f1b51843bc015f787316fbf522a87cac52))
+* handle thread interrupts in the core HTTP client ([92e26d0](https://github.com/openai/openai-ruby/commit/92e26d0593ae6487a62d500c3e1e866252f3bdeb))
+
+
+### Bug Fixes
+
+* **api:** docs updates ([88a4a35](https://github.com/openai/openai-ruby/commit/88a4a355457b22ef9ac657ecb0e7a1a2e9bc8973))
+* text and tools use mutually exclusive issue ([#855](https://github.com/openai/openai-ruby/issues/855)) ([7d93874](https://github.com/openai/openai-ruby/commit/7d93874ff34f5efa2459211984533fe72dced9e1))
+
+
+### Chores
+
+* add license information to the gemspec file ([#222](https://github.com/openai/openai-ruby/issues/222)) ([90d3c4a](https://github.com/openai/openai-ruby/commit/90d3c4aaae8a6e2fa039e0d1ad220ea3d1051ed7))
+* **client:** send user-agent header ([3a850a9](https://github.com/openai/openai-ruby/commit/3a850a93808daf101fb086edc5511db9fa224684))
+* **internal:** codegen related update ([f6b9f90](https://github.com/openai/openai-ruby/commit/f6b9f904a95d703a0ce76185e63352e095cb35af))
+
 ## 0.34.1 (2025-10-20)
 
 Full Changelog: [v0.34.0...v0.34.1](https://github.com/openai/openai-ruby/compare/v0.34.0...v0.34.1)

data/README.md

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

data/lib/openai/internal/transport/base_client.rb

@@ -201,7 +201,8 @@ module OpenAI
             self.class::PLATFORM_HEADERS,
             {
               "accept" => "application/json",
-              "content-type" => "application/json"
+              "content-type" => "application/json",
+              "user-agent" => user_agent
             },
             headers
           )
@@ -219,6 +220,11 @@ module OpenAI
         # @return [Hash{String=>String}]
         private def auth_headers = {}
 
+        # @api private
+        #
+        # @return [String]
+        private def user_agent = "#{self.class.name}/Ruby #{OpenAI::VERSION}"
+
         # @api private
         #
         # @return [String]

data/lib/openai/internal/transport/pooled_net_requester.rb

@@ -128,40 +128,48 @@ module OpenAI
           url, deadline = request.fetch_values(:url, :deadline)
 
           req = nil
-          eof = false
           finished = false
-          closing = nil
 
           # rubocop:disable Metrics/BlockLength
           enum = Enumerator.new do |y|
             next if finished
 
             with_pool(url, deadline: deadline) do |conn|
-              req, closing = self.class.build_request(request) do
-                self.class.calibrate_socket_timeout(conn, deadline)
-              end
-
-              self.class.calibrate_socket_timeout(conn, deadline)
-              unless conn.started?
-                conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
-                conn.start
-              end
+              eof = false
+              closing = nil
+              ::Thread.handle_interrupt(Object => :never) do
+                ::Thread.handle_interrupt(Object => :immediate) do
+                  req, closing = self.class.build_request(request) do
+                    self.class.calibrate_socket_timeout(conn, deadline)
+                  end
 
-              self.class.calibrate_socket_timeout(conn, deadline)
-              conn.request(req) do |rsp|
-                y << [req, rsp]
-                break if finished
-
-                rsp.read_body do |bytes|
-                  y << bytes.force_encoding(Encoding::BINARY)
-                  break if finished
+                  self.class.calibrate_socket_timeout(conn, deadline)
+                  unless conn.started?
+                    conn.keep_alive_timeout = self.class::KEEP_ALIVE_TIMEOUT
+                    conn.start
+                  end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
+                  conn.request(req) do |rsp|
+                    y << [req, rsp]
+                    break if finished
+
+                    rsp.read_body do |bytes|
+                      y << bytes.force_encoding(Encoding::BINARY)
+                      break if finished
+
+                      self.class.calibrate_socket_timeout(conn, deadline)
+                    end
+                    eof = true
+                  end
+                end
+              ensure
+                begin
+                  conn.finish if !eof && conn&.started?
+                ensure
+                  closing&.call
                 end
-                eof = true
               end
-            ensure
-              conn.finish if !eof && conn&.started?
             end
           rescue Timeout::Error
             raise OpenAI::Errors::APITimeoutError.new(url: url, request: req)
@@ -174,8 +182,6 @@ module OpenAI
           body = OpenAI::Internal::Util.fused_enum(enum, external: true) do
             finished = true
             loop { enum.next }
-          ensure
-            closing&.call
           end
           [Integer(response.code), response, body]
         end

data/lib/openai/models/custom_tool_input_format.rb

@@ -8,8 +8,10 @@ module OpenAI
 
       discriminator :type
 
+      # Unconstrained free-form text.
       variant :text, -> { OpenAI::CustomToolInputFormat::Text }
 
+      # A grammar defined by the user.
       variant :grammar, -> { OpenAI::CustomToolInputFormat::Grammar }
 
       class Text < OpenAI::Internal::Type::BaseModel
@@ -20,6 +22,8 @@ module OpenAI
         required :type, const: :text
 
         # @!method initialize(type: :text)
+        #   Unconstrained free-form text.
+        #
         #   @param type [Symbol, :text] Unconstrained text format. Always `text`.
       end
 
@@ -43,6 +47,8 @@ module OpenAI
         required :type, const: :grammar
 
         # @!method initialize(definition:, syntax:, type: :grammar)
+        #   A grammar defined by the user.
+        #
         #   @param definition [String] The grammar definition.
         #
         #   @param syntax [Symbol, OpenAI::Models::CustomToolInputFormat::Grammar::Syntax] The syntax of the grammar definition. One of `lark` or `regex`.

data/lib/openai/models/image_edit_params.rb

@@ -142,7 +142,7 @@ module OpenAI
       #
       #   @param background [Symbol, OpenAI::Models::ImageEditParams::Background, nil] Allows to set transparency for the background of the generated image(s).
       #
-      #   @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
+      #   @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil] Control how much effort the model will exert to match the style and features, es
       #
       #   @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart] An additional image whose fully transparent areas (e.g. where alpha is zero) ind
       #

data/lib/openai/models/realtime/realtime_session_create_request.rb

@@ -98,8 +98,19 @@ module OpenAI
         optional :tracing, union: -> { OpenAI::Realtime::RealtimeTracingConfig }, nil?: true
 
         # @!attribute truncation
-        #   Controls how the realtime conversation is truncated prior to model inference.
-        #   The default is `auto`.
+        #   When the number of tokens in a conversation exceeds the model's input token
+        #   limit, the conversation be truncated, meaning messages (starting from the
+        #   oldest) will not be included in the model's context. A 32k context model with
+        #   4,096 max output tokens can only include 28,224 tokens in the context before
+        #   truncation occurs. Clients can configure truncation behavior to truncate with a
+        #   lower max token limit, which is an effective way to control token usage and
+        #   cost. Truncation will reduce the number of cached tokens on the next turn
+        #   (busting the cache), since messages are dropped from the beginning of the
+        #   context. However, clients can also configure truncation to retain messages up to
+        #   a fraction of the maximum context size, which will reduce the need for future
+        #   truncations and thus improve the cache rate. Truncation can be disabled
+        #   entirely, which means the server will never truncate but would instead return an
+        #   error if the conversation exceeds the model's input token limit.
         #
         #   @return [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio, nil]
         optional :truncation, union: -> { OpenAI::Realtime::RealtimeTruncation }
@@ -130,7 +141,7 @@ module OpenAI
         #
         #   @param tracing [Symbol, :auto, OpenAI::Models::Realtime::RealtimeTracingConfig::TracingConfiguration, nil] Realtime API can write session traces to the [Traces Dashboard](/logs?api=traces
         #
-        #   @param truncation [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio] Controls how the realtime conversation is truncated prior to model inference.
+        #   @param truncation [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio] When the number of tokens in a conversation exceeds the model's input token limi
         #
         #   @param type [Symbol, :realtime] The type of session to create. Always `realtime` for the Realtime API.
 

data/lib/openai/models/realtime/realtime_session_create_response.rb

@@ -106,8 +106,19 @@ module OpenAI
         optional :tracing, union: -> { OpenAI::Realtime::RealtimeSessionCreateResponse::Tracing }, nil?: true
 
         # @!attribute truncation
-        #   Controls how the realtime conversation is truncated prior to model inference.
-        #   The default is `auto`.
+        #   When the number of tokens in a conversation exceeds the model's input token
+        #   limit, the conversation be truncated, meaning messages (starting from the
+        #   oldest) will not be included in the model's context. A 32k context model with
+        #   4,096 max output tokens can only include 28,224 tokens in the context before
+        #   truncation occurs. Clients can configure truncation behavior to truncate with a
+        #   lower max token limit, which is an effective way to control token usage and
+        #   cost. Truncation will reduce the number of cached tokens on the next turn
+        #   (busting the cache), since messages are dropped from the beginning of the
+        #   context. However, clients can also configure truncation to retain messages up to
+        #   a fraction of the maximum context size, which will reduce the need for future
+        #   truncations and thus improve the cache rate. Truncation can be disabled
+        #   entirely, which means the server will never truncate but would instead return an
+        #   error if the conversation exceeds the model's input token limit.
         #
         #   @return [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio, nil]
         optional :truncation, union: -> { OpenAI::Realtime::RealtimeTruncation }
@@ -141,7 +152,7 @@ module OpenAI
         #
         #   @param tracing [Symbol, :auto, OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Tracing::TracingConfiguration, nil] Realtime API can write session traces to the [Traces Dashboard](/logs?api=traces
         #
-        #   @param truncation [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio] Controls how the realtime conversation is truncated prior to model inference.
+        #   @param truncation [Symbol, OpenAI::Models::Realtime::RealtimeTruncation::RealtimeTruncationStrategy, OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio] When the number of tokens in a conversation exceeds the model's input token limi
         #
         #   @param type [Symbol, :realtime] The type of session to create. Always `realtime` for the Realtime API.
 
@@ -990,7 +1001,7 @@ module OpenAI
         module Tracing
           extend OpenAI::Internal::Type::Union
 
-          # Default tracing mode for the session.
+          # Enables tracing and sets default values for tracing configuration options. Always `auto`.
           variant const: :auto
 
           # Granular configuration for tracing.

data/lib/openai/models/realtime/realtime_tracing_config.rb

@@ -12,7 +12,7 @@ module OpenAI
       module RealtimeTracingConfig
         extend OpenAI::Internal::Type::Union
 
-        # Default tracing mode for the session.
+        # Enables tracing and sets default values for tracing configuration options. Always `auto`.
         variant const: :auto
 
         # Granular configuration for tracing.

data/lib/openai/models/realtime/realtime_truncation.rb

@@ -3,8 +3,19 @@
 module OpenAI
   module Models
     module Realtime
-      # Controls how the realtime conversation is truncated prior to model inference.
-      # The default is `auto`.
+      # When the number of tokens in a conversation exceeds the model's input token
+      # limit, the conversation be truncated, meaning messages (starting from the
+      # oldest) will not be included in the model's context. A 32k context model with
+      # 4,096 max output tokens can only include 28,224 tokens in the context before
+      # truncation occurs. Clients can configure truncation behavior to truncate with a
+      # lower max token limit, which is an effective way to control token usage and
+      # cost. Truncation will reduce the number of cached tokens on the next turn
+      # (busting the cache), since messages are dropped from the beginning of the
+      # context. However, clients can also configure truncation to retain messages up to
+      # a fraction of the maximum context size, which will reduce the need for future
+      # truncations and thus improve the cache rate. Truncation can be disabled
+      # entirely, which means the server will never truncate but would instead return an
+      # error if the conversation exceeds the model's input token limit.
       module RealtimeTruncation
         extend OpenAI::Internal::Type::Union
 

data/lib/openai/models/realtime/realtime_truncation_retention_ratio.rb

@@ -5,8 +5,10 @@ module OpenAI
     module Realtime
       class RealtimeTruncationRetentionRatio < OpenAI::Internal::Type::BaseModel
         # @!attribute retention_ratio
-        #   Fraction of post-instruction conversation tokens to retain (0.0 - 1.0) when the
-        #   conversation exceeds the input token limit.
+        #   Fraction of post-instruction conversation tokens to retain (`0.0` - `1.0`) when
+        #   the conversation exceeds the input token limit. Setting this to `0.8` means that
+        #   messages will be dropped until 80% of the maximum allowed tokens are used. This
+        #   helps reduce the frequency of truncations and improve cache rates.
         #
         #   @return [Float]
         required :retention_ratio, Float
@@ -17,7 +19,14 @@ module OpenAI
         #   @return [Symbol, :retention_ratio]
         required :type, const: :retention_ratio
 
-        # @!method initialize(retention_ratio:, type: :retention_ratio)
+        # @!attribute token_limits
+        #   Optional custom token limits for this truncation strategy. If not provided, the
+        #   model's default token limits will be used.
+        #
+        #   @return [OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio::TokenLimits, nil]
+        optional :token_limits, -> { OpenAI::Realtime::RealtimeTruncationRetentionRatio::TokenLimits }
+
+        # @!method initialize(retention_ratio:, token_limits: nil, type: :retention_ratio)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio} for more details.
         #
@@ -25,9 +34,34 @@ module OpenAI
         #   input token limit. This allows you to amortize truncations across multiple
         #   turns, which can help improve cached token usage.
         #
-        #   @param retention_ratio [Float] Fraction of post-instruction conversation tokens to retain (0.0 - 1.0) when the
+        #   @param retention_ratio [Float] Fraction of post-instruction conversation tokens to retain (`0.0` - `1.0`) when
+        #
+        #   @param token_limits [OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio::TokenLimits] Optional custom token limits for this truncation strategy. If not provided, the
         #
         #   @param type [Symbol, :retention_ratio] Use retention ratio truncation.
+
+        # @see OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio#token_limits
+        class TokenLimits < OpenAI::Internal::Type::BaseModel
+          # @!attribute post_instructions
+          #   Maximum tokens allowed in the conversation after instructions (which including
+          #   tool definitions). For example, setting this to 5,000 would mean that truncation
+          #   would occur when the conversation exceeds 5,000 tokens after instructions. This
+          #   cannot be higher than the model's context window size minus the maximum output
+          #   tokens.
+          #
+          #   @return [Integer, nil]
+          optional :post_instructions, Integer
+
+          # @!method initialize(post_instructions: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Realtime::RealtimeTruncationRetentionRatio::TokenLimits} for
+          #   more details.
+          #
+          #   Optional custom token limits for this truncation strategy. If not provided, the
+          #   model's default token limits will be used.
+          #
+          #   @param post_instructions [Integer] Maximum tokens allowed in the conversation after instructions (which including t
+        end
       end
     end
   end

data/lib/openai/models/reasoning.rb

@@ -33,6 +33,8 @@ module OpenAI
       #   debugging and understanding the model's reasoning process. One of `auto`,
       #   `concise`, or `detailed`.
       #
+      #   `concise` is only supported for `computer-use-preview` models.
+      #
       #   @return [Symbol, OpenAI::Models::Reasoning::Summary, nil]
       optional :summary, enum: -> { OpenAI::Reasoning::Summary }, nil?: true
 
@@ -75,6 +77,8 @@ module OpenAI
       # debugging and understanding the model's reasoning process. One of `auto`,
       # `concise`, or `detailed`.
       #
+      # `concise` is only supported for `computer-use-preview` models.
+      #
       # @see OpenAI::Models::Reasoning#summary
       module Summary
         extend OpenAI::Internal::Type::Enum

data/lib/openai/models/responses/custom_tool.rb

@@ -29,6 +29,9 @@ module OpenAI
         optional :format_, union: -> { OpenAI::CustomToolInputFormat }, api_name: :format
 
         # @!method initialize(name:, description: nil, format_: nil, type: :custom)
+        #   A custom tool that processes input using a specified format. Learn more about
+        #   [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+        #
         #   @param name [String] The name of the custom tool, used to identify it in tool calls.
         #
         #   @param description [String] Optional description of the custom tool, used to provide more context.

data/lib/openai/models/responses/easy_input_message.rb

@@ -8,7 +8,7 @@ module OpenAI
         #   Text, image, or audio input to the model, used to generate a response. Can also
         #   contain previous assistant responses.
         #
-        #   @return [String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile, OpenAI::Models::Responses::ResponseInputAudio>]
+        #   @return [String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>]
         required :content, union: -> { OpenAI::Responses::EasyInputMessage::Content }
 
         # @!attribute role
@@ -34,7 +34,7 @@ module OpenAI
         #   `assistant` role are presumed to have been generated by the model in previous
         #   interactions.
         #
-        #   @param content [String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile, OpenAI::Models::Responses::ResponseInputAudio>] Text, image, or audio input to the model, used to generate a response.
+        #   @param content [String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>] Text, image, or audio input to the model, used to generate a response.
         #
         #   @param role [Symbol, OpenAI::Models::Responses::EasyInputMessage::Role] The role of the message input. One of `user`, `assistant`, `system`, or
         #
@@ -55,7 +55,7 @@ module OpenAI
           variant -> { OpenAI::Responses::ResponseInputMessageContentList }
 
           # @!method self.variants
-          #   @return [Array(String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile, OpenAI::Models::Responses::ResponseInputAudio>)]
+          #   @return [Array(String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>)]
         end
 
         # The role of the message input. One of `user`, `assistant`, `system`, or

data/lib/openai/models/responses/file_search_tool.rb

@@ -71,6 +71,13 @@ module OpenAI
 
         # @see OpenAI::Models::Responses::FileSearchTool#ranking_options
         class RankingOptions < OpenAI::Internal::Type::BaseModel
+          # @!attribute hybrid_search
+          #   Weights that control how reciprocal rank fusion balances semantic embedding
+          #   matches versus sparse keyword matches when hybrid search is enabled.
+          #
+          #   @return [OpenAI::Models::Responses::FileSearchTool::RankingOptions::HybridSearch, nil]
+          optional :hybrid_search, -> { OpenAI::Responses::FileSearchTool::RankingOptions::HybridSearch }
+
           # @!attribute ranker
           #   The ranker to use for the file search.
           #
@@ -85,16 +92,41 @@ module OpenAI
           #   @return [Float, nil]
           optional :score_threshold, Float
 
-          # @!method initialize(ranker: nil, score_threshold: nil)
+          # @!method initialize(hybrid_search: nil, ranker: nil, score_threshold: nil)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::FileSearchTool::RankingOptions} for more details.
           #
           #   Ranking options for search.
           #
+          #   @param hybrid_search [OpenAI::Models::Responses::FileSearchTool::RankingOptions::HybridSearch] Weights that control how reciprocal rank fusion balances semantic embedding matc
+          #
           #   @param ranker [Symbol, OpenAI::Models::Responses::FileSearchTool::RankingOptions::Ranker] The ranker to use for the file search.
           #
           #   @param score_threshold [Float] The score threshold for the file search, a number between 0 and 1. Numbers close
 
+          # @see OpenAI::Models::Responses::FileSearchTool::RankingOptions#hybrid_search
+          class HybridSearch < OpenAI::Internal::Type::BaseModel
+            # @!attribute embedding_weight
+            #   The weight of the embedding in the reciprocal ranking fusion.
+            #
+            #   @return [Float]
+            required :embedding_weight, Float
+
+            # @!attribute text_weight
+            #   The weight of the text in the reciprocal ranking fusion.
+            #
+            #   @return [Float]
+            required :text_weight, Float
+
+            # @!method initialize(embedding_weight:, text_weight:)
+            #   Weights that control how reciprocal rank fusion balances semantic embedding
+            #   matches versus sparse keyword matches when hybrid search is enabled.
+            #
+            #   @param embedding_weight [Float] The weight of the embedding in the reciprocal ranking fusion.
+            #
+            #   @param text_weight [Float] The weight of the text in the reciprocal ranking fusion.
+          end
+
           # The ranker to use for the file search.
           #
           # @see OpenAI::Models::Responses::FileSearchTool::RankingOptions#ranker

data/lib/openai/models/responses/response_content.rb

@@ -16,9 +16,6 @@ module OpenAI
         # A file input to the model.
         variant -> { OpenAI::Responses::ResponseInputFile }
 
-        # An audio input to the model.
-        variant -> { OpenAI::Responses::ResponseInputAudio }
-
         # A text output from the model.
         variant -> { OpenAI::Responses::ResponseOutputText }
 
@@ -50,7 +47,7 @@ module OpenAI
         end
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile, OpenAI::Models::Responses::ResponseInputAudio, OpenAI::Models::Responses::ResponseOutputText, OpenAI::Models::Responses::ResponseOutputRefusal, OpenAI::Models::Responses::ResponseContent::ReasoningTextContent)]
+        #   @return [Array(OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile, OpenAI::Models::Responses::ResponseOutputText, OpenAI::Models::Responses::ResponseOutputRefusal, OpenAI::Models::Responses::ResponseContent::ReasoningTextContent)]
       end
     end
   end

data/lib/openai/models/responses/response_input_content.rb

@@ -18,11 +18,8 @@ module OpenAI
         # A file input to the model.
         variant :input_file, -> { OpenAI::Responses::ResponseInputFile }
 
-        # An audio input to the model.
-        variant :input_audio, -> { OpenAI::Responses::ResponseInputAudio }
-
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile, OpenAI::Models::Responses::ResponseInputAudio)]
+        #   @return [Array(OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile)]
       end
     end
   end

data/lib/openai/models/responses/response_input_item.rb

@@ -94,7 +94,7 @@ module OpenAI
           #   A list of one or many input items to the model, containing different content
           #   types.
           #
-          #   @return [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile, OpenAI::Models::Responses::ResponseInputAudio>]
+          #   @return [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>]
           required :content, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseInputContent] }
 
           # @!attribute role
@@ -124,7 +124,7 @@ module OpenAI
           #   hierarchy. Instructions given with the `developer` or `system` role take
           #   precedence over instructions given with the `user` role.
           #
-          #   @param content [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile, OpenAI::Models::Responses::ResponseInputAudio>] A list of one or many input items to the model, containing different content
+          #   @param content [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>] A list of one or many input items to the model, containing different content
           #
           #   @param role [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Role] The role of the message input. One of `user`, `system`, or `developer`.
           #

data/lib/openai/models/responses/response_input_message_item.rb

@@ -14,7 +14,7 @@ module OpenAI
         #   A list of one or many input items to the model, containing different content
         #   types.
         #
-        #   @return [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile, OpenAI::Models::Responses::ResponseInputAudio>]
+        #   @return [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>]
         required :content, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseInputContent] }
 
         # @!attribute role
@@ -42,7 +42,7 @@ module OpenAI
         #
         #   @param id [String] The unique ID of the message input.
         #
-        #   @param content [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile, OpenAI::Models::Responses::ResponseInputAudio>] A list of one or many input items to the model, containing different content
+        #   @param content [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>] A list of one or many input items to the model, containing different content
         #
         #   @param role [Symbol, OpenAI::Models::Responses::ResponseInputMessageItem::Role] The role of the message input. One of `user`, `system`, or `developer`.
         #

data/lib/openai/models/responses/response_output_text.rb

@@ -11,6 +11,11 @@ module OpenAI
         required :annotations,
                  -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseOutputText::Annotation] }
 
+        # @!attribute logprobs
+        #
+        #   @return [Array<OpenAI::Models::Responses::ResponseOutputText::Logprob>]
+        required :logprobs, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseOutputText::Logprob] }
+
         # @!attribute text
         #   The text output from the model.
         #
@@ -31,20 +36,15 @@ module OpenAI
         #   @return [Symbol, :output_text]
         required :type, const: :output_text
 
-        # @!attribute logprobs
-        #
-        #   @return [Array<OpenAI::Models::Responses::ResponseOutputText::Logprob>, nil]
-        optional :logprobs, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseOutputText::Logprob] }
-
-        # @!method initialize(annotations:, text:, logprobs: nil, type: :output_text)
+        # @!method initialize(annotations:, logprobs:, text:, type: :output_text)
         #   A text output from the model.
         #
         #   @param annotations [Array<OpenAI::Models::Responses::ResponseOutputText::Annotation::FileCitation, OpenAI::Models::Responses::ResponseOutputText::Annotation::URLCitation, OpenAI::Models::Responses::ResponseOutputText::Annotation::ContainerFileCitation, OpenAI::Models::Responses::ResponseOutputText::Annotation::FilePath>] The annotations of the text output.
         #
-        #   @param text [String] The text output from the model.
-        #
         #   @param logprobs [Array<OpenAI::Models::Responses::ResponseOutputText::Logprob>]
         #
+        #   @param text [String] The text output from the model.
+        #
         #   @param type [Symbol, :output_text] The type of the output text. Always `output_text`.
 
         # A citation to a file.