openai 0.40.0 → 0.42.0

data/lib/openai/resources/videos.rb

@@ -14,7 +14,7 @@ module OpenAI
       #
       # @param input_reference [Pathname, StringIO, IO, String, OpenAI::FilePart] Optional image reference that guides generation.
       #
-      # @param model [Symbol, OpenAI::Models::VideoModel] The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
+      # @param model [String, Symbol, OpenAI::Models::VideoModel] The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
       #
       # @param seconds [Symbol, OpenAI::Models::VideoSeconds] Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
       #

data/lib/openai/version.rb

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

data/lib/openai.rb

@@ -385,6 +385,7 @@ require_relative "openai/models/fine_tuning/supervised_hyperparameters"
 require_relative "openai/models/fine_tuning/supervised_method"
 require_relative "openai/models/function_definition"
 require_relative "openai/models/function_parameters"
+require_relative "openai/models/graders/grader_input_item"
 require_relative "openai/models/graders/grader_inputs"
 require_relative "openai/models/graders/label_model_grader"
 require_relative "openai/models/graders/multi_grader"

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

@@ -17,7 +17,7 @@ module OpenAI
         attr_accessor :input
 
         # One of the available [TTS models](https://platform.openai.com/docs/models#tts):
-        # `tts-1`, `tts-1-hd` or `gpt-4o-mini-tts`.
+        # `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
         sig { returns(T.any(String, OpenAI::Audio::SpeechModel::OrSymbol)) }
         attr_accessor :model
 
@@ -103,7 +103,7 @@ module OpenAI
           # The text to generate audio for. The maximum length is 4096 characters.
           input:,
           # One of the available [TTS models](https://platform.openai.com/docs/models#tts):
-          # `tts-1`, `tts-1-hd` or `gpt-4o-mini-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
@@ -150,7 +150,7 @@ module OpenAI
         end
 
         # One of the available [TTS models](https://platform.openai.com/docs/models#tts):
-        # `tts-1`, `tts-1-hd` or `gpt-4o-mini-tts`.
+        # `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, or `gpt-4o-mini-tts-2025-12-15`.
         module Model
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/audio/speech_model.rbi

@@ -14,6 +14,11 @@ module OpenAI
         TTS_1_HD = T.let(:"tts-1-hd", OpenAI::Audio::SpeechModel::TaggedSymbol)
         GPT_4O_MINI_TTS =
           T.let(:"gpt-4o-mini-tts", OpenAI::Audio::SpeechModel::TaggedSymbol)
+        GPT_4O_MINI_TTS_2025_12_15 =
+          T.let(
+            :"gpt-4o-mini-tts-2025-12-15",
+            OpenAI::Audio::SpeechModel::TaggedSymbol
+          )
 
         sig do
           override.returns(T::Array[OpenAI::Audio::SpeechModel::TaggedSymbol])

data/rbi/openai/models/audio/transcription_create_params.rbi

@@ -21,8 +21,9 @@ module OpenAI
         attr_accessor :file
 
         # ID of the model to use. The options are `gpt-4o-transcribe`,
-        # `gpt-4o-mini-transcribe`, `whisper-1` (which is powered by our open source
-        # Whisper V2 model), and `gpt-4o-transcribe-diarize`.
+        # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`, `whisper-1`
+        # (which is powered by our open source Whisper V2 model), and
+        # `gpt-4o-transcribe-diarize`.
         sig { returns(T.any(String, OpenAI::AudioModel::OrSymbol)) }
         attr_accessor :model
 
@@ -47,9 +48,9 @@ module OpenAI
         # Additional information to include in the transcription response. `logprobs` will
         # return the log probabilities of the tokens in the response to understand the
         # model's confidence in the transcription. `logprobs` only works with
