openai 0.113.0 → 0.115.0

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

@@ -17,9 +17,9 @@ module OpenAI
         required :type, const: :input_text
 
         # @!attribute prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         #
         #   @return [OpenAI::Models::Beta::BetaResponseInputTextContent::PromptCacheBreakpoint, nil]
         optional(
@@ -35,9 +35,9 @@ module OpenAI
         #     The text input to the model.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Beta::BetaResponseInputTextContent::PromptCacheBreakpoint, nil]
-        #     Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #     from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #     token block.
+        #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #     not rounded to a token block.
         #
         #   @param type [Symbol, :input_text]
         #     The type of the input item. Always `input_text`.
@@ -57,9 +57,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputTextContent::PromptCacheBreakpoint::Ttl }
 
           # @!method initialize(ttl: nil, mode: :explicit)
-          #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-          #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-          #   token block.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @param ttl [Symbol, OpenAI::Models::Beta::BetaResponseInputTextContent::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -46,8 +46,8 @@ module OpenAI
 
         variant :additional_tools, -> { OpenAI::Beta::BetaResponseItem::AdditionalTools }
 
-        # A configuration update that applies to subsequent responses until it is
-        # replaced by another configuration update.
+        # A configuration update for subsequent responses. Each setting stays in effect
+        # until a later update replaces that setting.
         variant :configuration_update, -> { OpenAI::Beta::BetaResponseConfigurationUpdateItem }
 
         # A description of the chain of thought used by a reasoning model while generating
@@ -298,9 +298,9 @@ module OpenAI
               required :type, const: :computer_screenshot
 
               # @!attribute prompt_cache_breakpoint
-              #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-              #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-              #   token block.
+              #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+              #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+              #   not rounded to a token block.
               #
               #   @return [OpenAI::Models::Beta::BetaResponseItem::AgentMessage::Content::ComputerScreenshot::PromptCacheBreakpoint, nil]
               optional(
@@ -322,9 +322,9 @@ module OpenAI
               #     The URL of the screenshot image.
               #
               #   @param prompt_cache_breakpoint [OpenAI::Models::Beta::BetaResponseItem::AgentMessage::Content::ComputerScreenshot::PromptCacheBreakpoint]
-              #     Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-              #     from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-              #     token block.
+              #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+              #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+              #     not rounded to a token block.
               #
               #   @param type [Symbol, :computer_screenshot]
               #     Specifies the event type. For a computer screenshot, this property is always set
@@ -366,9 +366,9 @@ module OpenAI
                 )
 
                 # @!method initialize(ttl: nil, mode: :explicit)
-                #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-                #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-                #   token block.
+                #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+                #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+                #   not rounded to a token block.
                 #
                 #   @param ttl [Symbol, OpenAI::Models::Beta::BetaResponseItem::AgentMessage::Content::ComputerScreenshot::PromptCacheBreakpoint::Ttl]
                 #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -295,9 +295,9 @@ module OpenAI
               required :type, const: :computer_screenshot
 
               # @!attribute prompt_cache_breakpoint
-              #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-              #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-              #   token block.
+              #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+              #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+              #   not rounded to a token block.
               #
               #   @return [OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::PromptCacheBreakpoint, nil]
               optional(
@@ -321,9 +321,9 @@ module OpenAI
               #     The URL of the screenshot image.
               #
               #   @param prompt_cache_breakpoint [OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::PromptCacheBreakpoint]
-              #     Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-              #     from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-              #     token block.
+              #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+              #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+              #     not rounded to a token block.
               #
               #   @param type [Symbol, :computer_screenshot]
               #     Specifies the event type. For a computer screenshot, this property is always set
@@ -365,9 +365,9 @@ module OpenAI
                 )
 
                 # @!method initialize(ttl: nil, mode: :explicit)
-                #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-                #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-                #   token block.
+                #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+                #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+                #   not rounded to a token block.
                 #
                 #   @param ttl [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::PromptCacheBreakpoint::Ttl]
                 #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -758,8 +758,8 @@ module OpenAI
             # @!attribute input_fidelity
             #   Control how much effort the model will exert to match the style and features,
             #   especially facial features, of input images. Supports `high` and `low` on
-            #   `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            #   `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            #   this parameter. Defaults to `low` on supported models.
             #
             #   @return [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity, nil]
             optional(
@@ -878,8 +878,8 @@ module OpenAI
             #   @param input_fidelity [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity, nil]
             #     Control how much effort the model will exert to match the style and features,
             #     especially facial features, of input images. Supports `high` and `low` on
-            #     `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            #     `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            #     `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            #     this parameter. Defaults to `low` on supported models.
             #
             #   @param input_image_mask [OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputImageMask]
             #     Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -968,8 +968,8 @@ module OpenAI
 
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. Supports `high` and `low` on
-            # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            # this parameter. Defaults to `low` on supported models.
             #
             # @see OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration#input_fidelity
             module InputFidelity

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

@@ -99,6 +99,14 @@ module OpenAI
             nil?: true
           )
 
