openai 0.113.0 → 0.114.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0eae0c57cd325d109de04f4df3df293bde2f816e040ac3c0b1ec7bb608413d67
-  data.tar.gz: 14b51d57e7d641c062772563060130bd4a7f9a8ce00940125452e2f0e7a95e28
+  metadata.gz: f8905b3e720546308f3334931a036c17e3e990e66ec863039da6c661d6024dec
+  data.tar.gz: 4698d4841fd6becc4266b58c8b863e3fb7b50a16d4b76523808ac291e5c566f3
 SHA512:
-  metadata.gz: 3f2a4f11fb6fba7da961eb45aee74bdb69fb755e9c3ca49d809ab7c123d2ad870d8da5ba7302883491f66547ef71918e36b9f96ea178681c9cdfa99b139b0439
-  data.tar.gz: aac404f91cfe8c4babce9f83c6c2dc4aa00e8442e7e4859b4a4706a64e88a92adceefcea34e1b89d6588ab23d84bbce74fb92475ee000a411d1a4050ed713364
+  metadata.gz: e664a8f9ee816f4deb836f3b03b1d82a5178f9d8e85fa42a25530e1b3d514273dbefd17da517837b5ef197e51c0e16abcf85c845491744278339903abc3b1502
+  data.tar.gz: 6398277b839b172914d849d071a4994d8a2c0e90ef74cde85ce76f27c940753b000e0f709f05a1d1e0f9ab8fdb7c44ce3cb77f5f6f8fcde257fbd4cdc466673c

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.114.0](https://github.com/openai/openai-ruby/compare/v0.113.0...v0.114.0) (2026-10-27)
+
+
+### Features
+
+* **api:** add prompt cache breakpoint TTL options ([#977](https://github.com/openai/openai-ruby/issues/977)) ([cc896f4](https://github.com/openai/openai-ruby/commit/cc896f44aa0ae894c9ef26e28b7700a4c521e75f))
+
+
+### Bug Fixes
+
+* sanitize cloud metadata provider errors ([#971](https://github.com/openai/openai-ruby/issues/971)) ([806f5b6](https://github.com/openai/openai-ruby/commit/806f5b67f9dc17871300862eb1107e87a52a062b))
+
+
+### Chores
+
+* **deps-dev:** bump the development-dependencies group with 2 updates ([#968](https://github.com/openai/openai-ruby/issues/968)) ([a3c5ba1](https://github.com/openai/openai-ruby/commit/a3c5ba1f0d5b936f5a631a7acabc92151c70cb14))
+* **deps:** bump ruby/setup-ruby from 1.332.0 to 1.335.0 ([#970](https://github.com/openai/openai-ruby/issues/970)) ([3c7c446](https://github.com/openai/openai-ruby/commit/3c7c4469c802184715900db771341cd2272fd547))
+
 ## [0.113.0](https://github.com/openai/openai-ruby/compare/v0.112.0...v0.113.0) (2026-10-26)
 
 

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.113.0"
+gem "openai", "~> 0.114.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/auth/subject_token_providers/azure_managed_identity_token_provider.rb

@@ -59,9 +59,10 @@ module OpenAI
           unless response.is_a?(Net::HTTPSuccess)
             raise(
               OpenAI::Errors::SubjectTokenProviderError.new(
-                message: "Azure IMDS returned #{response.code}: #{response.body}",
+                message: "Azure IMDS returned #{response.code}",
                 provider: "azure-imds"
-              )
+              ),
+              cause: nil
             )
           end
 
@@ -75,19 +76,20 @@ module OpenAI
               OpenAI::Errors::SubjectTokenProviderError.new(
                 message: "Azure IMDS response missing access_token field",
                 provider: "azure-imds"
-              )
+              ),
+              cause: nil
             )
           end
 
         rescue OpenAI::Errors::SubjectTokenProviderError
           raise
-        rescue StandardError => e
+        rescue StandardError
           raise(
             OpenAI::Errors::SubjectTokenProviderError.new(
-              message: "Failed to fetch token from Azure IMDS: #{e.message}",
-              provider: "azure-imds",
-              cause: e
-            )
+              message: "Failed to fetch token from Azure IMDS",
+              provider: "azure-imds"
+            ),
+            cause: nil
           )
         end
       end

data/lib/openai/auth/subject_token_providers/gcp_id_token_provider.rb

@@ -47,22 +47,23 @@ module OpenAI
           unless response.is_a?(Net::HTTPSuccess)
             raise(
               OpenAI::Errors::SubjectTokenProviderError.new(
-                message: "GCP Metadata Server returned #{response.code}: #{response.body}",
+                message: "GCP Metadata Server returned #{response.code}",
                 provider: "gcp-metadata"
-              )
+              ),
+              cause: nil
             )
           end
 
           response.body
         rescue OpenAI::Errors::SubjectTokenProviderError
           raise
-        rescue StandardError => e
+        rescue StandardError
           raise(
             OpenAI::Errors::SubjectTokenProviderError.new(
-              message: "Failed to fetch token from GCP Metadata Server: #{e.message}",
-              provider: "gcp-metadata",
-              cause: e
-            )
+              message: "Failed to fetch token from GCP Metadata Server",
+              provider: "gcp-metadata"
+            ),
+            cause: nil
           )
         end
       end

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

@@ -45,9 +45,9 @@ module OpenAI
         optional :filename, String
 
         # @!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::BetaResponseInputFile::PromptCacheBreakpoint, nil]
         optional :prompt_cache_breakpoint, -> { OpenAI::Beta::BetaResponseInputFile::PromptCacheBreakpoint }
@@ -75,9 +75,9 @@ module OpenAI
         #     The name of the file to be sent to the model.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Beta::BetaResponseInputFile::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_file]
         #     The type of the input item. Always `input_file`.
@@ -115,9 +115,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputFile::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::BetaResponseInputFile::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -45,9 +45,9 @@ module OpenAI
         optional :filename, String, nil?: true
 
         # @!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::BetaResponseInputFileContent::PromptCacheBreakpoint, nil]
         optional(
@@ -79,9 +79,9 @@ module OpenAI
         #     The name of the file to be sent to the model.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Beta::BetaResponseInputFileContent::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_file]
         #     The type of the input item. Always `input_file`.
@@ -119,9 +119,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputFileContent::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::BetaResponseInputFileContent::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -31,9 +31,9 @@ module OpenAI
         optional :image_url, String, nil?: true
 
         # @!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::BetaResponseInputImage::PromptCacheBreakpoint, nil]
         optional :prompt_cache_breakpoint, -> { OpenAI::Beta::BetaResponseInputImage::PromptCacheBreakpoint }
@@ -54,9 +54,9 @@ module OpenAI
         #     encoded image in a data URL.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Beta::BetaResponseInputImage::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_image]
         #     The type of the input item. Always `input_image`.
@@ -92,9 +92,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputImage::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::BetaResponseInputImage::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -31,9 +31,9 @@ module OpenAI
         optional :image_url, String, nil?: true
 
         # @!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::BetaResponseInputImageContent::PromptCacheBreakpoint, nil]
         optional(
@@ -58,9 +58,9 @@ module OpenAI
         #     encoded image in a data URL.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Beta::BetaResponseInputImageContent::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_image]
         #     The type of the input item. Always `input_image`.
@@ -96,9 +96,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputImageContent::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::BetaResponseInputImageContent::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

data/lib/openai/models/beta/beta_response_input_text.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::BetaResponseInputText::PromptCacheBreakpoint, nil]
         optional :prompt_cache_breakpoint, -> { OpenAI::Beta::BetaResponseInputText::PromptCacheBreakpoint }
@@ -31,9 +31,9 @@ module OpenAI
         #     The text input to the model.
         #
         #   @param prompt_cache_breakpoint [OpenAI::Models::Beta::BetaResponseInputText::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_text]
         #     The type of the input item. Always `input_text`.
@@ -53,9 +53,9 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Beta::BetaResponseInputText::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::BetaResponseInputText::PromptCacheBreakpoint::Ttl]
           #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

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

@@ -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/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.