-        # response_format set to `json` and only with the models `gpt-4o-transcribe` and
-        # `gpt-4o-mini-transcribe`. This field is not supported when using
-        # `gpt-4o-transcribe-diarize`.
+        # response_format set to `json` and only with the models `gpt-4o-transcribe`,
+        # `gpt-4o-mini-transcribe`, and `gpt-4o-mini-transcribe-2025-12-15`. This field is
+        # not supported when using `gpt-4o-transcribe-diarize`.
         sig do
           returns(
             T.nilable(T::Array[OpenAI::Audio::TranscriptionInclude::OrSymbol])
@@ -185,8 +186,9 @@ module OpenAI
           # flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.
           file:,
           # ID of the model to use. The options are `gpt-4o-transcribe`,
-          # `gpt-4o-mini-transcribe`, `whisper-1` (which is powered by our open source
-          # Whisper V2 model), and `gpt-4o-transcribe-diarize`.
+          # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`, `whisper-1`
+          # (which is powered by our open source Whisper V2 model), and
+          # `gpt-4o-transcribe-diarize`.
           model:,
           # Controls how the audio is cut into chunks. When set to `"auto"`, the server
           # first normalizes loudness and then uses voice activity detection (VAD) to choose
@@ -198,9 +200,9 @@ module OpenAI
           # Additional information to include in the transcription response. `logprobs` will
           # return the log probabilities of the tokens in the response to understand the
           # model's confidence in the transcription. `logprobs` only works with
-          # response_format set to `json` and only with the models `gpt-4o-transcribe` and
-          # `gpt-4o-mini-transcribe`. This field is not supported when using
-          # `gpt-4o-transcribe-diarize`.
+          # response_format set to `json` and only with the models `gpt-4o-transcribe`,
+          # `gpt-4o-mini-transcribe`, and `gpt-4o-mini-transcribe-2025-12-15`. This field is
+          # not supported when using `gpt-4o-transcribe-diarize`.
           include: nil,
           # Optional list of speaker names that correspond to the audio samples provided in
           # `known_speaker_references[]`. Each entry should be a short identifier (for
@@ -276,8 +278,9 @@ module OpenAI
         end
 
         # ID of the model to use. The options are `gpt-4o-transcribe`,
-        # `gpt-4o-mini-transcribe`, `whisper-1` (which is powered by our open source
-        # Whisper V2 model), and `gpt-4o-transcribe-diarize`.
+        # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`, `whisper-1`
+        # (which is powered by our open source Whisper V2 model), and
+        # `gpt-4o-transcribe-diarize`.
         module Model
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/audio_model.rbi

@@ -13,6 +13,11 @@ module OpenAI
         T.let(:"gpt-4o-transcribe", OpenAI::AudioModel::TaggedSymbol)
       GPT_4O_MINI_TRANSCRIBE =
         T.let(:"gpt-4o-mini-transcribe", OpenAI::AudioModel::TaggedSymbol)
+      GPT_4O_MINI_TRANSCRIBE_2025_12_15 =
+        T.let(
+          :"gpt-4o-mini-transcribe-2025-12-15",
+          OpenAI::AudioModel::TaggedSymbol
+        )
       GPT_4O_TRANSCRIBE_DIARIZE =
         T.let(:"gpt-4o-transcribe-diarize", OpenAI::AudioModel::TaggedSymbol)
 

data/rbi/openai/models/graders/grader_input_item.rbi

@@ -0,0 +1,112 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Graders
+      # A single content item: input text, output text, input image, or input audio.
+      module GraderInputItem
+        extend OpenAI::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              String,
+              OpenAI::Responses::ResponseInputText,
+              OpenAI::Graders::GraderInputItem::OutputText,
+              OpenAI::Graders::GraderInputItem::InputImage,
+              OpenAI::Responses::ResponseInputAudio
+            )
+          end
+
+        class OutputText < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Graders::GraderInputItem::OutputText,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The text output from the model.
+          sig { returns(String) }
+          attr_accessor :text
+
+          # The type of the output text. Always `output_text`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          # A text output from the model.
+          sig { params(text: String, type: Symbol).returns(T.attached_class) }
+          def self.new(
+            # The text output from the model.
+            text:,
+            # The type of the output text. Always `output_text`.
+            type: :output_text
+          )
+          end
+
+          sig { override.returns({ text: String, type: Symbol }) }
+          def to_hash
+          end
+        end
+
+        class InputImage < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Graders::GraderInputItem::InputImage,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The URL of the image input.
+          sig { returns(String) }
+          attr_accessor :image_url
+
+          # The type of the image input. Always `input_image`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          # The detail level of the image to be sent to the model. One of `high`, `low`, or
+          # `auto`. Defaults to `auto`.
+          sig { returns(T.nilable(String)) }
+          attr_reader :detail
+
+          sig { params(detail: String).void }
+          attr_writer :detail
+
+          # An image input block used within EvalItem content arrays.
+          sig do
+            params(image_url: String, detail: String, type: Symbol).returns(
+              T.attached_class
+            )
+          end
+          def self.new(
+            # The URL of the image input.
+            image_url:,
+            # The detail level of the image to be sent to the model. One of `high`, `low`, or
+            # `auto`. Defaults to `auto`.
+            detail: nil,
+            # The type of the image input. Always `input_image`.
+            type: :input_image
+          )
+          end
+
+          sig do
+            override.returns(
+              { image_url: String, type: Symbol, detail: String }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        sig do
+          override.returns(T::Array[OpenAI::Graders::GraderInputItem::Variants])
+        end
+        def self.variants
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/graders/grader_inputs.rbi

@@ -6,111 +6,6 @@ module OpenAI
       T.let(Graders::GraderInputs, OpenAI::Internal::Type::Converter)
 
     module Graders
-      # A single content item: input text, output text, input image, or input audio.
-      module GraderInputItem
-        extend OpenAI::Internal::Type::Union
-
-        Variants =
-          T.type_alias do
-            T.any(
-              String,
-              OpenAI::Responses::ResponseInputText,
-              OpenAI::Graders::GraderInputItem::OutputText,
-              OpenAI::Graders::GraderInputItem::InputImage,
-              OpenAI::Responses::ResponseInputAudio
-            )
-          end
-
-        class OutputText < OpenAI::Internal::Type::BaseModel
-          OrHash =
-            T.type_alias do
-              T.any(
-                OpenAI::Graders::GraderInputItem::OutputText,
-                OpenAI::Internal::AnyHash
-              )
-            end
-
-          # The text output from the model.
-          sig { returns(String) }
-          attr_accessor :text
-
-          # The type of the output text. Always `output_text`.
-          sig { returns(Symbol) }
-          attr_accessor :type
-
-          # A text output from the model.
-          sig { params(text: String, type: Symbol).returns(T.attached_class) }
-          def self.new(
-            # The text output from the model.
-            text:,
-            # The type of the output text. Always `output_text`.
-            type: :output_text
-          )
-          end
-
-          sig { override.returns({ text: String, type: Symbol }) }
-          def to_hash
-          end
-        end
-
-        class InputImage < OpenAI::Internal::Type::BaseModel
-          OrHash =
-            T.type_alias do
-              T.any(
-                OpenAI::Graders::GraderInputItem::InputImage,
-                OpenAI::Internal::AnyHash
-              )
-            end
-
-          # The URL of the image input.
-          sig { returns(String) }
-          attr_accessor :image_url
-
-          # The type of the image input. Always `input_image`.
-          sig { returns(Symbol) }
-          attr_accessor :type
-
-          # The detail level of the image to be sent to the model. One of `high`, `low`, or
-          # `auto`. Defaults to `auto`.
-          sig { returns(T.nilable(String)) }
-          attr_reader :detail
-
-          sig { params(detail: String).void }
-          attr_writer :detail
-
-          # An image input block used within EvalItem content arrays.
-          sig do
-            params(image_url: String, detail: String, type: Symbol).returns(
-              T.attached_class
-            )
-          end
-          def self.new(
-            # The URL of the image input.
-            image_url:,
-            # The detail level of the image to be sent to the model. One of `high`, `low`, or
-            # `auto`. Defaults to `auto`.
-            detail: nil,
-            # The type of the image input. Always `input_image`.
-            type: :input_image
-          )
-          end
-
-          sig do
-            override.returns(
-              { image_url: String, type: Symbol, detail: String }
-            )
-          end
-          def to_hash
-          end
-        end
-
-        sig do
-          override.returns(T::Array[OpenAI::Graders::GraderInputItem::Variants])
-        end
-        def self.variants
-        end
-      end
-
       GraderInputs =
         T.let(
           OpenAI::Internal::Type::ArrayOf[

data/rbi/openai/models/image.rbi

@@ -5,9 +5,9 @@ module OpenAI
     class Image < OpenAI::Internal::Type::BaseModel
       OrHash = T.type_alias { T.any(OpenAI::Image, OpenAI::Internal::AnyHash) }
 
-      # The base64-encoded JSON of the generated image. Default value for `gpt-image-1`,
-      # and only present if `response_format` is set to `b64_json` for `dall-e-2` and
-      # `dall-e-3`.
+      # The base64-encoded JSON of the generated image. Returned by default for the GPT
+      # image models, and only present if `response_format` is set to `b64_json` for
+      # `dall-e-2` and `dall-e-3`.
       sig { returns(T.nilable(String)) }
       attr_reader :b64_json
 
@@ -22,8 +22,8 @@ module OpenAI
       attr_writer :revised_prompt
 
       # When using `dall-e-2` or `dall-e-3`, the URL of the generated image if
-      # `response_format` is set to `url` (default value). Unsupported for
-      # `gpt-image-1`.
+      # `response_format` is set to `url` (default value). Unsupported for the GPT image
+      # models.
       sig { returns(T.nilable(String)) }
       attr_reader :url
 
@@ -37,15 +37,15 @@ module OpenAI
         )
       end
       def self.new(
-        # The base64-encoded JSON of the generated image. Default value for `gpt-image-1`,
-        # and only present if `response_format` is set to `b64_json` for `dall-e-2` and
-        # `dall-e-3`.
+        # The base64-encoded JSON of the generated image. Returned by default for the GPT
+        # image models, and only present if `response_format` is set to `b64_json` for
+        # `dall-e-2` and `dall-e-3`.
         b64_json: nil,
         # For `dall-e-3` only, the revised prompt that was used to generate the image.
         revised_prompt: nil,
         # When using `dall-e-2` or `dall-e-3`, the URL of the generated image if
-        # `response_format` is set to `url` (default value). Unsupported for
-        # `gpt-image-1`.
+        # `response_format` is set to `url` (default value). Unsupported for the GPT image
+        # models.
         url: nil
       )
       end

data/rbi/openai/models/image_edit_completed_event.rbi

@@ -38,7 +38,8 @@ module OpenAI
       sig { returns(Symbol) }
       attr_accessor :type
 
-      # For `gpt-image-1` only, the token usage information for the image generation.
+      # For the GPT image models only, the token usage information for the image
+      # generation.
       sig { returns(OpenAI::ImageEditCompletedEvent::Usage) }
       attr_reader :usage
 
@@ -72,7 +73,8 @@ module OpenAI
         quality:,
         # The size of the edited image.
         size:,
-        # For `gpt-image-1` only, the token usage information for the image generation.
+        # For the GPT image models only, the token usage information for the image
+        # generation.
         usage:,
         # The type of the event. Always `image_edit.completed`.
         type: :"image_edit.completed"
@@ -267,7 +269,8 @@ module OpenAI
         sig { returns(Integer) }
         attr_accessor :total_tokens
 
-        # For `gpt-image-1` only, the token usage information for the image generation.
+        # For the GPT image models only, the token usage information for the image
+        # generation.
         sig do
           params(
             input_tokens: Integer,