openai 0.71.0 → 0.73.0

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

@@ -10,6 +10,13 @@ module OpenAI
         #   @return [String]
         required :text, String
 
+        # @!attribute languages
+        #   The languages detected in the audio. Returned by `gpt-transcribe`. An empty
+        #   array indicates that no language could be reliably detected.
+        #
+        #   @return [Array<OpenAI::Models::Audio::TranscriptionLanguage>, nil]
+        optional :languages, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Audio::TranscriptionLanguage] }
+
         # @!attribute logprobs
         #   The log probabilities of the tokens in the transcription. Only returned with the
         #   models `gpt-4o-transcribe` and `gpt-4o-mini-transcribe` if `logprobs` is added
@@ -24,7 +31,7 @@ module OpenAI
         #   @return [OpenAI::Models::Audio::Transcription::Usage::Tokens, OpenAI::Models::Audio::Transcription::Usage::Duration, nil]
         optional :usage, union: -> { OpenAI::Audio::Transcription::Usage }
 
-        # @!method initialize(text:, logprobs: nil, usage: nil)
+        # @!method initialize(text:, languages: nil, logprobs: nil, usage: nil)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Audio::Transcription} for more details.
         #
@@ -33,6 +40,8 @@ module OpenAI
         #
         #   @param text [String] The transcribed text.
         #
+        #   @param languages [Array<OpenAI::Models::Audio::TranscriptionLanguage>] The languages detected in the audio. Returned by `gpt-transcribe`. An empty arra
+        #
         #   @param logprobs [Array<OpenAI::Models::Audio::Transcription::Logprob>] The log probabilities of the tokens in the transcription. Only returned with the
         #
         #   @param usage [OpenAI::Models::Audio::Transcription::Usage::Tokens, OpenAI::Models::Audio::Transcription::Usage::Duration] Token usage statistics for the request.

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

@@ -18,7 +18,7 @@ module OpenAI
         required :file, OpenAI::Internal::Type::FileInput
 
         # @!attribute model
-        #   ID of the model to use. The options are `gpt-4o-transcribe`,
+        #   ID of the model to use. The options are `gpt-transcribe`, `gpt-4o-transcribe`,
         #   `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`.
@@ -50,6 +50,13 @@ module OpenAI
         #   @return [Array<Symbol, OpenAI::Models::Audio::TranscriptionInclude>, nil]
         optional :include, -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Audio::TranscriptionInclude] }
 
+        # @!attribute keywords
+        #   Words or phrases to guide transcription of the input audio. Supported by
+        #   `gpt-transcribe`.
+        #
+        #   @return [Array<String>, nil]
+        optional :keywords, OpenAI::Internal::Type::ArrayOf[String]
+
         # @!attribute known_speaker_names
         #   Optional list of speaker names that correspond to the audio samples provided in
         #   `known_speaker_references[]`. Each entry should be a short identifier (for
@@ -76,6 +83,14 @@ module OpenAI
         #   @return [String, nil]
         optional :language, String
 
+        # @!attribute languages
+        #   Possible languages of the input audio, in
+        #   [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
+        #   Supported by `gpt-transcribe`.
+        #
+        #   @return [Array<String>, nil]
+        optional :languages, OpenAI::Internal::Type::ArrayOf[String]
+
         # @!attribute prompt
         #   An optional text to guide the model's style or continue a previous audio
         #   segment. The
@@ -118,24 +133,28 @@ module OpenAI
         optional :timestamp_granularities,
                  -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Audio::TranscriptionCreateParams::TimestampGranularity] }
 
