openai 0.70.0 → 0.72.0

data/rbi/openai/models/beta/beta_response.rbi

@@ -204,10 +204,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.
@@ -271,10 +268,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::Beta::BetaResponse::Moderation::OrHash),
             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::BetaResponse::PromptCacheOptions::OrHash,
             prompt_cache_retention:
@@ -460,7 +454,7 @@ module OpenAI
                 OpenAI::Beta::BetaResponse::PromptCacheRetention::OrSymbol
               ),
             reasoning: T.nilable(OpenAI::Beta::BetaResponse::Reasoning::OrHash),
-            safety_identifier: String,
+            safety_identifier: T.nilable(String),
             service_tier:
               T.nilable(OpenAI::Beta::BetaResponse::ServiceTier::OrSymbol),
             status: OpenAI::Beta::BetaResponseStatus::OrSymbol,
@@ -691,7 +685,7 @@ module OpenAI
               moderation: T.nilable(OpenAI::Beta::BetaResponse::Moderation),
               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::BetaResponse::PromptCacheOptions,
               prompt_cache_retention:
@@ -699,7 +693,7 @@ module OpenAI
                   OpenAI::Beta::BetaResponse::PromptCacheRetention::TaggedSymbol
                 ),
               reasoning: T.nilable(OpenAI::Beta::BetaResponse::Reasoning),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               service_tier:
                 T.nilable(
                   OpenAI::Beta::BetaResponse::ServiceTier::TaggedSymbol
@@ -2014,7 +2008,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
@@ -2121,7 +2118,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,
@@ -2178,7 +2178,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/beta_response_error.rbi

@@ -70,6 +70,11 @@ module OpenAI
               :invalid_prompt,
               OpenAI::Beta::BetaResponseError::Code::TaggedSymbol
             )
+          DATA_RESIDENCY_MISMATCH =
+            T.let(
+              :data_residency_mismatch,
+              OpenAI::Beta::BetaResponseError::Code::TaggedSymbol
+            )
           BIO_POLICY =
             T.let(
               :bio_policy,

data/rbi/openai/models/beta/beta_response_input_item.rbi

@@ -1525,7 +1525,13 @@ module OpenAI
             sig do
               returns(
                 T.nilable(
-                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::Variants
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation,
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation,
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation
+                    )
+                  ]
                 )
               )
             end
@@ -1534,7 +1540,13 @@ module OpenAI
             sig do
               params(
                 annotations:
-                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::Variants
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation::OrHash,
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation::OrHash,
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation::OrHash
+                    )
+                  ]
               ).void
             end
             attr_writer :annotations
@@ -1543,7 +1555,13 @@ module OpenAI
               params(
                 text: String,
                 annotations:
-                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::Variants,
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation::OrHash,
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation::OrHash,
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation::OrHash
+                    )
+                  ],
                 type: Symbol
               ).returns(T.attached_class)
             end
@@ -1563,37 +1581,36 @@ module OpenAI
                   text: String,
                   type: Symbol,
                   annotations:
-                    OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::Variants
+                    T::Array[
+                      T.any(
+                        OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation,
+                        OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation,
+                        OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation
+                      )
+                    ]
                 }
               )
             end
             def to_hash
             end
 
-            # Citations associated with the text content.
-            module Annotations
+            module Annotation
               extend OpenAI::Internal::Type::Union
 
               Variants =
                 T.type_alias do
                   T.any(
-                    T::Array[
-                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0
-                    ],
-                    T::Array[
-                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1
-                    ],
-                    T::Array[
-                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2
-                    ]
+                    OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation,
+                    OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation,
+                    OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation
                   )
                 end
 
-              class UnionMember0 < OpenAI::Internal::Type::BaseModel
+              class FileCitation < OpenAI::Internal::Type::BaseModel
                 OrHash =
                   T.type_alias do
                     T.any(
-                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0,
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation,
                       OpenAI::Internal::AnyHash
                     )
                   end
@@ -1648,11 +1665,11 @@ module OpenAI
                 end
               end
 
-              class UnionMember1 < OpenAI::Internal::Type::BaseModel
+              class URLCitation < OpenAI::Internal::Type::BaseModel
                 OrHash =
                   T.type_alias do
                     T.any(
-                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1,
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation,
                       OpenAI::Internal::AnyHash
                     )
                   end
@@ -1715,11 +1732,11 @@ module OpenAI
                 end
               end
 
-              class UnionMember2 < OpenAI::Internal::Type::BaseModel
+              class ContainerFileCitation < OpenAI::Internal::Type::BaseModel
                 OrHash =
                   T.type_alias do
                     T.any(
-                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2,
+                      OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation,
                       OpenAI::Internal::AnyHash
                     )
                   end
@@ -1793,36 +1810,12 @@ module OpenAI
               sig do
                 override.returns(
                   T::Array[
-                    OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::Variants
+                    OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::Variants
                   ]
                 )
               end
               def self.variants
               end
-
-              UnionMember0Array =
-                T.let(
-                  OpenAI::Internal::Type::ArrayOf[
-                    OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0
-                  ],
-                  OpenAI::Internal::Type::Converter
-                )
-
-              UnionMember1Array =
-                T.let(
-                  OpenAI::Internal::Type::ArrayOf[
-                    OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1
-                  ],
-                  OpenAI::Internal::Type::Converter
-                )
-
-              UnionMember2Array =
-                T.let(
-                  OpenAI::Internal::Type::ArrayOf[
-                    OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2
-                  ],
-                  OpenAI::Internal::Type::Converter
-                )
             end
           end
 

data/rbi/openai/models/beta/beta_response_text_config.rbi

@@ -54,7 +54,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::Beta::BetaResponseTextConfig::Verbosity::OrSymbol)
@@ -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
 

data/rbi/openai/models/beta/beta_responses_client_event.rbi

@@ -238,10 +238,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
@@ -325,10 +322,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.
           #
@@ -612,7 +606,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::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::OrHash,
               prompt_cache_retention:
@@ -623,7 +617,7 @@ module OpenAI
                 T.nilable(
                   OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::OrHash
                 ),
-              safety_identifier: String,
+              safety_identifier: T.nilable(String),
               service_tier:
                 T.nilable(
                   OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ServiceTier::OrSymbol
@@ -938,7 +932,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::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions,
                 prompt_cache_retention:
@@ -949,7 +943,7 @@ module OpenAI
                   T.nilable(
                     OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning
                   ),
-                safety_identifier: String,
+                safety_identifier: T.nilable(String),
                 service_tier:
                   T.nilable(
                     OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ServiceTier::OrSymbol
@@ -2198,7 +2192,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
@@ -2310,7 +2307,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,
@@ -2371,7 +2371,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/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