openai 0.42.0 → 0.43.0

data/lib/openai/models/video_create_error.rb

@@ -4,18 +4,23 @@ module OpenAI
   module Models
     class VideoCreateError < OpenAI::Internal::Type::BaseModel
       # @!attribute code
+      #   A machine-readable error code that was returned.
       #
       #   @return [String]
       required :code, String
 
       # @!attribute message
+      #   A human-readable description of the error that was returned.
       #
       #   @return [String]
       required :message, String
 
       # @!method initialize(code:, message:)
-      #   @param code [String]
-      #   @param message [String]
+      #   An error that occurred while generating the response.
+      #
+      #   @param code [String] A machine-readable error code that was returned.
+      #
+      #   @param message [String] A human-readable description of the error that was returned.
     end
   end
 end

data/lib/openai/resources/audio/speech.rb

@@ -15,7 +15,7 @@ module OpenAI
         #
         # @param model [String, Symbol, OpenAI::Models::Audio::SpeechModel] One of the available [TTS models](https://platform.openai.com/docs/models#tts):
         #
-        # @param voice [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice] The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
+        # @param voice [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice] The voice to use when generating the audio. Supported built-in voices are `alloy
         #
         # @param instructions [String] Control the voice of your generated audio with additional instructions. Does not
         #

data/lib/openai/resources/images.rb

@@ -45,7 +45,8 @@ module OpenAI
       # {OpenAI::Models::ImageEditParams} for more details.
       #
       # Creates an edited or extended image given one or more source images and a
-      # prompt. This endpoint only supports `gpt-image-1` and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models (`gpt-image-1.5`, `gpt-image-1`,
+      # and `gpt-image-1-mini`) and `dall-e-2`.
       #
       # @overload edit(image:, prompt:, background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, user: nil, request_options: {})
       #
@@ -104,7 +105,8 @@ module OpenAI
       # {OpenAI::Models::ImageEditParams} for more details.
       #
       # Creates an edited or extended image given one or more source images and a
-      # prompt. This endpoint only supports `gpt-image-1` and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models (`gpt-image-1.5`, `gpt-image-1`,
+      # and `gpt-image-1-mini`) and `dall-e-2`.
       #
       # @overload edit_stream_raw(image:, prompt:, background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, user: nil, request_options: {})
       #

data/lib/openai/resources/responses/input_tokens.rb

@@ -27,7 +27,7 @@ module OpenAI
         #
         # @param text [OpenAI::Models::Responses::InputTokenCountParams::Text, nil] Configuration options for a text response from the model. Can be plain
         #
-        # @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom, OpenAI::Models::Responses::ToolChoiceApplyPatch, OpenAI::Models::Responses::ToolChoiceShell, nil] How the model should select which tool (or tools) to use when generating
+        # @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom, OpenAI::Models::Responses::ToolChoiceApplyPatch, OpenAI::Models::Responses::ToolChoiceShell, nil] Controls which tool the model should use, if any.
         #
         # @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>, nil] An array of tools the model may call while generating a response. You can specif
         #

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.42.0"
+  VERSION = "0.43.0"
 end

data/rbi/openai/models/audio/speech_create_params.rbi

@@ -21,9 +21,10 @@ module OpenAI
         sig { returns(T.any(String, OpenAI::Audio::SpeechModel::OrSymbol)) }
         attr_accessor :model
 
