openai 0.117.0 → 0.118.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 55a123764dd864cd95a2009db727f340e39256d6caad2cb23b52b31474397fd9
-  data.tar.gz: bb293c23c56337711290c5b443befd3f335643edbb9c0b322420514f2d0ac8fa
+  metadata.gz: e37e3fb7c53769a3fb7bbe6a79b7c3f5d4b9d5c3d5f13fb6c5317f489019086a
+  data.tar.gz: c9d804e63b8ff116a72bbc6c471ad398c303d7373af5fba01aa5bba7c3996297
 SHA512:
-  metadata.gz: 911802a98612e72b29e84f8b0bb83f8e4e40e4ca9b9766ecb1342586de425f426a69cf0c06c112af70549254d751e810a8eef69d1cd5204086d44063f665c6b1
-  data.tar.gz: cffeaaafe610bf866cdd0e89d3172583d441bbb435bdb6c7809023a0f5693922a832c8418ffd8f1b26dd763b0f12d3037dc65418de0e6e50e4a3a11ce1c47e7b
+  metadata.gz: d991c961da46c6b12a857e0412afc71177ecef975a7b09a5ccfa93235678621a94d2c53614844f8e05f8f5194afbd24d39a11fa7d1c2558ab104e8e0fcb30a31
+  data.tar.gz: 9e9bf4dfd8ad78e2f2fda579f962cb105047c4b443bb81e88c19b61c7ed900260a4d31c85cc781a4e3005ad2c23c7c733c4e6eb37d4a110c6a524938bc08f53d

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.118.0](https://github.com/openai/openai-ruby/compare/v0.117.0...v0.118.0) (2026-11-03)
+
+
+### Features
+
+* **api:** add 12-hour Responses caching and cache-write usage ([#1029](https://github.com/openai/openai-ruby/issues/1029)) ([32b30ff](https://github.com/openai/openai-ruby/commit/32b30ffb3ce07fad285fd2df3afef76df7e9f901))
+* **api:** add project service tier settings ([#1028](https://github.com/openai/openai-ruby/issues/1028)) ([8c8e4e8](https://github.com/openai/openai-ruby/commit/8c8e4e8e28e9f412eb32ab839b447224e6f1cd87))
+
+
+### Documentation
+
+* clarify generated-file ownership ([#1030](https://github.com/openai/openai-ruby/issues/1030)) ([51508aa](https://github.com/openai/openai-ruby/commit/51508aa5047698ed1e792003a65f84934e51b77f))
+
 ## [0.117.0](https://github.com/openai/openai-ruby/compare/v0.116.0...v0.117.0) (2026-11-03)
 
 

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.117.0"
+gem "openai", "~> 0.118.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/models/admin/organization/projects/project_optional_service_tier.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        module Projects
+          module ProjectOptionalServiceTier
+            extend OpenAI::Internal::Type::Enum
+
+            FLEX = :flex
+            FAST = :fast
+            ULTRAFAST = :ultrafast
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        ProjectOptionalServiceTier = Projects::ProjectOptionalServiceTier
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/projects/project_service_tier_settings.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        module Projects
+          # @see OpenAI::Resources::Admin::Organization::Projects::ServiceTierSettings#retrieve
+          class ProjectServiceTierSettings < OpenAI::Internal::Type::BaseModel
+            # @!attribute default
+            #   Default tier for requests that omit service_tier or use auto.
+            #
+            #   @return [Symbol, OpenAI::Models::Admin::Organization::Projects::ProjectServiceTierSettings::Default]
+            required :default, enum: -> { OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::Default }
+
+            # @!attribute enabled_tiers
+            #   Additional service tiers enabled for this project. "all" includes future tiers.
+            #   An empty array allows only Standard. Organization policy and eligibility still
+            #   apply.
+            #
+            #   @return [Symbol, :all, Array<Symbol, OpenAI::Models::Admin::Organization::Projects::ProjectOptionalServiceTier>]
+            required(
+              :enabled_tiers,
+              union: -> { OpenAI::Admin::Organization::Projects::ProjectServiceTierSettings::EnabledTiers }
+            )
+
+            # @!attribute object
+            #
+            #   @return [Symbol, :"project.service_tier_settings"]
+            required :object, const: :"project.service_tier_settings"
+
+            # @!method initialize(default:, enabled_tiers:, object: :"project.service_tier_settings")
+            #   @param default [Symbol, OpenAI::Models::Admin::Organization::Projects::ProjectServiceTierSettings::Default]
+            #     Default tier for requests that omit service_tier or use auto.
+            #
+            #   @param enabled_tiers [Symbol, :all, Array<Symbol, OpenAI::Models::Admin::Organization::Projects::ProjectOptionalServiceTier>]
+            #     Additional service tiers enabled for this project. "all" includes future tiers.
+            #     An empty array allows only Standard. Organization policy and eligibility still
+            #     apply.
+            #
+            #   @param object [Symbol, :"project.service_tier_settings"]
+
+            # Default tier for requests that omit service_tier or use auto.
+            #
+            # @see OpenAI::Models::Admin::Organization::Projects::ProjectServiceTierSettings#default
+            module Default
+              extend OpenAI::Internal::Type::Enum
+
+              STANDARD = :standard
+              FAST = :fast
+              SCALE = :scale
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Additional service tiers enabled for this project. "all" includes future tiers.
+            # An empty array allows only Standard. Organization policy and eligibility still
+            # apply.
+            #
+            # @see OpenAI::Models::Admin::Organization::Projects::ProjectServiceTierSettings#enabled_tiers
+            module EnabledTiers
+              extend OpenAI::Internal::Type::Union
+
+              variant const: :all
+
+              variant(
+                -> {
+                  OpenAI::Models::Admin::Organization::Projects::ProjectServiceTierSettings::EnabledTiers::ProjectOptionalServiceTierArray
+                }
+              )
+
+              # @!method self.variants
+              #   @return [Array(Symbol, :all, Array<Symbol, OpenAI::Models::Admin::Organization::Projects::ProjectOptionalServiceTier>)]
+
+              # @type [OpenAI::Internal::Type::Converter]
+              ProjectOptionalServiceTierArray = OpenAI::Internal::Type::ArrayOf[
+                enum: -> { OpenAI::Models::Admin::Organization::Projects::ProjectOptionalServiceTier }
+              ]
+            end
+          end
+        end
+
+        ProjectServiceTierSettings = Projects::ProjectServiceTierSettings
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/projects/service_tier_setting_retrieve_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        module Projects
+          # @see OpenAI::Resources::Admin::Organization::Projects::ServiceTierSettings#retrieve
+          class ServiceTierSettingRetrieveParams < OpenAI::Internal::Type::BaseModel
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            # @!attribute project_id
+            #   The ID of the project
+            #
+            #   @return [String]
+            required :project_id, String
+
+            # @!method initialize(project_id:, request_options: {})
+            #   @param project_id [String]
+            #     The ID of the project
+            #
+            #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/projects/service_tier_setting_update_params.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        module Projects
+          # @see OpenAI::Resources::Admin::Organization::Projects::ServiceTierSettings#update
+          class ServiceTierSettingUpdateParams < OpenAI::Internal::Type::BaseModel
+            extend OpenAI::Internal::Type::RequestParameters::Converter
+            include OpenAI::Internal::Type::RequestParameters
+
+            # @!attribute project_id
+            #   The ID of the project
+            #
+            #   @return [String]
+            required :project_id, String
+
+            # @!attribute default
+            #   Default tier for requests that omit service_tier or use auto.
+            #
+            #   @return [Symbol, OpenAI::Models::Admin::Organization::Projects::ServiceTierSettingUpdateParams::Default, nil]
+            optional(
+              :default,
+              enum: -> { OpenAI::Admin::Organization::Projects::ServiceTierSettingUpdateParams::Default }
+            )
+
+            # @!attribute enabled_tiers
+            #   Additional service tiers enabled for this project. "all" includes future tiers.
+            #   An empty array allows only Standard. Organization policy and eligibility still
+            #   apply.
+            #
+            #   @return [Symbol, :all, Array<Symbol, OpenAI::Models::Admin::Organization::Projects::ProjectOptionalServiceTier>, nil]
+            optional(
+              :enabled_tiers,
+              union: -> { OpenAI::Admin::Organization::Projects::ServiceTierSettingUpdateParams::EnabledTiers }
+            )
+
+            # @!method initialize(project_id:, default: nil, enabled_tiers: nil, request_options: {})
+            #   @param project_id [String]
+            #     The ID of the project
+            #
+            #   @param default [Symbol, OpenAI::Models::Admin::Organization::Projects::ServiceTierSettingUpdateParams::Default]
+            #     Default tier for requests that omit service_tier or use auto.
+            #
+            #   @param enabled_tiers [Symbol, :all, Array<Symbol, OpenAI::Models::Admin::Organization::Projects::ProjectOptionalServiceTier>]
+            #     Additional service tiers enabled for this project. "all" includes future tiers.
+            #     An empty array allows only Standard. Organization policy and eligibility still
+            #     apply.
+            #
+            #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+            # Default tier for requests that omit service_tier or use auto.
+            module Default
+              extend OpenAI::Internal::Type::Enum
+
+              STANDARD = :standard
+              FAST = :fast
+              SCALE = :scale
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Additional service tiers enabled for this project. "all" includes future tiers.
+            # An empty array allows only Standard. Organization policy and eligibility still
+            # apply.
+            module EnabledTiers
+              extend OpenAI::Internal::Type::Union
+
+              variant const: :all
+
+              variant(
+                -> {
+                  OpenAI::Models::Admin::Organization::Projects::ServiceTierSettingUpdateParams::EnabledTiers::ProjectOptionalServiceTierArray
+                }
+              )
+
+              # @!method self.variants
+              #   @return [Array(Symbol, :all, Array<Symbol, OpenAI::Models::Admin::Organization::Projects::ProjectOptionalServiceTier>)]
+
+              # @type [OpenAI::Internal::Type::Converter]
+              ProjectOptionalServiceTierArray = OpenAI::Internal::Type::ArrayOf[
+                enum: -> { OpenAI::Models::Admin::Organization::Projects::ProjectOptionalServiceTier }
+              ]
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1855,6 +1855,7 @@ module OpenAI
             extend OpenAI::Internal::Type::Enum
 
             TTL_30M = :"30m"
+            TTL_12H = :"12h"
 
             # @!method self.values
             #   @return [Array<Symbol>]

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

@@ -68,7 +68,15 @@ module OpenAI
           #   @return [Integer]
           required :cached_tokens, Integer
 
-          # @!method initialize(cache_write_tokens:, cached_tokens:)
+          # @!attribute cache_write_tokens_details
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails, nil]
+          optional(
+            :cache_write_tokens_details,
+            -> { OpenAI::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails }
+          )
+
+          # @!method initialize(cache_write_tokens:, cached_tokens:, cache_write_tokens_details: nil)
           #   A detailed breakdown of the input tokens.
           #
           #   @param cache_write_tokens [Integer]
@@ -77,6 +85,30 @@ module OpenAI
           #   @param cached_tokens [Integer]
           #     The number of tokens that were retrieved from the cache.
           #     [More on prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching).
+          #
+          #   @param cache_write_tokens_details [OpenAI::Models::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails]
+
+          # @see OpenAI::Models::Beta::BetaResponseUsage::InputTokensDetails#cache_write_tokens_details
+          class CacheWriteTokensDetails < OpenAI::Internal::Type::BaseModel
+            # @!attribute ttl_12h_tokens
+            #   The number of input tokens written with 12-hour retention.
+            #
+            #   @return [Integer]
+            required :ttl_12h_tokens, Integer
+
+            # @!attribute ttl_30m_tokens
+            #   The number of input tokens written with 30-minute retention.
+            #
+            #   @return [Integer]
+            required :ttl_30m_tokens, Integer
+
+            # @!method initialize(ttl_12h_tokens:, ttl_30m_tokens:)
+            #   @param ttl_12h_tokens [Integer]
+            #     The number of input tokens written with 12-hour retention.
+            #
+            #   @param ttl_30m_tokens [Integer]
+            #     The number of input tokens written with 30-minute retention.
+          end
         end
 
         # @see OpenAI::Models::Beta::BetaResponseUsage#output_tokens_details

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

@@ -253,7 +253,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #
@@ -617,7 +617,7 @@ module OpenAI
           #     request can write up to four breakpoints. For cache matching, OpenAI considers
           #     up to the latest 80 breakpoints in the conversation, without a content-block
           #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #     for current details.
           #
@@ -1884,8 +1884,8 @@ module OpenAI
 
             # @!attribute ttl
             #   The minimum lifetime applied to every implicit and explicit cache breakpoint
-            #   written by the request. Defaults to `30m`, which is currently the only supported
-            #   value. The backend may retain cache entries for longer.
+            #   written by the request. Supported values are `30m` (the default) and `12h`. The
+            #   backend may retain cache entries for longer.
             #
             #   @return [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl, nil]
             optional(
@@ -1900,7 +1900,7 @@ module OpenAI
             #   request can write up to four breakpoints. For cache matching, OpenAI considers
             #   up to the latest 80 breakpoints in the conversation, without a content-block
             #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-            #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+            #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
             #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
             #   for current details.
             #
@@ -1922,8 +1922,8 @@ module OpenAI
             #
             #   @param ttl [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl]
             #     The minimum lifetime applied to every implicit and explicit cache breakpoint
-            #     written by the request. Defaults to `30m`, which is currently the only supported
-            #     value. The backend may retain cache entries for longer.
+            #     written by the request. Supported values are `30m` (the default) and `12h`. The
+            #     backend may retain cache entries for longer.
 
             # Controls whether OpenAI automatically creates an implicit cache breakpoint.
             # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -1944,14 +1944,15 @@ module OpenAI
             end
 
             # The minimum lifetime applied to every implicit and explicit cache breakpoint
-            # written by the request. Defaults to `30m`, which is currently the only supported
-            # value. The backend may retain cache entries for longer.
+            # written by the request. Supported values are `30m` (the default) and `12h`. The
+            # backend may retain cache entries for longer.
             #
             # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions#ttl
             module Ttl
               extend OpenAI::Internal::Type::Enum
 
               TTL_30M = :"30m"
+              TTL_12H = :"12h"
 
               # @!method self.values
               #   @return [Array<Symbol>]

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

@@ -55,7 +55,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
@@ -139,7 +139,7 @@ module OpenAI
         #     request can write up to four breakpoints. For cache matching, OpenAI considers
         #     up to the latest 80 breakpoints in the conversation, without a content-block
         #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #     for current details.
         #
@@ -830,7 +830,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #

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

@@ -182,7 +182,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
@@ -494,7 +494,7 @@ module OpenAI
         #     request can write up to four breakpoints. For cache matching, OpenAI considers
         #     up to the latest 80 breakpoints in the conversation, without a content-block
         #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #     for current details.
         #
@@ -1533,8 +1533,8 @@ module OpenAI
 
           # @!attribute ttl
           #   The minimum lifetime applied to every implicit and explicit cache breakpoint
-          #   written by the request. Defaults to `30m`, which is currently the only supported
-          #   value. The backend may retain cache entries for longer.
+          #   written by the request. Supported values are `30m` (the default) and `12h`. The
+          #   backend may retain cache entries for longer.
           #
           #   @return [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Ttl, nil]
           optional :ttl, enum: -> { OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl }
@@ -1546,7 +1546,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #
@@ -1568,8 +1568,8 @@ module OpenAI
           #
           #   @param ttl [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Ttl]
           #     The minimum lifetime applied to every implicit and explicit cache breakpoint
-          #     written by the request. Defaults to `30m`, which is currently the only supported
-          #     value. The backend may retain cache entries for longer.
+          #     written by the request. Supported values are `30m` (the default) and `12h`. The
+          #     backend may retain cache entries for longer.
 
           # Controls whether OpenAI automatically creates an implicit cache breakpoint.
           # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -1590,14 +1590,15 @@ module OpenAI
           end
 
           # The minimum lifetime applied to every implicit and explicit cache breakpoint
-          # written by the request. Defaults to `30m`, which is currently the only supported
-          # value. The backend may retain cache entries for longer.
+          # written by the request. Supported values are `30m` (the default) and `12h`. The
+          # backend may retain cache entries for longer.
           #
           # @see OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions#ttl
           module Ttl
             extend OpenAI::Internal::Type::Enum
 
             TTL_30M = :"30m"
+            TTL_12H = :"12h"
 
             # @!method self.values
             #   @return [Array<Symbol>]

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

@@ -212,7 +212,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
@@ -569,7 +569,7 @@ module OpenAI
         #     request can write up to four breakpoints. For cache matching, OpenAI considers
         #     up to the latest 80 breakpoints in the conversation, without a content-block
         #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #     for current details.
         #
@@ -979,7 +979,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #

data/lib/openai/models/responses/response.rb

@@ -1239,6 +1239,7 @@ module OpenAI
             extend OpenAI::Internal::Type::Enum
 
             TTL_30M = :"30m"
+            TTL_12H = :"12h"
 
             # @!method self.values
             #   @return [Array<Symbol>]

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

@@ -55,7 +55,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
@@ -132,7 +132,7 @@ module OpenAI
         #     request can write up to four breakpoints. For cache matching, OpenAI considers
         #     up to the latest 80 breakpoints in the conversation, without a content-block
         #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #     for current details.
         #
@@ -833,7 +833,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #

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

@@ -182,7 +182,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
@@ -491,7 +491,7 @@ module OpenAI
         #     request can write up to four breakpoints. For cache matching, OpenAI considers
         #     up to the latest 80 breakpoints in the conversation, without a content-block
         #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #     for current details.
         #
@@ -887,8 +887,8 @@ module OpenAI
 
           # @!attribute ttl
           #   The minimum lifetime applied to every implicit and explicit cache breakpoint
-          #   written by the request. Defaults to `30m`, which is currently the only supported
-          #   value. The backend may retain cache entries for longer.
+          #   written by the request. Supported values are `30m` (the default) and `12h`. The
+          #   backend may retain cache entries for longer.
           #
           #   @return [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Ttl, nil]
           optional :ttl, enum: -> { OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Ttl }
@@ -900,7 +900,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #
@@ -922,8 +922,8 @@ module OpenAI
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Ttl]
           #     The minimum lifetime applied to every implicit and explicit cache breakpoint
-          #     written by the request. Defaults to `30m`, which is currently the only supported
-          #     value. The backend may retain cache entries for longer.
+          #     written by the request. Supported values are `30m` (the default) and `12h`. The
+          #     backend may retain cache entries for longer.
 
           # Controls whether OpenAI automatically creates an implicit cache breakpoint.
           # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -944,14 +944,15 @@ module OpenAI
           end
 
           # The minimum lifetime applied to every implicit and explicit cache breakpoint
-          # written by the request. Defaults to `30m`, which is currently the only supported
-          # value. The backend may retain cache entries for longer.
+          # written by the request. Supported values are `30m` (the default) and `12h`. The
+          # backend may retain cache entries for longer.
           #
           # @see OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions#ttl
           module Ttl
             extend OpenAI::Internal::Type::Enum
 
             TTL_30M = :"30m"
+            TTL_12H = :"12h"
 
             # @!method self.values
             #   @return [Array<Symbol>]