openai 0.54.0 → 0.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83d02aadc8a7e6f7b37049c3d9f4aeaea7431550be5d59b39125caac69dc0b8d
-  data.tar.gz: 65952c4730694ec1d6d8e94975574830caaa4b00af59102004c22193eeddd084
+  metadata.gz: 8a0399e48fa95f65032c615357845d2a29d1c0ce34677cf08fc446657061fcc7
+  data.tar.gz: 52a29c39bcea24e9d9cac99bf840a7f5f4de0ca2ff20b897607dc86e5396eae4
 SHA512:
-  metadata.gz: 0cdf744110926dcc10a24efcb6d945f23da0390a72827434ab6b0cd9308e1e5a9f64e6d7f8d304c206c146caf10fc8d06c242c3f6447ed7d052bb60f302f905a
-  data.tar.gz: 5cc663414eead8566eaefb21714a5fad8e1bbaa5ed5f8b297d4af45909b4cc0ea34d96fa273cc85e587f4fa41cc263b0c5b88db67e4c22e24a10cbb48822165b
+  metadata.gz: 4efb1d88dae705b22655d2ba203fa0d05a6106f142683dcebf02de9002dece4dedf55422bb84cc3be58f73e2c6fe4a38dc5641abae5bc5a2ce9361e23737fec3
+  data.tar.gz: '091021a04c89b45d3ffc6cd8ee096adb98d7ef0bb886c6db3c48a66178d833044539664f4fdd9848326550b6c07f5123f5daeca737972523356b50368d558535'

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.56.0 (2026-03-17)
+
+Full Changelog: [v0.55.0...v0.56.0](https://github.com/openai/openai-ruby/compare/v0.55.0...v0.56.0)
+
+### Features
+
+* **api:** 5.4 nano and mini model slugs ([ce7f09d](https://github.com/openai/openai-ruby/commit/ce7f09dcafdb1a8259ce14d0e7c012b872469a32))
+* **api:** add /v1/videos endpoint support to batch create params ([7a661eb](https://github.com/openai/openai-ruby/commit/7a661eb405c72bb2696e0acd327ecd56d7ed6c54))
+* **api:** add defer_loading field to namespace_tool function ([2f3b9b7](https://github.com/openai/openai-ruby/commit/2f3b9b7a2fa7b63ed20d362a993d98d8cec72fc1))
+* **api:** add in/nin operators to ComparisonFilter ([70c8bf5](https://github.com/openai/openai-ruby/commit/70c8bf55c4d0e2054e23972479edb09c0d8f3d8e))
+
+
+### Chores
+
+* **internal:** tweak CI branches ([1a5054f](https://github.com/openai/openai-ruby/commit/1a5054f561a63a4b19c0d2a035e1c45dcfbc21fc))
+
+## 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)

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

data/lib/openai/internal/type/enum.rb

@@ -21,9 +21,9 @@ module OpenAI
       #   case chat_model
       #   when OpenAI::ChatModel::GPT_5_4
       #     # ...
-      #   when OpenAI::ChatModel::GPT_5_3_CHAT_LATEST
+      #   when OpenAI::ChatModel::GPT_5_4_MINI
       #     # ...
-      #   when OpenAI::ChatModel::GPT_5_2
+      #   when OpenAI::ChatModel::GPT_5_4_NANO
       #     # ...
       #   else
       #     puts(chat_model)
@@ -33,9 +33,9 @@ module OpenAI
       #   case chat_model
       #   in :"gpt-5.4"
       #     # ...
-      #   in :"gpt-5.3-chat-latest"
+      #   in :"gpt-5.4-mini"
       #     # ...
-      #   in :"gpt-5.2"
+      #   in :"gpt-5.4-nano"
       #     # ...
       #   else
       #     puts(chat_model)

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/batch_create_params.rb

@@ -17,9 +17,10 @@ module OpenAI
       # @!attribute endpoint
       #   The endpoint to be used for all requests in the batch. Currently
       #   `/v1/responses`, `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`,
-      #   `/v1/moderations`, `/v1/images/generations`, and `/v1/images/edits` are
-      #   supported. Note that `/v1/embeddings` batches are also restricted to a maximum
-      #   of 50,000 embedding inputs across all requests in the batch.
+      #   `/v1/moderations`, `/v1/images/generations`, `/v1/images/edits`, and
+      #   `/v1/videos` are supported. Note that `/v1/embeddings` batches are also
+      #   restricted to a maximum of 50,000 embedding inputs across all requests in the
+      #   batch.
       #
       #   @return [Symbol, OpenAI::Models::BatchCreateParams::Endpoint]
       required :endpoint, enum: -> { OpenAI::BatchCreateParams::Endpoint }
@@ -85,9 +86,10 @@ module OpenAI
 
       # The endpoint to be used for all requests in the batch. Currently
       # `/v1/responses`, `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`,
-      # `/v1/moderations`, `/v1/images/generations`, and `/v1/images/edits` are
-      # supported. Note that `/v1/embeddings` batches are also restricted to a maximum
-      # of 50,000 embedding inputs across all requests in the batch.
+      # `/v1/moderations`, `/v1/images/generations`, `/v1/images/edits`, and
+      # `/v1/videos` are supported. Note that `/v1/embeddings` batches are also
+      # restricted to a maximum of 50,000 embedding inputs across all requests in the
+      # batch.
       module Endpoint
         extend OpenAI::Internal::Type::Enum
 
@@ -98,6 +100,7 @@ module OpenAI
         V1_MODERATIONS = :"/v1/moderations"
         V1_IMAGES_GENERATIONS = :"/v1/images/generations"
         V1_IMAGES_EDITS = :"/v1/images/edits"
+        V1_VIDEOS = :"/v1/videos"
 
         # @!method self.values
         #   @return [Array<Symbol>]

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/chat_model.rb

@@ -6,6 +6,10 @@ module OpenAI
       extend OpenAI::Internal::Type::Enum
 
       GPT_5_4 = :"gpt-5.4"
+      GPT_5_4_MINI = :"gpt-5.4-mini"
+      GPT_5_4_NANO = :"gpt-5.4-nano"
+      GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+      GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
       GPT_5_3_CHAT_LATEST = :"gpt-5.3-chat-latest"
       GPT_5_2 = :"gpt-5.2"
       GPT_5_2_2025_12_11 = :"gpt-5.2-2025-12-11"

data/lib/openai/models/comparison_filter.rb

@@ -67,6 +67,8 @@ module OpenAI
         GTE = :gte
         LT = :lt
         LTE = :lte
+        IN = :in
+        NIN = :nin
 
         # @!method self.values
         #   @return [Array<Symbol>]

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/namespace_tool.rb

@@ -61,6 +61,12 @@ module OpenAI
             #   @return [Symbol, :function]
             required :type, const: :function
 
+            # @!attribute defer_loading
+            #   Whether this function should be deferred and discovered via tool search.
+            #
+            #   @return [Boolean, nil]
+            optional :defer_loading, OpenAI::Internal::Type::Boolean
+
             # @!attribute description
             #
             #   @return [String, nil]
@@ -76,11 +82,17 @@ module OpenAI
             #   @return [Boolean, nil]
             optional :strict, OpenAI::Internal::Type::Boolean, nil?: true
 
-            # @!method initialize(name:, description: nil, parameters: nil, strict: nil, type: :function)
+            # @!method initialize(name:, defer_loading: nil, description: nil, parameters: nil, strict: nil, type: :function)
             #   @param name [String]
+            #
+            #   @param defer_loading [Boolean] Whether this function should be deferred and discovered via tool search.
+            #
             #   @param description [String, nil]
+            #
             #   @param parameters [Object, nil]
+            #
             #   @param strict [Boolean, nil]
+            #
             #   @param type [Symbol, :function]
           end
 

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

@@ -74,6 +74,14 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_4 }
 
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_4_MINI }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_4_NANO }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_4_MINI_2026_03_17 }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_4_NANO_2026_03_17 }
+
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_3_CHAT_LATEST }
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_2 }
@@ -260,6 +268,10 @@ module OpenAI
           # @!group
 
           GPT_5_4 = :"gpt-5.4"
+          GPT_5_4_MINI = :"gpt-5.4-mini"
+          GPT_5_4_NANO = :"gpt-5.4-nano"
+          GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+          GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
           GPT_5_3_CHAT_LATEST = :"gpt-5.3-chat-latest"
           GPT_5_2 = :"gpt-5.2"
           GPT_5_2_2025_12_11 = :"gpt-5.2-2025-12-11"

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

@@ -18,7 +18,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
         #

data/lib/openai/version.rb

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

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

@@ -23,12 +23,17 @@ 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).
         sig do
           returns(
-            T.any(String, OpenAI::Audio::SpeechCreateParams::Voice::OrSymbol)
+            T.any(
+              String,
+              OpenAI::Audio::SpeechCreateParams::Voice::OrSymbol,
+              OpenAI::Audio::SpeechCreateParams::Voice::ID
+            )
           )
         end
         attr_accessor :voice
@@ -90,7 +95,11 @@ module OpenAI
             input: String,
             model: T.any(String, OpenAI::Audio::SpeechModel::OrSymbol),
             voice:
-              T.any(String, OpenAI::Audio::SpeechCreateParams::Voice::OrSymbol),
+              T.any(
+                String,
+                OpenAI::Audio::SpeechCreateParams::Voice::OrSymbol,
+                OpenAI::Audio::SpeechCreateParams::Voice::ID::OrHash
+              ),
             instructions: String,
             response_format:
               OpenAI::Audio::SpeechCreateParams::ResponseFormat::OrSymbol,
@@ -108,8 +117,9 @@ module OpenAI
           model:,
           # 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).
           voice:,
           # Control the voice of your generated audio with additional instructions. Does not
@@ -136,7 +146,8 @@ module OpenAI
               voice:
                 T.any(
                   String,
-                  OpenAI::Audio::SpeechCreateParams::Voice::OrSymbol
+                  OpenAI::Audio::SpeechCreateParams::Voice::OrSymbol,
+                  OpenAI::Audio::SpeechCreateParams::Voice::ID
                 ),
               instructions: String,
               response_format:
@@ -172,8 +183,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
@@ -182,10 +194,37 @@ module OpenAI
             T.type_alias do
               T.any(
                 String,
-                OpenAI::Audio::SpeechCreateParams::Voice::TaggedSymbol
+                OpenAI::Audio::SpeechCreateParams::Voice::TaggedSymbol,
+                OpenAI::Audio::SpeechCreateParams::Voice::ID
               )
             end
 
+          class ID < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Audio::SpeechCreateParams::Voice::ID,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # The custom voice ID, e.g. `voice_1234`.
+            sig { returns(String) }
+            attr_accessor :id
+
+            # Custom voice reference.
+            sig { params(id: String).returns(T.attached_class) }
+            def self.new(
+              # The custom voice ID, e.g. `voice_1234`.
+              id:
+            )
+            end
+
+            sig { override.returns({ id: String }) }
+            def to_hash
+            end
+          end
+
           sig do
             override.returns(
               T::Array[OpenAI::Audio::SpeechCreateParams::Voice::Variants]