+          # @!attribute generate
+          #   Whether to generate output for this response. Defaults to true when omitted. Set
+          #   to false to prepare request state without model output; the response ID can be
+          #   used as previous_response_id on a later turn.
+          #
+          #   @return [Boolean, nil]
+          optional :generate, OpenAI::Internal::Type::Boolean
+
           # @!attribute include
           #   Specify additional output data to include in the model response. Currently
           #   supported values are:
@@ -482,7 +490,7 @@ module OpenAI
           #   @return [String, nil]
           optional :user, String
 
-          # @!method initialize(access_programs: nil, background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
+          # @!method initialize(access_programs: nil, background: nil, context_management: nil, conversation: nil, generate: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
           #   Client event for creating a response over a persistent WebSocket connection.
           #   This payload uses the same top-level fields as `POST /v1/responses`, plus
           #   WebSocket-only envelope metadata.
@@ -509,6 +517,11 @@ module OpenAI
           #     items from this response are automatically added to this conversation after this
           #     response completes.
           #
+          #   @param generate [Boolean]
+          #     Whether to generate output for this response. Defaults to true when omitted. Set
+          #     to false to prepare request state without model output; the response ID can be
+          #     used as previous_response_id on a later turn.
+          #
           #   @param include [Array<Symbol, OpenAI::Models::Beta::BetaResponseIncludable>, nil]
           #     Specify additional output data to include in the model response. Currently
           #     supported values are:
@@ -1329,6 +1342,9 @@ module OpenAI
             # replacements.
             GPT_5_4_NANO = :"gpt-5.4-nano"
             GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+            # @deprecated Announced shutdown date: 2027-04-01. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
             # @deprecated Announced shutdown date: 2026-08-10. See
             # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1346,6 +1362,9 @@ module OpenAI
             # https://developers.openai.com/api/docs/deprecations for details and recommended
             # replacements.
             GPT_5_1 = :"gpt-5.1"
+            # @deprecated Announced shutdown date: 2027-04-01. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
             # @deprecated Announced shutdown date: 2026-07-23. See
             # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -634,8 +634,8 @@ module OpenAI
           # @!attribute input_fidelity
           #   Control how much effort the model will exert to match the style and features,
           #   especially facial features, of input images. Supports `high` and `low` on
-          #   `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          #   `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          #   this parameter. Defaults to `low` on supported models.
           #
           #   @return [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::InputFidelity, nil]
           optional(
@@ -736,8 +736,8 @@ module OpenAI
           #   @param input_fidelity [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::InputFidelity, nil]
           #     Control how much effort the model will exert to match the style and features,
           #     especially facial features, of input images. Supports `high` and `low` on
-          #     `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          #     `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          #     `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          #     this parameter. Defaults to `low` on supported models.
           #
           #   @param input_image_mask [OpenAI::Models::Beta::BetaTool::ImageGeneration::InputImageMask]
           #     Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -826,8 +826,8 @@ module OpenAI
 
           # Control how much effort the model will exert to match the style and features,
           # especially facial features, of input images. Supports `high` and `low` on
-          # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          # this parameter. Defaults to `low` on supported models.
           #
           # @see OpenAI::Models::Beta::BetaTool::ImageGeneration#input_fidelity
           module InputFidelity

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

@@ -428,6 +428,9 @@ module OpenAI
           # replacements.
           GPT_5_4_NANO = :"gpt-5.4-nano"
           GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
           # @deprecated Announced shutdown date: 2026-08-10. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -445,6 +448,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_5_1 = :"gpt-5.1"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           # @deprecated Announced shutdown date: 2026-07-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -1013,6 +1013,9 @@ module OpenAI
           # replacements.
           GPT_5_4_NANO = :"gpt-5.4-nano"
           GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
           # @deprecated Announced shutdown date: 2026-08-10. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1030,6 +1033,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_5_1 = :"gpt-5.1"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           # @deprecated Announced shutdown date: 2026-07-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -34,9 +34,9 @@ module OpenAI
           required :type, const: :file
 
           # @!attribute prompt_cache_breakpoint
-          #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-          #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-          #   token block.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @return [OpenAI::Models::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint, nil]
           optional(
@@ -51,9 +51,9 @@ module OpenAI
           #   @param file [OpenAI::Models::Chat::ChatCompletionContentPart::File::File]
           #
           #   @param prompt_cache_breakpoint [OpenAI::Models::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint]
-          #     Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-          #     from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-          #     token block.
+          #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #     not rounded to a token block.
           #
           #   @param type [Symbol, :file]
           #     The type of the content part. Always `file`.
@@ -106,9 +106,9 @@ module OpenAI
             optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl }
 
             # @!method initialize(ttl: nil, mode: :explicit)
-            #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-            #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-            #   token block.
+            #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+            #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+            #   not rounded to a token block.
             #
             #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl]
             #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -16,9 +16,9 @@ module OpenAI
         required :type, const: :image_url
 
         # @!attribute prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         #
         #   @return [OpenAI::Models::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint, nil]
         optional(
@@ -33,9 +33,9 @@ module OpenAI
         #   @param image_url [OpenAI::Models::Chat::ChatCompletionContentPartImage::ImageURL]
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint]
-        #     Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #     from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #     token block.
+        #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #     not rounded to a token block.
         #
         #   @param type [Symbol, :image_url]
         #     The type of the content part.
@@ -95,9 +95,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl }
 
           # @!method initialize(ttl: nil, mode: :explicit)