-        # @!method initialize(file:, model:, chunking_strategy: nil, include: nil, known_speaker_names: nil, known_speaker_references: nil, language: nil, prompt: nil, response_format: nil, temperature: nil, timestamp_granularities: nil, request_options: {})
+        # @!method initialize(file:, model:, chunking_strategy: nil, include: nil, keywords: nil, known_speaker_names: nil, known_speaker_references: nil, language: nil, languages: nil, prompt: nil, response_format: nil, temperature: nil, timestamp_granularities: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Audio::TranscriptionCreateParams} for more details.
         #
         #   @param file [Pathname, StringIO, IO, String, OpenAI::FilePart] The audio file object (not file name) to transcribe, in one of these formats: fl
         #
-        #   @param model [String, Symbol, OpenAI::Models::AudioModel] ID of the model to use. The options are `gpt-4o-transcribe`, `gpt-4o-mini-transc
+        #   @param model [String, Symbol, OpenAI::Models::AudioModel] ID of the model to use. The options are `gpt-transcribe`, `gpt-4o-transcribe`, `
         #
         #   @param chunking_strategy [Symbol, :auto, OpenAI::Models::Audio::TranscriptionCreateParams::ChunkingStrategy::VadConfig, nil] Controls how the audio is cut into chunks. When set to `"auto"`, the server firs
         #
         #   @param include [Array<Symbol, OpenAI::Models::Audio::TranscriptionInclude>] Additional information to include in the transcription response.
         #
+        #   @param keywords [Array<String>] Words or phrases to guide transcription of the input audio. Supported by `gpt-tr
+        #
         #   @param known_speaker_names [Array<String>] Optional list of speaker names that correspond to the audio samples provided in
         #
         #   @param known_speaker_references [Array<String>] Optional list of audio samples (as [data URLs](https://developer.mozilla.org/en-
         #
         #   @param language [String] The language of the input audio. Supplying the input language in [ISO-639-1](htt
         #
+        #   @param languages [Array<String>] Possible languages of the input audio, in [ISO-639-1](https://en.wikipedia.org/w
+        #
         #   @param prompt [String] An optional text to guide the model's style or continue a previous audio segment
         #
         #   @param response_format [Symbol, OpenAI::Models::AudioResponseFormat] The format of the output, in one of these options: `json`, `text`, `srt`, `verbo
@@ -146,7 +165,7 @@ module OpenAI
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-        # ID of the model to use. The options are `gpt-4o-transcribe`,
+        # ID of the model to use. The options are `gpt-transcribe`, `gpt-4o-transcribe`,
         # `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`.
@@ -155,7 +174,7 @@ module OpenAI
 
           variant String
 
-          # ID of the model to use. The options are `gpt-4o-transcribe`, `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`.
+          # ID of the model to use. The options are `gpt-transcribe`, `gpt-4o-transcribe`, `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`.
           variant enum: -> { OpenAI::AudioModel }
 
           # @!method self.variants

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

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Audio
+      class TranscriptionLanguage < OpenAI::Internal::Type::BaseModel
+        # @!attribute code
+        #   The code of a language detected in the audio.
+        #
+        #   @return [String]
+        required :code, String
+
+        # @!method initialize(code:)
+        #   A language detected in transcribed audio.
+        #
+        #   @param code [String] The code of a language detected in the audio.
+      end
+    end
+  end
+end

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

@@ -16,6 +16,13 @@ module OpenAI
         #   @return [Symbol, :"transcript.text.done"]
         required :type, const: :"transcript.text.done"
 
+        # @!attribute languages
+        #   The languages detected in the audio. Returned by `gpt-transcribe`. An empty
+        #   array indicates that no language could be reliably detected.
+        #
+        #   @return [Array<OpenAI::Models::Audio::TranscriptionLanguage>, nil]
+        optional :languages, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Audio::TranscriptionLanguage] }
+
         # @!attribute logprobs
         #   The log probabilities of the individual tokens in the transcription. Only
         #   included if you
@@ -32,7 +39,7 @@ module OpenAI
         #   @return [OpenAI::Models::Audio::TranscriptionTextDoneEvent::Usage, nil]
         optional :usage, -> { OpenAI::Audio::TranscriptionTextDoneEvent::Usage }
 
