openai 0.112.0 → 0.114.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 387dbf0377bb48a284ca9d894cb7ee1c92fb9ec4234aa69d2d9401c47b3fa56a
-  data.tar.gz: ed1edc27c3616fd92ae9dfd9cfd14420d1587dd1674b9efbd3f724f1c40a8778
+  metadata.gz: f8905b3e720546308f3334931a036c17e3e990e66ec863039da6c661d6024dec
+  data.tar.gz: 4698d4841fd6becc4266b58c8b863e3fb7b50a16d4b76523808ac291e5c566f3
 SHA512:
-  metadata.gz: 5ad7bb21701733877509096fc9dfc9a83ef9028e281854247f19f1caa7dc08cb675af93a0abe35a2f88ae0ab0bc50fad4ffb06f8603688199fcf4f3f8ca66e94
-  data.tar.gz: 8f809a46118840856340c3623f6ac4874c0172904c321195b08eef3d4c0d2ef016c92de87f9d35041353682f362c77502008d0f938f69987218d17fc7346a55b
+  metadata.gz: e664a8f9ee816f4deb836f3b03b1d82a5178f9d8e85fa42a25530e1b3d514273dbefd17da517837b5ef197e51c0e16abcf85c845491744278339903abc3b1502
+  data.tar.gz: 6398277b839b172914d849d071a4994d8a2c0e90ef74cde85ce76f27c940753b000e0f709f05a1d1e0f9ab8fdb7c44ce3cb77f5f6f8fcde257fbd4cdc466673c

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # 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)
+
+
+### Features
+
+* **api:** add gpt-6.1-terra model identifier ([#972](https://github.com/openai/openai-ruby/issues/972)) ([6b91123](https://github.com/openai/openai-ruby/commit/6b911234dfacea4c9e4fcc183e8b8363d3060bd3))
+
 ## [0.112.0](https://github.com/openai/openai-ruby/compare/v0.111.0...v0.112.0) (2026-10-25)
 
 

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.112.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.rb

@@ -698,6 +698,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_6_1_SOL }
 
+          variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_6_1_TERRA }
+
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_6_SOL }
 
           variant const: -> { OpenAI::Models::Beta::BetaResponse::Model::GPT_6_LUNA }
@@ -925,6 +927,7 @@ module OpenAI
 
           GPT_6_ASTRA = :"gpt-6-astra"
           GPT_6_1_SOL = :"gpt-6.1-sol"
+          GPT_6_1_TERRA = :"gpt-6.1-terra"
           GPT_6_SOL = :"gpt-6-sol"
           GPT_6_LUNA = :"gpt-6-luna"
           GPT_5_6_SOL = :"gpt-5.6-sol"

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/beta/beta_responses_client_event.rb

@@ -901,6 +901,8 @@ module OpenAI
 
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_6_1_SOL }
 
+            variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_6_1_TERRA }
+
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_6_SOL }
 
             variant const: -> { OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Model::GPT_6_LUNA }
@@ -1312,6 +1314,7 @@ module OpenAI
 
             GPT_6_ASTRA = :"gpt-6-astra"
             GPT_6_1_SOL = :"gpt-6.1-sol"
+            GPT_6_1_TERRA = :"gpt-6.1-terra"
             GPT_6_SOL = :"gpt-6-sol"
             GPT_6_LUNA = :"gpt-6-luna"
             GPT_5_6_SOL = :"gpt-5.6-sol"

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

@@ -180,6 +180,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_6_1_SOL }
 
+          variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_6_1_TERRA }
+
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_6_SOL }
 
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_6_LUNA }
@@ -411,6 +413,7 @@ module OpenAI
 
           GPT_6_ASTRA = :"gpt-6-astra"
           GPT_6_1_SOL = :"gpt-6.1-sol"
+          GPT_6_1_TERRA = :"gpt-6.1-terra"
           GPT_6_SOL = :"gpt-6-sol"
           GPT_6_LUNA = :"gpt-6-luna"
           GPT_5_6_SOL = :"gpt-5.6-sol"

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

@@ -767,6 +767,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_6_1_SOL }
 
+          variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_6_1_TERRA }
+
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_6_SOL }
 
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_6_LUNA }
@@ -996,6 +998,7 @@ module OpenAI
 
           GPT_6_ASTRA = :"gpt-6-astra"
           GPT_6_1_SOL = :"gpt-6.1-sol"
+          GPT_6_1_TERRA = :"gpt-6.1-terra"
           GPT_6_SOL = :"gpt-6-sol"
           GPT_6_LUNA = :"gpt-6-luna"
           GPT_5_6_SOL = :"gpt-5.6-sol"

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.