openai 0.71.0 → 0.73.0

data/rbi/openai/models/beta/response_create_params.rbi

@@ -195,10 +195,7 @@ module OpenAI
         # hit rates. Replaces the `user` field.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         sig { returns(T.nilable(String)) }
-        attr_reader :prompt_cache_key
-
-        sig { params(prompt_cache_key: String).void }
-        attr_writer :prompt_cache_key
+        attr_accessor :prompt_cache_key
 
         # Options for prompt caching. Supported for `gpt-5.6` and later models. By
         # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
@@ -274,10 +271,7 @@ module OpenAI
         # identifying information.
         # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
-        attr_reader :safety_identifier
-
-        sig { params(safety_identifier: String).void }
-        attr_writer :safety_identifier
+        attr_accessor :safety_identifier
 
         # Specifies the processing type used for serving the request.
         #
@@ -546,7 +540,7 @@ module OpenAI
             parallel_tool_calls: T.nilable(T::Boolean),
             previous_response_id: T.nilable(String),
             prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt::OrHash),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -555,7 +549,7 @@ module OpenAI
               ),
             reasoning:
               T.nilable(OpenAI::Beta::ResponseCreateParams::Reasoning::OrHash),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             service_tier:
               T.nilable(
                 OpenAI::Beta::ResponseCreateParams::ServiceTier::OrSymbol
@@ -857,7 +851,7 @@ module OpenAI
               parallel_tool_calls: T.nilable(T::Boolean),
               previous_response_id: T.nilable(String),
               prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt),
-              prompt_cache_key: String,
+              prompt_cache_key: T.nilable(String),
               prompt_cache_options:
                 OpenAI::Beta::ResponseCreateParams::PromptCacheOptions,
               prompt_cache_retention:
@@ -866,7 +860,7 @@ module OpenAI
                 ),
               reasoning:
                 T.nilable(OpenAI::Beta::ResponseCreateParams::Reasoning),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               service_tier:
                 T.nilable(
                   OpenAI::Beta::ResponseCreateParams::ServiceTier::OrSymbol
@@ -2099,7 +2093,10 @@ module OpenAI
               )
             end
 
-          # 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.
           sig do
@@ -2211,7 +2208,10 @@ module OpenAI
             ).returns(T.attached_class)
           end
           def self.new(
-            # 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.
             context: nil,
@@ -2272,7 +2272,10 @@ module OpenAI
           def to_hash
           end
 
-          # 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.
           module Context

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

@@ -544,7 +544,10 @@ module OpenAI
                 )
               end
 
-            # 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.
             sig do
@@ -654,7 +657,10 @@ module OpenAI
               ).returns(T.attached_class)
             end
             def self.new(
-              # 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.
               context: nil,
@@ -715,7 +721,10 @@ module OpenAI
             def to_hash
             end
 
-            # 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.
             module Context
@@ -1006,7 +1015,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`.
             sig do
               returns(
                 T.nilable(
@@ -1052,7 +1062,8 @@ module OpenAI
               format_: nil,
               # 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`.
               verbosity: nil
             )
             end
@@ -1078,7 +1089,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/rbi/openai/models/chat/completion_create_params.rbi

@@ -236,10 +236,7 @@ module OpenAI
         # hit rates. Replaces the `user` field.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         sig { returns(T.nilable(String)) }
-        attr_reader :prompt_cache_key
-
-        sig { params(prompt_cache_key: String).void }
-        attr_writer :prompt_cache_key
+        attr_accessor :prompt_cache_key
 
         # Options for prompt caching. Supported for `gpt-5.6` and later models. By
         # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
@@ -344,10 +341,7 @@ module OpenAI
         # identifying information.
         # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
-        attr_reader :safety_identifier
-
-        sig { params(safety_identifier: String).void }
-        attr_writer :safety_identifier
+        attr_accessor :safety_identifier
 
         # This feature is in Beta. If specified, our system will make a best effort to
         # sample deterministically, such that repeated requests with the same `seed` and