-        # @!method initialize(text:, logprobs: nil, usage: nil, type: :"transcript.text.done")
+        # @!method initialize(text:, languages: nil, logprobs: nil, usage: nil, type: :"transcript.text.done")
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Audio::TranscriptionTextDoneEvent} for more details.
         #
@@ -43,6 +50,8 @@ module OpenAI
         #
         #   @param text [String] The text that was transcribed.
         #
+        #   @param languages [Array<OpenAI::Models::Audio::TranscriptionLanguage>] The languages detected in the audio. Returned by `gpt-transcribe`. An empty arra
+        #
         #   @param logprobs [Array<OpenAI::Models::Audio::TranscriptionTextDoneEvent::Logprob>] The log probabilities of the individual tokens in the transcription. Only includ
         #
         #   @param usage [OpenAI::Models::Audio::TranscriptionTextDoneEvent::Usage] Usage statistics for models billed by token usage.

data/lib/openai/models/audio_model.rb

@@ -6,6 +6,7 @@ module OpenAI
       extend OpenAI::Internal::Type::Enum
 
       WHISPER_1 = :"whisper-1"
+      GPT_TRANSCRIBE = :"gpt-transcribe"
       GPT_4O_TRANSCRIBE = :"gpt-4o-transcribe"
       GPT_4O_MINI_TRANSCRIBE = :"gpt-4o-mini-transcribe"
       GPT_4O_MINI_TRANSCRIBE_2025_12_15 = :"gpt-4o-mini-transcribe-2025-12-15"

data/lib/openai/models/beta/beta_response.rb