-        # The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
-        # `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, and
-        # `verse`. Previews of the voices are available in the
+        # The voice to use when generating the audio. Supported built-in voices are
+        # `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`,
+        # `shimmer`, `verse`, `marin`, and `cedar`. Previews of the voices are available
+        # in the
         # [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
         sig do
           returns(
@@ -105,9 +106,10 @@ module OpenAI
           # One of the available [TTS models](https://platform.openai.com/docs/models#tts):
           # `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
           model:,
-          # The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
-          # `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, and
-          # `verse`. Previews of the voices are available in the
+          # The voice to use when generating the audio. Supported built-in voices are
+          # `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`,
+          # `shimmer`, `verse`, `marin`, and `cedar`. Previews of the voices are available
+          # in the
           # [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
           voice:,
           # Control the voice of your generated audio with additional instructions. Does not
@@ -168,9 +170,10 @@ module OpenAI
           end
         end
 
-        # The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
-        # `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, and
-        # `verse`. Previews of the voices are available in the
+        # The voice to use when generating the audio. Supported built-in voices are
+        # `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`,
+        # `shimmer`, `verse`, `marin`, and `cedar`. Previews of the voices are available
+        # in the
         # [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
         module Voice
           extend OpenAI::Internal::Type::Union

data/rbi/openai/models/chat/chat_completion_audio_param.rbi

@@ -21,8 +21,9 @@ module OpenAI
         end
         attr_accessor :format_
 
-        # The voice the model uses to respond. Supported voices are `alloy`, `ash`,
-        # `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, and `shimmer`.
+        # The voice the model uses to respond. Supported built-in voices are `alloy`,
+        # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
+        # `marin`, and `cedar`.
         sig do
           returns(
             T.any(
@@ -50,8 +51,9 @@ module OpenAI
           # Specifies the output audio format. Must be one of `wav`, `mp3`, `flac`, `opus`,
           # or `pcm16`.
           format_:,
-          # The voice the model uses to respond. Supported voices are `alloy`, `ash`,
-          # `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, and `shimmer`.
+          # The voice the model uses to respond. Supported built-in voices are `alloy`,
+          # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
+          # `marin`, and `cedar`.
           voice:
         )
         end
@@ -124,8 +126,9 @@ module OpenAI
           end
         end
 
-        # The voice the model uses to respond. Supported voices are `alloy`, `ash`,
-        # `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, and `shimmer`.
+        # The voice the model uses to respond. Supported built-in voices are `alloy`,
+        # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
+        # `marin`, and `cedar`.
         module Voice
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/conversations/message.rbi

@@ -87,7 +87,7 @@ module OpenAI
         def to_hash
         end
 
-        # A text input to the model.
+        # A content part that makes up an input or output item.
         module Content
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/realtime/realtime_audio_config_output.rbi

@@ -51,10 +51,10 @@ module OpenAI
         sig { params(speed: Float).void }
         attr_writer :speed
 
-        # The voice the model uses to respond. Voice cannot be changed during the session
-        # once the model has responded with audio at least once. Current voice options are
-        # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-        # and `cedar`. We recommend `marin` and `cedar` for best quality.
+        # The voice the model uses to respond. Supported built-in voices are `alloy`,
+        # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+        # `cedar`. Voice cannot be changed during the session once the model has responded
+        # with audio at least once. We recommend `marin` and `cedar` for best quality.
         sig do
           returns(
             T.nilable(
@@ -105,10 +105,10 @@ module OpenAI
           # This parameter is a post-processing adjustment to the audio after it is
           # generated, it's also possible to prompt the model to speak faster or slower.
           speed: nil,
-          # The voice the model uses to respond. Voice cannot be changed during the session
-          # once the model has responded with audio at least once. Current voice options are
-          # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-          # and `cedar`. We recommend `marin` and `cedar` for best quality.
+          # The voice the model uses to respond. Supported built-in voices are `alloy`,
+          # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+          # `cedar`. Voice cannot be changed during the session once the model has responded
+          # with audio at least once. We recommend `marin` and `cedar` for best quality.
           voice: nil
         )
         end
@@ -134,10 +134,10 @@ module OpenAI
         def to_hash
         end
 
-        # The voice the model uses to respond. Voice cannot be changed during the session
-        # once the model has responded with audio at least once. Current voice options are
-        # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-        # and `cedar`. We recommend `marin` and `cedar` for best quality.
+        # The voice the model uses to respond. Supported built-in voices are `alloy`,
+        # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+        # `cedar`. Voice cannot be changed during the session once the model has responded
+        # with audio at least once. We recommend `marin` and `cedar` for best quality.
         module Voice
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/realtime/realtime_response_create_audio_output.rbi

@@ -85,10 +85,10 @@ module OpenAI
           end
           attr_writer :format_
 
-          # The voice the model uses to respond. Voice cannot be changed during the session
-          # once the model has responded with audio at least once. Current voice options are
-          # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-          # and `cedar`. We recommend `marin` and `cedar` for best quality.
+          # The voice the model uses to respond. Supported built-in voices are `alloy`,
+          # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+          # `cedar`. Voice cannot be changed during the session once the model has responded
+          # with audio at least once.
           sig do
             returns(
               T.nilable(
@@ -130,10 +130,10 @@ module OpenAI
           def self.new(
             # The format of the output audio.
             format_: nil,
-            # The voice the model uses to respond. Voice cannot be changed during the session
-            # once the model has responded with audio at least once. Current voice options are
-            # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-            # and `cedar`. We recommend `marin` and `cedar` for best quality.
+            # The voice the model uses to respond. Supported built-in voices are `alloy`,
+            # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+            # `cedar`. Voice cannot be changed during the session once the model has responded
+            # with audio at least once.
             voice: nil
           )
           end
@@ -158,10 +158,10 @@ module OpenAI
           def to_hash
           end
 
-          # The voice the model uses to respond. Voice cannot be changed during the session
-          # once the model has responded with audio at least once. Current voice options are
-          # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-          # and `cedar`. We recommend `marin` and `cedar` for best quality.
+          # The voice the model uses to respond. Supported built-in voices are `alloy`,
+          # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+          # `cedar`. Voice cannot be changed during the session once the model has responded
+          # with audio at least once.
           module Voice
             extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/responses/input_token_count_params.rbi

@@ -88,9 +88,7 @@ module OpenAI
         end
         attr_writer :text
 
-        # How the model should select which tool (or tools) to use when generating a
-        # response. See the `tools` parameter to see how to specify which tools the model
-        # can call.
+        # Controls which tool the model should use, if any.
         sig do
           returns(
             T.nilable(
@@ -249,9 +247,7 @@ module OpenAI
           # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
           # - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
           text: nil,
-          # How the model should select which tool (or tools) to use when generating a
-          # response. See the `tools` parameter to see how to specify which tools the model
-          # can call.
+          # Controls which tool the model should use, if any.
           tool_choice: nil,
           # An array of tools the model may call while generating a response. You can
           # specify which tool to use by setting the `tool_choice` parameter.
@@ -540,9 +536,7 @@ module OpenAI
           end
         end
 
-        # How the model should select which tool (or tools) to use when generating a
-        # response. See the `tools` parameter to see how to specify which tools the model
-        # can call.
+        # Controls which tool the model should use, if any.
         module ToolChoice
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/responses/response.rbi

@@ -139,8 +139,13 @@ module OpenAI
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :background
 
-        # The conversation that this response belongs to. Input items and output items
-        # from this response are automatically added to this conversation.
+        # Unix timestamp (in seconds) of when this Response was completed. Only present
+        # when the status is `completed`.
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :completed_at
+
+        # The conversation that this response belonged to. Input items and output items
+        # from this response were automatically added to this conversation.
         sig { returns(T.nilable(OpenAI::Responses::Response::Conversation)) }
         attr_reader :conversation
 
@@ -380,6 +385,7 @@ module OpenAI
               ],
             top_p: T.nilable(Float),
             background: T.nilable(T::Boolean),
+            completed_at: T.nilable(Float),
             conversation:
               T.nilable(OpenAI::Responses::Response::Conversation::OrHash),
             max_output_tokens: T.nilable(Integer),
@@ -481,8 +487,11 @@ module OpenAI
           # Whether to run the model response in the background.
           # [Learn more](https://platform.openai.com/docs/guides/background).
           background: nil,
-          # The conversation that this response belongs to. Input items and output items
-          # from this response are automatically added to this conversation.
+          # Unix timestamp (in seconds) of when this Response was completed. Only present
+          # when the status is `completed`.
+          completed_at: nil,
+          # The conversation that this response belonged to. Input items and output items
+          # from this response were automatically added to this conversation.
           conversation: nil,
           # An upper bound for the number of tokens that can be generated for a response,
           # including visible output tokens and
@@ -592,6 +601,7 @@ module OpenAI
               tools: T::Array[OpenAI::Responses::Tool::Variants],
               top_p: T.nilable(Float),
               background: T.nilable(T::Boolean),
+              completed_at: T.nilable(Float),
               conversation:
                 T.nilable(OpenAI::Responses::Response::Conversation),
               max_output_tokens: T.nilable(Integer),
@@ -782,15 +792,15 @@ module OpenAI
               )
             end
 
-          # The unique ID of the conversation.
+          # The unique ID of the conversation that this response was associated with.
           sig { returns(String) }
           attr_accessor :id
 
-          # The conversation that this response belongs to. Input items and output items
-          # from this response are automatically added to this conversation.
+          # The conversation that this response belonged to. Input items and output items
+          # from this response were automatically added to this conversation.
           sig { params(id: String).returns(T.attached_class) }
           def self.new(
-            # The unique ID of the conversation.
+            # The unique ID of the conversation that this response was associated with.
             id:
           )
           end

data/rbi/openai/models/responses/response_compaction_item.rbi

@@ -16,6 +16,7 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :id
 
+        # The encrypted content that was produced by compaction.
         sig { returns(String) }
         attr_accessor :encrypted_content
 
@@ -23,6 +24,7 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The identifier of the actor that created the item.
         sig { returns(T.nilable(String)) }
         attr_reader :created_by
 
@@ -42,7 +44,9 @@ module OpenAI
         def self.new(
           # The unique ID of the compaction item.
           id:,
+          # The encrypted content that was produced by compaction.
           encrypted_content:,
+          # The identifier of the actor that created the item.
           created_by: nil,
           # The type of the item. Always `compaction`.
           type: :compaction

data/rbi/openai/models/responses/response_compaction_item_param.rbi

@@ -12,6 +12,7 @@ module OpenAI
             )
           end
 
+        # The encrypted content of the compaction summary.
         sig { returns(String) }
         attr_accessor :encrypted_content
 
@@ -33,6 +34,7 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
+          # The encrypted content of the compaction summary.
           encrypted_content:,
           # The ID of the compaction item.
           id: nil,

data/rbi/openai/models/responses/response_function_call_output_item.rbi

@@ -3,7 +3,7 @@
 module OpenAI
   module Models
     module Responses
-      # A text input to the model.
+      # A piece of message content, such as text, an image, or a file.
       module ResponseFunctionCallOutputItem
         extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/responses/response_function_shell_tool_call_output.rbi

@@ -40,13 +40,14 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The identifier of the actor that created the item.
         sig { returns(T.nilable(String)) }
         attr_reader :created_by
 
         sig { params(created_by: String).void }
         attr_writer :created_by
 
-        # The output of a shell tool call.
+        # The output of a shell tool call that was emitted.
         sig do
           params(
             id: String,
@@ -71,6 +72,7 @@ module OpenAI
           max_output_length:,
           # An array of shell call output contents
           output:,
+          # The identifier of the actor that created the item.
           created_by: nil,
           # The type of the shell call output. Always `shell_call_output`.
           type: :shell_call_output
@@ -113,19 +115,22 @@ module OpenAI
           end
           attr_accessor :outcome
 
+          # The standard error output that was captured.
           sig { returns(String) }
           attr_accessor :stderr
 
+          # The standard output that was captured.
           sig { returns(String) }
           attr_accessor :stdout
 
+          # The identifier of the actor that created the item.
           sig { returns(T.nilable(String)) }
           attr_reader :created_by
 
           sig { params(created_by: String).void }
           attr_writer :created_by
 
-          # The content of a shell call output.
+          # The content of a shell tool call output that was emitted.
           sig do
             params(
               outcome:
@@ -142,8 +147,11 @@ module OpenAI
             # Represents either an exit outcome (with an exit code) or a timeout outcome for a
             # shell call output chunk.
             outcome:,
+            # The standard error output that was captured.
             stderr:,
+            # The standard output that was captured.
             stdout:,
+            # The identifier of the actor that created the item.
             created_by: nil
           )
           end

data/rbi/openai/models/responses/response_function_web_search.rbi

@@ -113,7 +113,7 @@ module OpenAI
                 )
               end
 
-            # The search query.
+            # [DEPRECATED] The search query.
             sig { returns(String) }
             attr_accessor :query
 
@@ -121,6 +121,13 @@ module OpenAI
             sig { returns(Symbol) }
             attr_accessor :type
 
+            # The search queries.
+            sig { returns(T.nilable(T::Array[String])) }
+            attr_reader :queries
+
+            sig { params(queries: T::Array[String]).void }
+            attr_writer :queries
+
             # The sources used in the search.
             sig do
               returns(
@@ -147,6 +154,7 @@ module OpenAI
             sig do
               params(
                 query: String,
+                queries: T::Array[String],
                 sources:
                   T::Array[
                     OpenAI::Responses::ResponseFunctionWebSearch::Action::Search::Source::OrHash
@@ -155,8 +163,10 @@ module OpenAI
               ).returns(T.attached_class)
             end
             def self.new(
-              # The search query.
+              # [DEPRECATED] The search query.
               query:,
+              # The search queries.
+              queries: nil,
               # The sources used in the search.
               sources: nil,
               # The action type.
@@ -169,6 +179,7 @@ module OpenAI
                 {
                   query: String,
                   type: Symbol,
+                  queries: T::Array[String],
                   sources:
                     T::Array[
                       OpenAI::Responses::ResponseFunctionWebSearch::Action::Search::Source

data/rbi/openai/models/responses/response_output_text.rbi

@@ -104,7 +104,7 @@ module OpenAI
         def to_hash
         end
 
-        # A citation to a file.
+        # An annotation that applies to a span of output text.
         module Annotation
           extend OpenAI::Internal::Type::Union
 

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

@@ -718,6 +718,7 @@ module OpenAI
               sig { params(file_ids: T::Array[String]).void }
               attr_writer :file_ids
 
+              # The memory limit for the code interpreter container.
               sig do
                 returns(
                   T.nilable(
@@ -742,6 +743,7 @@ module OpenAI
               def self.new(
                 # An optional list of uploaded files to make available to your code.
                 file_ids: nil,
+                # The memory limit for the code interpreter container.
                 memory_limit: nil,
                 # Always `auto`.
                 type: :auto
@@ -763,6 +765,7 @@ module OpenAI
               def to_hash
               end
 
+              # The memory limit for the code interpreter container.
               module MemoryLimit
                 extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/video_create_error.rbi

@@ -8,14 +8,22 @@ module OpenAI
           T.any(OpenAI::VideoCreateError, OpenAI::Internal::AnyHash)
         end
 
+      # A machine-readable error code that was returned.
       sig { returns(String) }
       attr_accessor :code
 
+      # A human-readable description of the error that was returned.
       sig { returns(String) }
       attr_accessor :message
 
+      # An error that occurred while generating the response.
       sig { params(code: String, message: String).returns(T.attached_class) }
-      def self.new(code:, message:)
+      def self.new(
+        # A machine-readable error code that was returned.
+        code:,
+        # A human-readable description of the error that was returned.
+        message:
+      )
       end
 
       sig { override.returns({ code: String, message: String }) }

data/rbi/openai/resources/audio/speech.rbi

@@ -26,9 +26,10 @@ module OpenAI
           # One of the available [TTS models](https://platform.openai.com/docs/models#tts):
           # `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
           model:,
-          # The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
-          # `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, and
-          # `verse`. Previews of the voices are available in the
+          # The voice to use when generating the audio. Supported built-in voices are
+          # `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`,
+          # `shimmer`, `verse`, `marin`, and `cedar`. Previews of the voices are available
+          # in the
           # [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
           voice:,
           # Control the voice of your generated audio with additional instructions. Does not

data/rbi/openai/resources/images.rbi

@@ -45,7 +45,8 @@ module OpenAI
       # See {OpenAI::Resources::Images#edit_stream_raw} for streaming counterpart.
       #
       # Creates an edited or extended image given one or more source images and a
-      # prompt. This endpoint only supports `gpt-image-1` and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models (`gpt-image-1.5`, `gpt-image-1`,
+      # and `gpt-image-1-mini`) and `dall-e-2`.
       sig do
         params(
           image: OpenAI::ImageEditParams::Image::Variants,
@@ -148,7 +149,8 @@ module OpenAI
       # See {OpenAI::Resources::Images#edit} for non-streaming counterpart.
       #
       # Creates an edited or extended image given one or more source images and a
-      # prompt. This endpoint only supports `gpt-image-1` and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models (`gpt-image-1.5`, `gpt-image-1`,
+      # and `gpt-image-1-mini`) and `dall-e-2`.
       sig do
         params(
           image: OpenAI::ImageEditParams::Image::Variants,

data/rbi/openai/resources/responses/input_tokens.rbi

@@ -97,9 +97,7 @@ module OpenAI
           # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
           # - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
           text: nil,
-          # How the model should select which tool (or tools) to use when generating a
-          # response. See the `tools` parameter to see how to specify which tools the model
-          # can call.
+          # Controls which tool the model should use, if any.
           tool_choice: nil,
           # An array of tools the model may call while generating a response. You can
           # specify which tool to use by setting the `tool_choice` parameter.