@@ -515,7 +509,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`.
         sig do
           returns(
             T.nilable(OpenAI::Chat::CompletionCreateParams::Verbosity::OrSymbol)
@@ -584,7 +579,7 @@ module OpenAI
             prediction:
               T.nilable(OpenAI::Chat::ChatCompletionPredictionContent::OrHash),
             presence_penalty: T.nilable(Float),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Chat::CompletionCreateParams::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -599,7 +594,7 @@ module OpenAI
                 OpenAI::StructuredOutput::JsonSchemaConverter,
                 OpenAI::ResponseFormatJSONObject::OrHash
               ),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             seed: T.nilable(Integer),
             service_tier:
               T.nilable(
@@ -870,7 +865,8 @@ module OpenAI
           user: nil,
           # 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`.
           verbosity: nil,
           # This tool searches the web for relevant results to use in a response. Learn more
           # about the
@@ -922,7 +918,7 @@ module OpenAI
               prediction:
                 T.nilable(OpenAI::Chat::ChatCompletionPredictionContent),
               presence_penalty: T.nilable(Float),
-              prompt_cache_key: String,
+              prompt_cache_key: T.nilable(String),
               prompt_cache_options:
                 OpenAI::Chat::CompletionCreateParams::PromptCacheOptions,
               prompt_cache_retention:
@@ -936,7 +932,7 @@ module OpenAI
                   OpenAI::ResponseFormatJSONSchema,
                   OpenAI::ResponseFormatJSONObject
                 ),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               seed: T.nilable(Integer),
               service_tier:
                 T.nilable(
@@ -1819,7 +1815,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/rbi/openai/models/realtime/audio_transcription.rbi

@@ -29,6 +29,14 @@ module OpenAI
         end
         attr_writer :delay
 
+        # Words or phrases to guide transcription of the input audio. Supported by
+        # `gpt-transcribe` and `gpt-live-transcribe`.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :keywords
+
+        sig { params(keywords: T::Array[String]).void }
+        attr_writer :keywords
+
         # 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`)
         # format will improve accuracy and latency.
@@ -38,10 +46,20 @@ module OpenAI
         sig { params(language: String).void }
         attr_writer :language
 
+        # 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`.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :languages
+
+        sig { params(languages: T::Array[String]).void }
+        attr_writer :languages
+
         # 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.
         sig do
           returns(
             T.nilable(
@@ -80,7 +98,9 @@ module OpenAI
         sig do
           params(
             delay: OpenAI::Realtime::AudioTranscription::Delay::OrSymbol,
+            keywords: T::Array[String],
             language: String,
+            languages: T::Array[String],
             model:
               T.any(
                 String,
@@ -94,14 +114,22 @@ module OpenAI
           # values can improve transcription accuracy at the cost of latency. Only supported
           # with `gpt-realtime-whisper` in GA Realtime sessions.
           delay: nil,
+          # Words or phrases to guide transcription of the input audio. Supported by
+          # `gpt-transcribe` and `gpt-live-transcribe`.
+          keywords: nil,
           # 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`)
           # format will improve accuracy and latency.
           language: nil,
+          # 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`.
+          languages: nil,
           # 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.
           model: nil,
           # An optional text to guide the model's style or continue a previous audio
           # segment. For `whisper-1`, the
@@ -117,7 +145,9 @@ module OpenAI
           override.returns(
             {
               delay: OpenAI::Realtime::AudioTranscription::Delay::OrSymbol,
+              keywords: T::Array[String],
               language: String,
+              languages: T::Array[String],
               model:
                 T.any(
                   String,
@@ -180,9 +210,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.
         module Model
           extend OpenAI::Internal::Type::Union
 
@@ -213,6 +244,16 @@ module OpenAI
               :"whisper-1",
               OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
             )
+          GPT_TRANSCRIBE =
+            T.let(
+              :"gpt-transcribe",
+              OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
+            )
+          GPT_LIVE_TRANSCRIBE =
+            T.let(
+              :"gpt-live-transcribe",
+              OpenAI::Realtime::AudioTranscription::Model::TaggedSymbol
+            )
           GPT_4O_MINI_TRANSCRIBE =
             T.let(
               :"gpt-4o-mini-transcribe",

data/rbi/openai/models/realtime/conversation_item_input_audio_transcription_completed_event.rbi

@@ -44,6 +44,20 @@ module OpenAI
         end
         attr_accessor :usage
 
+        # The languages detected in the audio. Returned by `gpt-transcribe`. An empty
+        # array indicates that no language could be reliably detected.
+        sig do
+          returns(T.nilable(T::Array[OpenAI::Audio::TranscriptionLanguage]))
+        end
+        attr_reader :languages
+
+        sig do
+          params(
+            languages: T::Array[OpenAI::Audio::TranscriptionLanguage::OrHash]
+          ).void
+        end
+        attr_writer :languages
+
         # The log probabilities of the transcription.
         sig do
           returns(T.nilable(T::Array[OpenAI::Realtime::LogProbProperties]))
@@ -71,6 +85,7 @@ module OpenAI
                 OpenAI::Realtime::ConversationItemInputAudioTranscriptionCompletedEvent::Usage::TranscriptTextUsageTokens::OrHash,
                 OpenAI::Realtime::ConversationItemInputAudioTranscriptionCompletedEvent::Usage::TranscriptTextUsageDuration::OrHash
               ),
+            languages: T::Array[OpenAI::Audio::TranscriptionLanguage::OrHash],
             logprobs:
               T.nilable(T::Array[OpenAI::Realtime::LogProbProperties::OrHash]),
             type: Symbol
@@ -88,6 +103,9 @@ module OpenAI
           # Usage statistics for the transcription, this is billed according to the ASR
           # model's pricing rather than the realtime model's pricing.
           usage:,
+          # The languages detected in the audio. Returned by `gpt-transcribe`. An empty
+          # array indicates that no language could be reliably detected.
+          languages: nil,
           # The log probabilities of the transcription.
           logprobs: nil,
           # The event type, must be `conversation.item.input_audio_transcription.completed`.
@@ -108,6 +126,7 @@ module OpenAI
                   OpenAI::Realtime::ConversationItemInputAudioTranscriptionCompletedEvent::Usage::TranscriptTextUsageTokens,
                   OpenAI::Realtime::ConversationItemInputAudioTranscriptionCompletedEvent::Usage::TranscriptTextUsageDuration
                 ),
+              languages: T::Array[OpenAI::Audio::TranscriptionLanguage],
               logprobs: T.nilable(T::Array[OpenAI::Realtime::LogProbProperties])
             }
           )

data/rbi/openai/models/reasoning.rbi

@@ -6,7 +6,10 @@ module OpenAI
       OrHash =
         T.type_alias { T.any(OpenAI::Reasoning, OpenAI::Internal::AnyHash) }
 
-      # 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.
       sig { returns(T.nilable(OpenAI::Reasoning::Context::OrSymbol)) }
@@ -66,7 +69,10 @@ module OpenAI
         ).returns(T.attached_class)
       end
       def self.new(
-        # 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.
         context: nil,
@@ -112,7 +118,10 @@ module OpenAI
       def to_hash
       end
 
-      # 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.
       module Context

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

@@ -523,7 +523,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`.
           sig do
             returns(
               T.nilable(
@@ -569,7 +570,8 @@ module OpenAI
             format_: nil,
             # 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`.
             verbosity: nil
           )
           end
@@ -595,7 +597,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/rbi/openai/models/responses/response.rbi

@@ -206,10 +206,7 @@ module OpenAI
         # hit rates. Replaces the `user` field.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         sig { returns(T.nilable(String)) }
-        attr_reader :prompt_cache_key
-
-        sig { params(prompt_cache_key: String).void }
-        attr_writer :prompt_cache_key
+        attr_accessor :prompt_cache_key
 
         # The prompt-caching options that were applied to the response. Supported for
         # `gpt-5.6` and later models.
@@ -269,10 +266,7 @@ module OpenAI
         # identifying information.
         # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
-        attr_reader :safety_identifier
-
-        sig { params(safety_identifier: String).void }
-        attr_writer :safety_identifier
+        attr_accessor :safety_identifier
 
         # Specifies the processing type used for serving the request.
         #
@@ -452,7 +446,7 @@ module OpenAI
               T.nilable(OpenAI::Responses::Response::Moderation::OrHash),
             previous_response_id: T.nilable(String),
             prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Responses::Response::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -460,7 +454,7 @@ module OpenAI
                 OpenAI::Responses::Response::PromptCacheRetention::OrSymbol
               ),
             reasoning: T.nilable(OpenAI::Reasoning::OrHash),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             service_tier:
               T.nilable(OpenAI::Responses::Response::ServiceTier::OrSymbol),
             status: OpenAI::Responses::ResponseStatus::OrSymbol,
@@ -692,7 +686,7 @@ module OpenAI
               moderation: T.nilable(OpenAI::Responses::Response::Moderation),
               previous_response_id: T.nilable(String),
               prompt: T.nilable(OpenAI::Responses::ResponsePrompt),
-              prompt_cache_key: String,
+              prompt_cache_key: T.nilable(String),
               prompt_cache_options:
                 OpenAI::Responses::Response::PromptCacheOptions,
               prompt_cache_retention:
@@ -700,7 +694,7 @@ module OpenAI
                   OpenAI::Responses::Response::PromptCacheRetention::TaggedSymbol
                 ),
               reasoning: T.nilable(OpenAI::Reasoning),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               service_tier:
                 T.nilable(
                   OpenAI::Responses::Response::ServiceTier::TaggedSymbol

data/rbi/openai/models/responses/response_create_params.rbi

@@ -198,10 +198,7 @@ module OpenAI
         # hit rates. Replaces the `user` field.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         sig { returns(T.nilable(String)) }
-        attr_reader :prompt_cache_key
-
-        sig { params(prompt_cache_key: String).void }
-        attr_writer :prompt_cache_key
+        attr_accessor :prompt_cache_key
 
         # Options for prompt caching. Supported for `gpt-5.6` and later models. By
         # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
@@ -272,10 +269,7 @@ module OpenAI
         # identifying information.
         # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
-        attr_reader :safety_identifier
-
-        sig { params(safety_identifier: String).void }
-        attr_writer :safety_identifier
+        attr_accessor :safety_identifier
 
         # Specifies the processing type used for serving the request.
         #
@@ -543,7 +537,7 @@ module OpenAI
             parallel_tool_calls: T.nilable(T::Boolean),
             previous_response_id: T.nilable(String),
             prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
-            prompt_cache_key: String,
+            prompt_cache_key: T.nilable(String),
             prompt_cache_options:
               OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -551,7 +545,7 @@ module OpenAI
                 OpenAI::Responses::ResponseCreateParams::PromptCacheRetention::OrSymbol
               ),
             reasoning: T.nilable(OpenAI::Reasoning::OrHash),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             service_tier:
               T.nilable(
                 OpenAI::Responses::ResponseCreateParams::ServiceTier::OrSymbol
@@ -848,7 +842,7 @@ module OpenAI
               parallel_tool_calls: T.nilable(T::Boolean),
               previous_response_id: T.nilable(String),
               prompt: T.nilable(OpenAI::Responses::ResponsePrompt),
-              prompt_cache_key: String,
+              prompt_cache_key: T.nilable(String),
               prompt_cache_options:
                 OpenAI::Responses::ResponseCreateParams::PromptCacheOptions,
               prompt_cache_retention:
@@ -856,7 +850,7 @@ module OpenAI
                   OpenAI::Responses::ResponseCreateParams::PromptCacheRetention::OrSymbol
                 ),
               reasoning: T.nilable(OpenAI::Reasoning),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               service_tier:
                 T.nilable(
                   OpenAI::Responses::ResponseCreateParams::ServiceTier::OrSymbol

data/rbi/openai/models/responses/response_error.rbi

@@ -68,6 +68,11 @@ module OpenAI
               :invalid_prompt,
               OpenAI::Responses::ResponseError::Code::TaggedSymbol
             )
+          DATA_RESIDENCY_MISMATCH =
+            T.let(
+              :data_residency_mismatch,
+              OpenAI::Responses::ResponseError::Code::TaggedSymbol
+            )
           BIO_POLICY =
             T.let(
               :bio_policy,

data/rbi/openai/models/responses/response_text_config.rbi

@@ -52,7 +52,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`.
         sig do
           returns(
             T.nilable(
@@ -98,7 +99,8 @@ module OpenAI
           format_: nil,
           # 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`.
           verbosity: nil
         )
         end
@@ -124,7 +126,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