@@ -204,7 +204,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   The prompt-caching options that were applied to the response. Supported for
@@ -257,7 +257,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -382,7 +382,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Beta::BetaResponse::PromptCacheOptions] The prompt-caching options that were applied to the response. Supported for `gpt
         #
@@ -390,7 +390,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Beta::BetaResponse::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Beta::BetaResponse::ServiceTier, nil] Specifies the processing type used for serving the request.
         #
@@ -1190,7 +1190,10 @@ module OpenAI
         # @see OpenAI::Models::Beta::BetaResponse#reasoning
         class Reasoning < OpenAI::Internal::Type::BaseModel
           # @!attribute context
-          #   Controls which reasoning items are rendered back to the model on later turns.
+          #   Controls which reasoning items are rendered back to the model on later turns. If
+          #   omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+          #   model family defaults to `all_turns`; earlier models default to `current_turn`.
+          #
           #   When returned on a response, this is the effective reasoning context mode used
           #   for the response.
           #
@@ -1260,7 +1263,10 @@ module OpenAI
           #
           #   @param summary [Symbol, OpenAI::Models::Beta::BetaResponse::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-          # Controls which reasoning items are rendered back to the model on later turns.
+          # Controls which reasoning items are rendered back to the model on later turns. If
+          # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+          # model family defaults to `all_turns`; earlier models default to `current_turn`.
+          #
           # When returned on a response, this is the effective reasoning context mode used
           # for the response.
           #

data/lib/openai/models/beta/beta_response_error.rb

@@ -35,6 +35,7 @@ module OpenAI
           SERVER_ERROR = :server_error
           RATE_LIMIT_EXCEEDED = :rate_limit_exceeded
           INVALID_PROMPT = :invalid_prompt
+          DATA_RESIDENCY_MISMATCH = :data_residency_mismatch
           BIO_POLICY = :bio_policy
           VECTOR_STORE_TIMEOUT = :vector_store_timeout
           INVALID_IMAGE = :invalid_image

data/lib/openai/models/beta/beta_response_text_config.rb

@@ -25,7 +25,8 @@ module OpenAI
         # @!attribute verbosity
         #   Constrains the verbosity of the model's response. Lower values will result in
         #   more concise responses, while higher values will result in more verbose
-        #   responses. Currently supported values are `low`, `medium`, and `high`.
+        #   responses. Currently supported values are `low`, `medium`, and `high`. The
+        #   default is `medium`.
         #
         #   @return [Symbol, OpenAI::Models::Beta::BetaResponseTextConfig::Verbosity, nil]
         optional :verbosity, enum: -> { OpenAI::Beta::BetaResponseTextConfig::Verbosity }, nil?: true
@@ -46,7 +47,8 @@ module OpenAI
 
         # Constrains the verbosity of the model's response. Lower values will result in
         # more concise responses, while higher values will result in more verbose
-        # responses. Currently supported values are `low`, `medium`, and `high`.
+        # responses. Currently supported values are `low`, `medium`, and `high`. The
+        # default is `medium`.
         #
         # @see OpenAI::Models::Beta::BetaResponseTextConfig#verbosity
         module Verbosity

data/lib/openai/models/beta/beta_responses_client_event.rb

@@ -188,7 +188,7 @@ module OpenAI
           #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
           #
           #   @return [String, nil]
-          optional :prompt_cache_key, String
+          optional :prompt_cache_key, String, nil?: true
 
           # @!attribute prompt_cache_options
           #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -253,7 +253,7 @@ module OpenAI
           #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
           #
           #   @return [String, nil]
-          optional :safety_identifier, String
+          optional :safety_identifier, String, nil?: true
 
           # @!attribute service_tier
           #   Specifies the processing type used for serving the request.
@@ -443,7 +443,7 @@ module OpenAI
           #
           #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Reference to a prompt template and its variables.
           #
-          #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+          #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
           #
           #   @param prompt_cache_options [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
           #
@@ -451,7 +451,7 @@ module OpenAI
           #
           #   @param reasoning [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning, nil] **gpt-5 and o-series models only**
           #
-          #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+          #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
           #
           #   @param service_tier [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::ServiceTier, nil] Specifies the processing type used for serving the request.
           #
@@ -1102,7 +1102,10 @@ module OpenAI
           # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate#reasoning
           class Reasoning < OpenAI::Internal::Type::BaseModel
             # @!attribute context
-            #   Controls which reasoning items are rendered back to the model on later turns.
+            #   Controls which reasoning items are rendered back to the model on later turns. If
+            #   omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            #   model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             #   When returned on a response, this is the effective reasoning context mode used
             #   for the response.
             #
@@ -1181,7 +1184,10 @@ module OpenAI
             #
             #   @param summary [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-            # Controls which reasoning items are rendered back to the model on later turns.
+            # Controls which reasoning items are rendered back to the model on later turns. If
+            # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            # model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             # When returned on a response, this is the effective reasoning context mode used
             # for the response.
             #

data/lib/openai/models/beta/response_create_params.rb

@@ -163,7 +163,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -223,7 +223,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -392,7 +392,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -400,7 +400,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Beta::ResponseCreateParams::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Beta::ResponseCreateParams::ServiceTier, nil] Specifies the processing type used for serving the request.
         #
@@ -1027,7 +1027,10 @@ module OpenAI
 
         class Reasoning < OpenAI::Internal::Type::BaseModel
           # @!attribute context
-          #   Controls which reasoning items are rendered back to the model on later turns.
+          #   Controls which reasoning items are rendered back to the model on later turns. If
+          #   omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+          #   model family defaults to `all_turns`; earlier models default to `current_turn`.
+          #
           #   When returned on a response, this is the effective reasoning context mode used
           #   for the response.
           #
@@ -1097,7 +1100,10 @@ module OpenAI
           #
           #   @param summary [Symbol, OpenAI::Models::Beta::ResponseCreateParams::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-          # Controls which reasoning items are rendered back to the model on later turns.
+          # Controls which reasoning items are rendered back to the model on later turns. If
+          # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+          # model family defaults to `all_turns`; earlier models default to `current_turn`.
+          #
           # When returned on a response, this is the effective reasoning context mode used
           # for the response.
           #

data/lib/openai/models/beta/responses/input_token_count_params.rb

@@ -214,7 +214,10 @@ module OpenAI
 
           class Reasoning < OpenAI::Internal::Type::BaseModel
             # @!attribute context
-            #   Controls which reasoning items are rendered back to the model on later turns.
+            #   Controls which reasoning items are rendered back to the model on later turns. If
+            #   omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            #   model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             #   When returned on a response, this is the effective reasoning context mode used
             #   for the response.
             #
@@ -289,7 +292,10 @@ module OpenAI
             #
             #   @param summary [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-            # Controls which reasoning items are rendered back to the model on later turns.
+            # Controls which reasoning items are rendered back to the model on later turns. If
+            # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            # model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             # When returned on a response, this is the effective reasoning context mode used
             # for the response.
             #
@@ -419,7 +425,8 @@ module OpenAI
             # @!attribute verbosity
             #   Constrains the verbosity of the model's response. Lower values will result in
             #   more concise responses, while higher values will result in more verbose
-            #   responses. Currently supported values are `low`, `medium`, and `high`.
+            #   responses. Currently supported values are `low`, `medium`, and `high`. The
+            #   default is `medium`.
             #
             #   @return [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Text::Verbosity, nil]
             optional :verbosity,
@@ -442,7 +449,8 @@ module OpenAI
 
             # Constrains the verbosity of the model's response. Lower values will result in
             # more concise responses, while higher values will result in more verbose
-            # responses. Currently supported values are `low`, `medium`, and `high`.
+            # responses. Currently supported values are `low`, `medium`, and `high`. The
+            # default is `medium`.
             #
             # @see OpenAI::Models::Beta::Responses::InputTokenCountParams::Text#verbosity
             module Verbosity

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

@@ -194,7 +194,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -271,7 +271,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute seed
         #   @deprecated
@@ -401,7 +401,8 @@ module OpenAI
         # @!attribute verbosity
         #   Constrains the verbosity of the model's response. Lower values will result in
         #   more concise responses, while higher values will result in more verbose
-        #   responses. Currently supported values are `low`, `medium`, and `high`.
+        #   responses. Currently supported values are `low`, `medium`, and `high`. The
+        #   default is `medium`.
         #
         #   @return [Symbol, OpenAI::Models::Chat::CompletionCreateParams::Verbosity, nil]
         optional :verbosity, enum: -> { OpenAI::Chat::CompletionCreateParams::Verbosity }, nil?: true
@@ -452,7 +453,7 @@ module OpenAI
         #
         #   @param presence_penalty [Float, nil] Number between -2.0 and 2.0. Positive values penalize new tokens based on
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Chat::CompletionCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -462,7 +463,7 @@ module OpenAI
         #
         #   @param response_format [OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONSchema, OpenAI::StructuredOutput::JsonSchemaConverter, OpenAI::Models::ResponseFormatJSONObject] An object specifying the format that the model must output.
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param seed [Integer, nil] This feature is in Beta.
         #
@@ -894,7 +895,8 @@ module OpenAI
 
         # Constrains the verbosity of the model's response. Lower values will result in
         # more concise responses, while higher values will result in more verbose
-        # responses. Currently supported values are `low`, `medium`, and `high`.
+        # responses. Currently supported values are `low`, `medium`, and `high`. The
+        # default is `medium`.
         module Verbosity
           extend OpenAI::Internal::Type::Enum
 

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

@@ -12,6 +12,13 @@ module OpenAI
         #   @return [Symbol, OpenAI::Models::Realtime::AudioTranscription::Delay, nil]
         optional :delay, enum: -> { OpenAI::Realtime::AudioTranscription::Delay }
 
+        # @!attribute keywords
+        #   Words or phrases to guide transcription of the input audio. Supported by
+        #   `gpt-transcribe` and `gpt-live-transcribe`.
+        #
+        #   @return [Array<String>, nil]
+        optional :keywords, OpenAI::Internal::Type::ArrayOf[String]
+
         # @!attribute language
         #   The language of the input audio. Supplying the input language in
         #   [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`)