-          #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-          #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-          #   token block.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -16,9 +16,9 @@ module OpenAI
         required :type, const: :input_audio
 
         # @!attribute prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         #
         #   @return [OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint, nil]
         optional(
@@ -32,9 +32,9 @@ module OpenAI
         #   @param input_audio [OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::InputAudio]
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint]
-        #     Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #     from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #     token block.
+        #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #     not rounded to a token block.
         #
         #   @param type [Symbol, :input_audio]
         #     The type of the content part. Always `input_audio`.
@@ -93,9 +93,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl }
 
           # @!method initialize(ttl: nil, mode: :explicit)
-          #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-          #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-          #   token block.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -17,9 +17,9 @@ module OpenAI
         required :type, const: :text
 
         # @!attribute prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         #
         #   @return [OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint, nil]
         optional(
@@ -34,9 +34,9 @@ module OpenAI
         #     The text content.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint]
-        #     Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #     from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #     token block.
+        #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #     not rounded to a token block.
         #
         #   @param type [Symbol, :text]
         #     The type of the content part.
@@ -56,9 +56,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl }
 
           # @!method initialize(ttl: nil, mode: :explicit)
-          #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-          #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-          #   token block.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

data/lib/openai/models/chat_model.rb

@@ -22,6 +22,9 @@ module OpenAI
       # replacements.
       GPT_5_4_NANO = :"gpt-5.4-nano"
       GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+      # @deprecated Announced shutdown date: 2027-04-01. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
       # @deprecated Announced shutdown date: 2026-08-10. See
       # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -39,6 +42,9 @@ module OpenAI
       # https://developers.openai.com/api/docs/deprecations for details and recommended
       # replacements.
       GPT_5_1 = :"gpt-5.1"
+      # @deprecated Announced shutdown date: 2027-04-01. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
       # @deprecated Announced shutdown date: 2026-07-23. See
       # https://developers.openai.com/api/docs/deprecations for details and recommended

data/lib/openai/models/conversations/computer_screenshot_content.rb

@@ -31,9 +31,9 @@ module OpenAI
         required :type, const: :computer_screenshot
 
         # @!attribute prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         #
         #   @return [OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint, nil]
         optional(
@@ -55,9 +55,9 @@ module OpenAI
         #     The URL of the screenshot image.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint]
-        #     Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #     from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #     token block.
+        #     Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #     breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #     not rounded to a token block.
         #
         #   @param type [Symbol, :computer_screenshot]
         #     Specifies the event type. For a computer screenshot, this property is always set
@@ -94,9 +94,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl }
 
           # @!method initialize(ttl: nil, mode: :explicit)
-          #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-          #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-          #   token block.
+          #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+          #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+          #   not rounded to a token block.
           #
           #   @param ttl [Symbol, OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

data/lib/openai/models/conversations/conversation_item.rb

@@ -45,8 +45,8 @@ module OpenAI
 
         variant :additional_tools, -> { OpenAI::Conversations::ConversationItem::AdditionalTools }
 
-        # A configuration update that applies to subsequent responses until it is
-        # replaced by another configuration update.
+        # A configuration update for subsequent responses. Each setting stays in effect
+        # until a later update replaces that setting.
         variant :configuration_update, -> { OpenAI::Responses::ResponseConfigurationUpdateItem }
 
         # A description of the chain of thought used by a reasoning model while generating