openai 0.53.0 → 0.55.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b766e29a63caac40f46433aca7cf7624c2f2f19b74e4948afab86e27bb8d6e3
-  data.tar.gz: '070255620935603f097a6bedfe7430ba91877b4fb603b5530899b8380ef6ce35'
+  metadata.gz: 1829322792fdc33445abe86fe08267e3b93d183511e2e1651ef6e1cd81ecc1b8
+  data.tar.gz: 2b9578ceacd8423c77d35e7c3f0e3f7fb9d56bcd971403a83dedf8bb0cb9fa51
 SHA512:
-  metadata.gz: 8d8d216165e0f85bafb298a5ea2aee7938a07a44258b2f2521f8dec6ef7319b4a6026c2aa4989ad99f3aa3b9dd712f42984103d8b78a092483d0bff175b04168
-  data.tar.gz: aa9d16013208f0c29398f428f9af76f29da7307be8fe15389879748fbc8fc2d379a7adf4eac3a4933aa3d8de9c13c8ed6c1f99b1699b7e95d0b7ecad002879be
+  metadata.gz: 6a248621c5aea0ac33ad525d91dfae5e7b9934c18b8e7a172685dade248784c44b7d262ba1575472efdec948be1cc52e4d588845a13a12f2bb87854d196fd095
+  data.tar.gz: 1247752dd4600a775ea0d52f977d360348bf0ade61b5274bcd92a135d5a86db2acaf689feb9cd35e58f33db37d246dee6e37a9e0d2c0b4b704fe46920079312f

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.55.0 (2026-03-13)
+
+Full Changelog: [v0.54.0...v0.55.0](https://github.com/openai/openai-ruby/compare/v0.54.0...v0.55.0)
+
+### Features
+
+* **api:** custom voices ([a9f7891](https://github.com/openai/openai-ruby/commit/a9f78916b97e3a59f35dbcac05c725474e6634af))
+
+## 0.54.0 (2026-03-13)
+
+Full Changelog: [v0.53.0...v0.54.0](https://github.com/openai/openai-ruby/compare/v0.53.0...v0.54.0)
+
+### Features
+
+* **api:** api update ([235124c](https://github.com/openai/openai-ruby/commit/235124c18886d02e2373c8075354cd19cf928a1d))
+* **api:** manual updates ([d1ee93f](https://github.com/openai/openai-ruby/commit/d1ee93fd53b18ba7a6c38d75ecac9ab6b6eade9f))
+* **api:** manual updates ([8f13ded](https://github.com/openai/openai-ruby/commit/8f13ded017186651bbfaf679e429d7436183f8c0))
+* **api:** sora api improvements: character api, video extensions/edits, higher resolution exports. ([58a8c4d](https://github.com/openai/openai-ruby/commit/58a8c4d13897c6be6735e5255e4e7308c9a7cc44))
+* **client:** add webhook support ([3a2425f](https://github.com/openai/openai-ruby/commit/3a2425ff3ac8cfb883e38e56c1c76585ce6a8ab5))
+
+
+### Chores
+
+* **internal:** codegen related update ([2100fc4](https://github.com/openai/openai-ruby/commit/2100fc4105da779d09e15723c9ad22eb7a6ad307))
+
 ## 0.53.0 (2026-03-05)
 
 Full Changelog: [v0.52.0...v0.53.0](https://github.com/openai/openai-ruby/compare/v0.52.0...v0.53.0)

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.53.0"
+gem "openai", "~> 0.55.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/models/audio/speech_create_params.rb

@@ -24,11 +24,12 @@ module OpenAI
         # @!attribute voice
         #   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
+        #   `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice
+        #   object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
+        #   voices are available in the
         #   [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
         #
-        #   @return [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice]
+        #   @return [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice::ID, OpenAI::Models::Audio::SpeechCreateParams::Voice]
         required :voice, union: -> { OpenAI::Audio::SpeechCreateParams::Voice }
 
         # @!attribute instructions
@@ -67,7 +68,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 built-in voices are `alloy
+        #   @param voice [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice::ID, 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
         #
@@ -95,8 +96,9 @@ module OpenAI
 
         # 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
+        # `shimmer`, `verse`, `marin`, and `cedar`. You may also provide a custom voice
+        # object with an `id`, for example `{ "id": "voice_1234" }`. 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
@@ -123,11 +125,33 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Audio::SpeechCreateParams::Voice::CEDAR }
 
+          # Custom voice reference.
+          variant -> { OpenAI::Audio::SpeechCreateParams::Voice::ID }
+
+          class ID < OpenAI::Internal::Type::BaseModel
+            # @!attribute id
+            #   The custom voice ID, e.g. `voice_1234`.
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!method initialize(id:)
+            #   Custom voice reference.
+            #
+            #   @param id [String] The custom voice ID, e.g. `voice_1234`.
+          end
+
           # @!method self.variants
-          #   @return [Array(String, Symbol)]
+          #   @return [Array(String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice::ID)]
 
           define_sorbet_constant!(:Variants) do
-            T.type_alias { T.any(String, OpenAI::Audio::SpeechCreateParams::Voice::TaggedSymbol) }
+            T.type_alias do
+              T.any(
+                String,
+                OpenAI::Audio::SpeechCreateParams::Voice::TaggedSymbol,
+                OpenAI::Audio::SpeechCreateParams::Voice::ID
+              )
+            end
           end
 
           # @!group

data/lib/openai/models/chat/chat_completion_audio_param.rb

@@ -14,9 +14,10 @@ module OpenAI
         # @!attribute voice
         #   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`.
+        #   `marin`, and `cedar`. You may also provide a custom voice object with an `id`,
+        #   for example `{ "id": "voice_1234" }`.
         #
-        #   @return [String, Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice]
+        #   @return [String, Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice::ID, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice]
         required :voice, union: -> { OpenAI::Chat::ChatCompletionAudioParam::Voice }
 
         # @!method initialize(format_:, voice:)
@@ -29,7 +30,7 @@ module OpenAI
         #
         #   @param format_ [Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Format] Specifies the output audio format. Must be one of `wav`, `mp3`, `flac`,
         #
-        #   @param voice [String, Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice] The voice the model uses to respond. Supported built-in voices are `alloy`, `ash
+        #   @param voice [String, Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice::ID, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice] The voice the model uses to respond. Supported built-in voices are
 
         # Specifies the output audio format. Must be one of `wav`, `mp3`, `flac`, `opus`,
         # or `pcm16`.
@@ -51,7 +52,8 @@ module OpenAI
 
         # 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`.
+        # `marin`, and `cedar`. You may also provide a custom voice object with an `id`,
+        # for example `{ "id": "voice_1234" }`.
         #
         # @see OpenAI::Models::Chat::ChatCompletionAudioParam#voice
         module Voice
@@ -79,11 +81,33 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Chat::ChatCompletionAudioParam::Voice::CEDAR }
 
+          # Custom voice reference.
+          variant -> { OpenAI::Chat::ChatCompletionAudioParam::Voice::ID }
+
+          class ID < OpenAI::Internal::Type::BaseModel
+            # @!attribute id
+            #   The custom voice ID, e.g. `voice_1234`.
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!method initialize(id:)
+            #   Custom voice reference.
+            #
+            #   @param id [String] The custom voice ID, e.g. `voice_1234`.
+          end
+
           # @!method self.variants
-          #   @return [Array(String, Symbol)]
+          #   @return [Array(String, Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice::ID)]
 
           define_sorbet_constant!(:Variants) do
-            T.type_alias { T.any(String, OpenAI::Chat::ChatCompletionAudioParam::Voice::TaggedSymbol) }
+            T.type_alias do
+              T.any(
+                String,
+                OpenAI::Chat::ChatCompletionAudioParam::Voice::TaggedSymbol,
+                OpenAI::Chat::ChatCompletionAudioParam::Voice::ID
+              )
+            end
           end
 
           # @!group

data/lib/openai/models/image_input_reference_param.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    class ImageInputReferenceParam < OpenAI::Internal::Type::BaseModel
+      # @!attribute file_id
+      #
+      #   @return [String, nil]
+      optional :file_id, String
+
+      # @!attribute image_url
+      #   A fully qualified URL or base64-encoded data URL.
+      #
+      #   @return [String, nil]
+      optional :image_url, String
+
+      # @!method initialize(file_id: nil, image_url: nil)
+      #   @param file_id [String]
+      #
+      #   @param image_url [String] A fully qualified URL or base64-encoded data URL.
+    end
+  end
+end

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

@@ -25,10 +25,12 @@ module OpenAI
         # @!attribute voice
         #   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.
+        #   `cedar`. You may also provide a custom voice object with an `id`, for example
+        #   `{ "id": "voice_1234" }`. 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.
         #
-        #   @return [String, Symbol, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice, nil]
+        #   @return [String, Symbol, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice::ID, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice, nil]
         optional :voice, union: -> { OpenAI::Realtime::RealtimeAudioConfigOutput::Voice }
 
         # @!method initialize(format_: nil, speed: nil, voice: nil)
@@ -39,12 +41,14 @@ module OpenAI
         #
         #   @param speed [Float] The speed of the model's spoken response as a multiple of the original speed.
         #
-        #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice] The voice the model uses to respond. Supported built-in voices are `alloy`, `ash
+        #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice::ID, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice] The voice the model uses to respond. Supported built-in voices are
 
         # 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.
+        # `cedar`. You may also provide a custom voice object with an `id`, for example
+        # `{ "id": "voice_1234" }`. 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.
         #
         # @see OpenAI::Models::Realtime::RealtimeAudioConfigOutput#voice
         module Voice
@@ -72,11 +76,33 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice::CEDAR }
 
+          # Custom voice reference.
+          variant -> { OpenAI::Realtime::RealtimeAudioConfigOutput::Voice::ID }
+
+          class ID < OpenAI::Internal::Type::BaseModel
+            # @!attribute id
+            #   The custom voice ID, e.g. `voice_1234`.
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!method initialize(id:)
+            #   Custom voice reference.
+            #
+            #   @param id [String] The custom voice ID, e.g. `voice_1234`.
+          end
+
           # @!method self.variants
-          #   @return [Array(String, Symbol)]
+          #   @return [Array(String, Symbol, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice::ID)]
 
           define_sorbet_constant!(:Variants) do
-            T.type_alias { T.any(String, OpenAI::Realtime::RealtimeAudioConfigOutput::Voice::TaggedSymbol) }
+            T.type_alias do
+              T.any(
+                String,
+                OpenAI::Realtime::RealtimeAudioConfigOutput::Voice::TaggedSymbol,
+                OpenAI::Realtime::RealtimeAudioConfigOutput::Voice::ID
+              )
+            end
           end
 
           # @!group

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

@@ -25,10 +25,12 @@ module OpenAI
           # @!attribute voice
           #   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.
+          #   `cedar`. You may also provide a custom voice object with an `id`, for example
+          #   `{ "id": "voice_1234" }`. 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.
           #
-          #   @return [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice, nil]
+          #   @return [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::ID, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice, nil]
           optional :voice, union: -> { OpenAI::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice }
 
           # @!method initialize(format_: nil, voice: nil)
@@ -38,12 +40,14 @@ module OpenAI
           #
           #   @param format_ [OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCM, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMU, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMA] The format of the output audio.
           #
-          #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice] The voice the model uses to respond. Supported built-in voices are `alloy`, `ash
+          #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::ID, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice] The voice the model uses to respond. Supported built-in voices are
 
           # 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.
+          # `cedar`. You may also provide a custom voice object with an `id`, for example
+          # `{ "id": "voice_1234" }`. 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.
           #
           # @see OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output#voice
           module Voice
@@ -71,11 +75,33 @@ module OpenAI
 
             variant const: -> { OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::CEDAR }
 
+            # Custom voice reference.
+            variant -> { OpenAI::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::ID }
+
+            class ID < OpenAI::Internal::Type::BaseModel
+              # @!attribute id
+              #   The custom voice ID, e.g. `voice_1234`.
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!method initialize(id:)
+              #   Custom voice reference.
+              #
+              #   @param id [String] The custom voice ID, e.g. `voice_1234`.
+            end
+
             # @!method self.variants
-            #   @return [Array(String, Symbol)]
+            #   @return [Array(String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::ID)]
 
             define_sorbet_constant!(:Variants) do
-              T.type_alias { T.any(String, OpenAI::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::TaggedSymbol) }
+              T.type_alias do
+                T.any(
+                  String,
+                  OpenAI::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::TaggedSymbol,
+                  OpenAI::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice::ID
+                )
+              end
             end
 
             # @!group

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

@@ -10,13 +10,6 @@ module OpenAI
         #   @return [Symbol, :input_file]
         required :type, const: :input_file
 
-        # @!attribute detail
-        #   The detail level of the file to be sent to the model. One of `high` or `low`.
-        #   Defaults to `high`.
-        #
-        #   @return [Symbol, OpenAI::Models::Responses::ResponseInputFile::Detail, nil]
-        optional :detail, enum: -> { OpenAI::Responses::ResponseInputFile::Detail }
-
         # @!attribute file_data
         #   The content of the file to be sent to the model.
         #
@@ -41,14 +34,12 @@ module OpenAI
         #   @return [String, nil]
         optional :filename, String
 
-        # @!method initialize(detail: nil, file_data: nil, file_id: nil, file_url: nil, filename: nil, type: :input_file)
+        # @!method initialize(file_data: nil, file_id: nil, file_url: nil, filename: nil, type: :input_file)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseInputFile} for more details.
         #
         #   A file input to the model.
         #
-        #   @param detail [Symbol, OpenAI::Models::Responses::ResponseInputFile::Detail] The detail level of the file to be sent to the model. One of `high` or `low`. De
-        #
         #   @param file_data [String] The content of the file to be sent to the model.
         #
         #   @param file_id [String, nil] The ID of the file to be sent to the model.
@@ -58,20 +49,6 @@ module OpenAI
         #   @param filename [String] The name of the file to be sent to the model.
         #
         #   @param type [Symbol, :input_file] The type of the input item. Always `input_file`.
-
-        # The detail level of the file to be sent to the model. One of `high` or `low`.
-        # Defaults to `high`.
-        #
-        # @see OpenAI::Models::Responses::ResponseInputFile#detail
-        module Detail
-          extend OpenAI::Internal::Type::Enum
-
-          LOW = :low
-          HIGH = :high
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
       end
     end
   end

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

@@ -10,13 +10,6 @@ module OpenAI
         #   @return [Symbol, :input_file]
         required :type, const: :input_file
 
-        # @!attribute detail
-        #   The detail level of the file to be sent to the model. One of `high` or `low`.
-        #   Defaults to `high`.
-        #
-        #   @return [Symbol, OpenAI::Models::Responses::ResponseInputFileContent::Detail, nil]
-        optional :detail, enum: -> { OpenAI::Responses::ResponseInputFileContent::Detail }
-
         # @!attribute file_data
         #   The base64-encoded data of the file to be sent to the model.
         #
@@ -41,14 +34,9 @@ module OpenAI
         #   @return [String, nil]
         optional :filename, String, nil?: true
 
-        # @!method initialize(detail: nil, file_data: nil, file_id: nil, file_url: nil, filename: nil, type: :input_file)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::ResponseInputFileContent} for more details.
-        #
+        # @!method initialize(file_data: nil, file_id: nil, file_url: nil, filename: nil, type: :input_file)
         #   A file input to the model.
         #
-        #   @param detail [Symbol, OpenAI::Models::Responses::ResponseInputFileContent::Detail] The detail level of the file to be sent to the model. One of `high` or `low`. De
-        #
         #   @param file_data [String, nil] The base64-encoded data of the file to be sent to the model.
         #
         #   @param file_id [String, nil] The ID of the file to be sent to the model.
@@ -58,20 +46,6 @@ module OpenAI
         #   @param filename [String, nil] The name of the file to be sent to the model.
         #
         #   @param type [Symbol, :input_file] The type of the input item. Always `input_file`.
-
-        # The detail level of the file to be sent to the model. One of `high` or `low`.
-        # Defaults to `high`.
-        #
-        # @see OpenAI::Models::Responses::ResponseInputFileContent#detail
-        module Detail
-          extend OpenAI::Internal::Type::Enum
-
-          HIGH = :high
-          LOW = :low
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
       end
     end
   end

data/lib/openai/models/video_create_character_params.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    # @see OpenAI::Resources::Videos#create_character
+    class VideoCreateCharacterParams < OpenAI::Internal::Type::BaseModel
+      extend OpenAI::Internal::Type::RequestParameters::Converter
+      include OpenAI::Internal::Type::RequestParameters
+
+      # @!attribute name
+      #   Display name for this API character.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute video
+      #   Video file used to create a character.
+      #
+      #   @return [Pathname, StringIO, IO, String, OpenAI::FilePart]
+      required :video, OpenAI::Internal::Type::FileInput
+
+      # @!method initialize(name:, video:, request_options: {})
+      #   @param name [String] Display name for this API character.
+      #
+      #   @param video [Pathname, StringIO, IO, String, OpenAI::FilePart] Video file used to create a character.
+      #
+      #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/openai/models/video_create_character_response.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    # @see OpenAI::Resources::Videos#create_character
+    class VideoCreateCharacterResponse < OpenAI::Internal::Type::BaseModel
+      # @!attribute id
+      #   Identifier for the character creation cameo.
+      #
+      #   @return [String, nil]
+      required :id, String, nil?: true
+
+      # @!attribute created_at
+      #   Unix timestamp (in seconds) when the character was created.
+      #
+      #   @return [Integer]
+      required :created_at, Integer
+
+      # @!attribute name
+      #   Display name for the character.
+      #
+      #   @return [String, nil]
+      required :name, String, nil?: true
+
+      # @!method initialize(id:, created_at:, name:)
+      #   @param id [String, nil] Identifier for the character creation cameo.
+      #
+      #   @param created_at [Integer] Unix timestamp (in seconds) when the character was created.
+      #
+      #   @param name [String, nil] Display name for the character.
+    end
+  end
+end

data/lib/openai/models/video_create_params.rb

@@ -14,10 +14,10 @@ module OpenAI
       required :prompt, String
 
       # @!attribute input_reference
-      #   Optional multipart reference asset that guides generation.
+      #   Optional reference asset upload or reference object that guides generation.
       #
-      #   @return [Pathname, StringIO, IO, String, OpenAI::FilePart, nil]
-      optional :input_reference, OpenAI::Internal::Type::FileInput
+      #   @return [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::ImageInputReferenceParam, nil]
+      optional :input_reference, union: -> { OpenAI::VideoCreateParams::InputReference }
 
       # @!attribute model
       #   The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
@@ -45,7 +45,7 @@ module OpenAI
       #
       #   @param prompt [String] Text prompt that describes the video to generate.
       #
-      #   @param input_reference [Pathname, StringIO, IO, String, OpenAI::FilePart] Optional multipart reference asset that guides generation.
+      #   @param input_reference [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::ImageInputReferenceParam] Optional reference asset upload or reference object that guides generation.
       #
       #   @param model [String, Symbol, OpenAI::Models::VideoModel] The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
       #
@@ -54,6 +54,19 @@ module OpenAI
       #   @param size [Symbol, OpenAI::Models::VideoSize] Output resolution formatted as width x height (allowed values: 720x1280, 1280x72
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+      # Optional reference asset upload or reference object that guides generation.
+      module InputReference
+        extend OpenAI::Internal::Type::Union
+
+        # Optional reference asset upload or reference object that guides generation.
+        variant OpenAI::Internal::Type::FileInput
+
+        variant -> { OpenAI::ImageInputReferenceParam }
+
+        # @!method self.variants
+        #   @return [Array(StringIO, OpenAI::Models::ImageInputReferenceParam)]
+      end
     end
   end
 end

data/lib/openai/models/video_edit_params.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    # @see OpenAI::Resources::Videos#edit
+    class VideoEditParams < OpenAI::Internal::Type::BaseModel
+      extend OpenAI::Internal::Type::RequestParameters::Converter
+      include OpenAI::Internal::Type::RequestParameters
+
+      # @!attribute prompt
+      #   Text prompt that describes how to edit the source video.
+      #
+      #   @return [String]
+      required :prompt, String
+
+      # @!attribute video
+      #   Reference to the completed video to edit.
+      #
+      #   @return [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoEditParams::Video::VideoReferenceInputParam]
+      required :video, union: -> { OpenAI::VideoEditParams::Video }
+
+      # @!method initialize(prompt:, video:, request_options: {})
+      #   @param prompt [String] Text prompt that describes how to edit the source video.
+      #
+      #   @param video [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoEditParams::Video::VideoReferenceInputParam] Reference to the completed video to edit.
+      #
+      #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+      # Reference to the completed video to edit.
+      module Video
+        extend OpenAI::Internal::Type::Union
+
+        # Reference to the completed video to edit.
+        variant OpenAI::Internal::Type::FileInput
+
+        # Reference to the completed video.
+        variant -> { OpenAI::VideoEditParams::Video::VideoReferenceInputParam }
+
+        class VideoReferenceInputParam < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The identifier of the completed video.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!method initialize(id:)
+          #   Reference to the completed video.
+          #
+          #   @param id [String] The identifier of the completed video.
+        end
+
+        # @!method self.variants
+        #   @return [Array(StringIO, OpenAI::Models::VideoEditParams::Video::VideoReferenceInputParam)]
+      end
+    end
+  end
+end