@@ -20,11 +27,20 @@ module OpenAI
         #   @return [String, nil]
         optional :language, String
 
+        # @!attribute languages
+        #   Possible languages of the input audio, in
+        #   [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
+        #   Supported by `gpt-transcribe` and `gpt-live-transcribe`.
+        #
+        #   @return [Array<String>, nil]
+        optional :languages, OpenAI::Internal::Type::ArrayOf[String]
+
         # @!attribute model
         #   The model to use for transcription. Current options are `whisper-1`,
-        #   `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`,
-        #   `gpt-4o-transcribe`, `gpt-4o-transcribe-diarize`, and `gpt-realtime-whisper`.
-        #   Use `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
+        #   `gpt-transcribe`, `gpt-live-transcribe`, `gpt-4o-mini-transcribe`,
+        #   `gpt-4o-mini-transcribe-2025-12-15`, `gpt-4o-transcribe`,
+        #   `gpt-4o-transcribe-diarize`, and `gpt-realtime-whisper`. Use
+        #   `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
         #
         #   @return [String, Symbol, OpenAI::Models::Realtime::AudioTranscription::Model, nil]
         optional :model, union: -> { OpenAI::Realtime::AudioTranscription::Model }
@@ -40,15 +56,19 @@ module OpenAI
         #   @return [String, nil]
         optional :prompt, String
 
-        # @!method initialize(delay: nil, language: nil, model: nil, prompt: nil)
+        # @!method initialize(delay: nil, keywords: nil, language: nil, languages: nil, model: nil, prompt: nil)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Realtime::AudioTranscription} for more details.
         #
         #   @param delay [Symbol, OpenAI::Models::Realtime::AudioTranscription::Delay] Controls how long the model waits before emitting transcription text.
         #
+        #   @param keywords [Array<String>] Words or phrases to guide transcription of the input audio. Supported by `gpt-tr
+        #
         #   @param language [String] The language of the input audio. Supplying the input language in
         #
-        #   @param model [String, Symbol, OpenAI::Models::Realtime::AudioTranscription::Model] The model to use for transcription. Current options are `whisper-1`, `gpt-4o-min
+        #   @param languages [Array<String>] Possible languages of the input audio, in [ISO-639-1](https://en.wikipedia.org/w
+        #
+        #   @param model [String, Symbol, OpenAI::Models::Realtime::AudioTranscription::Model] The model to use for transcription. Current options are `whisper-1`, `gpt-transc
         #
         #   @param prompt [String] An optional text to guide the model's style or continue a previous audio
 
@@ -71,9 +91,10 @@ module OpenAI
         end
 
         # The model to use for transcription. Current options are `whisper-1`,
-        # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`,
-        # `gpt-4o-transcribe`, `gpt-4o-transcribe-diarize`, and `gpt-realtime-whisper`.
-        # Use `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
+        # `gpt-transcribe`, `gpt-live-transcribe`, `gpt-4o-mini-transcribe`,
+        # `gpt-4o-mini-transcribe-2025-12-15`, `gpt-4o-transcribe`,
+        # `gpt-4o-transcribe-diarize`, and `gpt-realtime-whisper`. Use
+        # `gpt-4o-transcribe-diarize` when you need diarization with speaker labels.
         #
         # @see OpenAI::Models::Realtime::AudioTranscription#model
         module Model
@@ -83,6 +104,10 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Realtime::AudioTranscription::Model::WHISPER_1 }
 
+          variant const: -> { OpenAI::Models::Realtime::AudioTranscription::Model::GPT_TRANSCRIBE }
+
+          variant const: -> { OpenAI::Models::Realtime::AudioTranscription::Model::GPT_LIVE_TRANSCRIBE }
+
           variant const: -> { OpenAI::Models::Realtime::AudioTranscription::Model::GPT_4O_MINI_TRANSCRIBE }
 
           variant const: -> { OpenAI::Models::Realtime::AudioTranscription::Model::GPT_4O_MINI_TRANSCRIBE_2025_12_15 }
@@ -103,6 +128,8 @@ module OpenAI
           # @!group
 
           WHISPER_1 = :"whisper-1"
+          GPT_TRANSCRIBE = :"gpt-transcribe"
+          GPT_LIVE_TRANSCRIBE = :"gpt-live-transcribe"
           GPT_4O_MINI_TRANSCRIBE = :"gpt-4o-mini-transcribe"
           GPT_4O_MINI_TRANSCRIBE_2025_12_15 = :"gpt-4o-mini-transcribe-2025-12-15"
           GPT_4O_TRANSCRIBE = :"gpt-4o-transcribe"

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

@@ -42,6 +42,13 @@ module OpenAI
         required :usage,
                  union: -> { OpenAI::Realtime::ConversationItemInputAudioTranscriptionCompletedEvent::Usage }
 
+        # @!attribute languages
+        #   The languages detected in the audio. Returned by `gpt-transcribe`. An empty
+        #   array indicates that no language could be reliably detected.
+        #
+        #   @return [Array<OpenAI::Models::Audio::TranscriptionLanguage>, nil]
+        optional :languages, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Audio::TranscriptionLanguage] }
+
         # @!attribute logprobs
         #   The log probabilities of the transcription.
         #
@@ -50,7 +57,7 @@ module OpenAI
                  -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Realtime::LogProbProperties] },
                  nil?: true
 
-        # @!method initialize(content_index:, event_id:, item_id:, transcript:, usage:, logprobs: nil, type: :"conversation.item.input_audio_transcription.completed")
+        # @!method initialize(content_index:, event_id:, item_id:, transcript:, usage:, languages: nil, logprobs: nil, type: :"conversation.item.input_audio_transcription.completed")
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Realtime::ConversationItemInputAudioTranscriptionCompletedEvent}
         #   for more details.
@@ -76,6 +83,8 @@ module OpenAI
         #
         #   @param usage [OpenAI::Models::Realtime::ConversationItemInputAudioTranscriptionCompletedEvent::Usage::TranscriptTextUsageTokens, OpenAI::Models::Realtime::ConversationItemInputAudioTranscriptionCompletedEvent::Usage::TranscriptTextUsageDuration] Usage statistics for the transcription, this is billed according to the ASR mode
         #
+        #   @param languages [Array<OpenAI::Models::Audio::TranscriptionLanguage>] The languages detected in the audio. Returned by `gpt-transcribe`. An empty arra
+        #
         #   @param logprobs [Array<OpenAI::Models::Realtime::LogProbProperties>, nil] The log probabilities of the transcription.
         #
         #   @param type [Symbol, :"conversation.item.input_audio_transcription.completed"] The event type, must be

data/lib/openai/models/reasoning.rb

@@ -4,7 +4,10 @@ module OpenAI
   module Models
     class Reasoning < OpenAI::Internal::Type::BaseModel
       # @!attribute context
-      #   Controls which reasoning items are rendered back to the model on later turns.
+      #   Controls which reasoning items are rendered back to the model on later turns. If
+      #   omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+      #   model family defaults to `all_turns`; earlier models default to `current_turn`.
+      #
       #   When returned on a response, this is the effective reasoning context mode used
       #   for the response.
       #
@@ -72,7 +75,10 @@ module OpenAI
       #
       #   @param summary [Symbol, OpenAI::Models::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-      # Controls which reasoning items are rendered back to the model on later turns.
+      # Controls which reasoning items are rendered back to the model on later turns. If
+      # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+      # model family defaults to `all_turns`; earlier models default to `current_turn`.
+      #
       # When returned on a response, this is the effective reasoning context mode used
       # for the response.
       #