openai 0.117.0 → 0.119.0

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

@@ -755,6 +755,32 @@ module OpenAI
               enum: -> { OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Background }
             )
 
+            # @!attribute complexity
+            #   Computation spent planning the image, independently of rendering quality.
+            #   Overrides the outer response's `reasoning.effort` for image generation. When
+            #   omitted, inherits a supported outer reasoning effort or uses the image model's
+            #   configured default. For SVG output, controls the reference image, not the SVG
+            #   author's reasoning.
+            #
+            #   @return [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity, nil]
+            optional(
+              :complexity,
+              enum: -> { OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity }
+            )
+
+            # @!attribute frame_count
+            #   Number of GIF frames. Requires `output_format` to be `gif`. Default: 9.
+            #
+            #   @return [Integer, nil]
+            optional :frame_count, Integer
+
+            # @!attribute frame_duration_ms
+            #   Duration of each GIF frame in milliseconds, rounded to 10 ms. Requires
+            #   `output_format` to be `gif`. Default: 200.
+            #
+            #   @return [Integer, nil]
+            optional :frame_duration_ms, Integer
+
             # @!attribute input_fidelity
             #   Control how much effort the model will exert to match the style and features,
             #   especially facial features, of input images. Supports `high` and `low` on
@@ -784,8 +810,8 @@ module OpenAI
             #   The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
             #   `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
             #   `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
-            #   `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
-            #   `gpt-image-2`.
+            #   `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
+            #   `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
             #
             #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
             #   `gpt-image-2.5-flare` instead.
@@ -812,8 +838,12 @@ module OpenAI
             optional :output_compression, Integer
 
             # @!attribute output_format
-            #   The output format of the generated image. One of `png`, `webp`, or `jpeg`.
-            #   Default: `png`.
+            #   The output format of the generated image. One of `png`, `webp`, `jpeg`, `gif`,
+            #   or `svg`. Default: `png`. GIF and SVG output require a model that supports the
+            #   selected format. GIF output does not support partial image streaming
+            #   (`partial_images` greater than `0`), `input_image_mask`, or custom
+            #   `output_compression`. Responses lifecycle events can still be streamed for GIF
+            #   output.
             #
             #   @return [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::OutputFormat, nil]
             optional(
@@ -858,7 +888,16 @@ module OpenAI
               union: -> { OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size }
             )
 
-            # @!method initialize(action: nil, background: nil, input_fidelity: nil, input_image_mask: nil, model: nil, moderation: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, size: nil, type: :image_generation)
+            # @!attribute svg
+            #   SVG author model settings. Requires `output_format` to be `svg`. When SVG model
+            #   selection is enabled, omitting this object uses the outer response model.
+            #   Otherwise, the default SVG author is used and explicit model overrides are
+            #   unavailable.
+            #
+            #   @return [OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg, nil]
+            optional :svg, -> { OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg }
+
+            # @!method initialize(action: nil, background: nil, complexity: nil, frame_count: nil, frame_duration_ms: nil, input_fidelity: nil, input_image_mask: nil, model: nil, moderation: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, size: nil, svg: nil, type: :image_generation)
             #   A tool that generates images using the GPT image models.
             #
             #   @param action [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Action]
@@ -875,6 +914,20 @@ module OpenAI
             #     `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
             #     set the output format to `png` or `webp`.
             #
+            #   @param complexity [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity]
+            #     Computation spent planning the image, independently of rendering quality.
+            #     Overrides the outer response's `reasoning.effort` for image generation. When
+            #     omitted, inherits a supported outer reasoning effort or uses the image model's
+            #     configured default. For SVG output, controls the reference image, not the SVG
+            #     author's reasoning.
+            #
+            #   @param frame_count [Integer]
+            #     Number of GIF frames. Requires `output_format` to be `gif`. Default: 9.
+            #
+            #   @param frame_duration_ms [Integer]
+            #     Duration of each GIF frame in milliseconds, rounded to 10 ms. Requires
+            #     `output_format` to be `gif`. Default: 200.
+            #
             #   @param input_fidelity [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity, nil]
             #     Control how much effort the model will exert to match the style and features,
             #     especially facial features, of input images. Supports `high` and `low` on
@@ -889,8 +942,8 @@ module OpenAI
             #     The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
             #     `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
             #     `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
-            #     `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
-            #     `gpt-image-2`.
+            #     `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
+            #     `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
             #
             #     `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
             #     `gpt-image-2.5-flare` instead.
@@ -902,8 +955,12 @@ module OpenAI
             #     Compression level for the output image. Default: 100.
             #
             #   @param output_format [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::OutputFormat]
-            #     The output format of the generated image. One of `png`, `webp`, or `jpeg`.
-            #     Default: `png`.
+            #     The output format of the generated image. One of `png`, `webp`, `jpeg`, `gif`,
+            #     or `svg`. Default: `png`. GIF and SVG output require a model that supports the
+            #     selected format. GIF output does not support partial image streaming
+            #     (`partial_images` greater than `0`), `input_image_mask`, or custom
+            #     `output_compression`. Responses lifecycle events can still be streamed for GIF
+            #     output.
             #
             #   @param partial_images [Integer]
             #     Number of partial images to generate in streaming mode, from 0 (default value)
@@ -927,6 +984,12 @@ module OpenAI
             #     `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
             #     `auto` is supported for models that allow automatic sizing.
             #
+            #   @param svg [OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg]
+            #     SVG author model settings. Requires `output_format` to be `svg`. When SVG model
+            #     selection is enabled, omitting this object uses the outer response model.
+            #     Otherwise, the default SVG author is used and explicit model overrides are
+            #     unavailable.
+            #
             #   @param type [Symbol, :image_generation]
             #     The type of the image generation tool. Always `image_generation`.
 
@@ -966,6 +1029,24 @@ module OpenAI
               #   @return [Array<Symbol>]
             end
 
+            # Computation spent planning the image, independently of rendering quality.
+            # Overrides the outer response's `reasoning.effort` for image generation. When
+            # omitted, inherits a supported outer reasoning effort or uses the image model's
+            # configured default. For SVG output, controls the reference image, not the SVG
+            # author's reasoning.
+            #
+            # @see OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration#complexity
+            module Complexity
+              extend OpenAI::Internal::Type::Enum
+
+              LOW = :low
+              MEDIUM = :medium
+              HIGH = :high
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. Supports `high` and `low` on
             # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
@@ -1010,8 +1091,8 @@ module OpenAI
             # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
             # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
             # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
-            # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
-            # `gpt-image-2`.
+            # `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
+            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
             #
             # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
             # `gpt-image-2.5-flare` instead.
@@ -1070,6 +1151,18 @@ module OpenAI
                 }
               )
 
+              variant(
+                const: -> {
+                  OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_2_6_SUNBURST
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_2_6_FLARE
+                }
+              )
+
               variant(
                 const: -> {
                   OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_1_5
@@ -1106,6 +1199,8 @@ module OpenAI
               GPT_IMAGE_2_5_SUNBURST_2026_09_08 = :"gpt-image-2.5-sunburst-2026-09-08"
               GPT_IMAGE_2_5_FLARE = :"gpt-image-2.5-flare"
               GPT_IMAGE_2_5_FLARE_2026_09_08 = :"gpt-image-2.5-flare-2026-09-08"
+              GPT_IMAGE_2_6_SUNBURST = :"gpt-image-2.6-sunburst"
+              GPT_IMAGE_2_6_FLARE = :"gpt-image-2.6-flare"
               GPT_IMAGE_1_5 = :"gpt-image-1.5"
               CHATGPT_IMAGE_LATEST = :"chatgpt-image-latest"
 
@@ -1125,8 +1220,12 @@ module OpenAI
               #   @return [Array<Symbol>]
             end
 
-            # The output format of the generated image. One of `png`, `webp`, or `jpeg`.
-            # Default: `png`.
+            # The output format of the generated image. One of `png`, `webp`, `jpeg`, `gif`,
+            # or `svg`. Default: `png`. GIF and SVG output require a model that supports the
+            # selected format. GIF output does not support partial image streaming
+            # (`partial_images` greater than `0`), `input_image_mask`, or custom
+            # `output_compression`. Responses lifecycle events can still be streamed for GIF
+            # output.
             #
             # @see OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration#output_format
             module OutputFormat
@@ -1135,6 +1234,8 @@ module OpenAI
               PNG = :png
               WEBP = :webp
               JPEG = :jpeg
+              GIF = :gif
+              SVG = :svg
 
               # @!method self.values
               #   @return [Array<Symbol>]
@@ -1222,6 +1323,78 @@ module OpenAI
 
               # @!endgroup
             end
+
+            # @see OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration#svg
+            class Svg < OpenAI::Internal::Type::BaseModel
+              # @!attribute model
+              #
+              #   @return [String, nil]
+              optional :model, String
+
+              # @!attribute reasoning
+              #   Reasoning effort for SVG authoring. When omitted, uses the author model's
+              #   default in both Images and Responses.
+              #
+              #   @return [OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning, nil]
+              optional(
+                :reasoning,
+                -> {
+                  OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning
+                },
+                nil?: true
+              )
+
+              # @!method initialize(model: nil, reasoning: nil)
+              #   SVG author model settings. Requires `output_format` to be `svg`. When SVG model
+              #   selection is enabled, omitting this object uses the outer response model.
+              #   Otherwise, the default SVG author is used and explicit model overrides are
+              #   unavailable.
+              #
+              #   @param model [String]
+              #
+              #   @param reasoning [OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning, nil]
+              #     Reasoning effort for SVG authoring. When omitted, uses the author model's
+              #     default in both Images and Responses.
+
+              # @see OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg#reasoning
+              class Reasoning < OpenAI::Internal::Type::BaseModel
+                # @!attribute effort
+                #   Controls how much effort the model should spend on reasoning for this request.
+                #
+                #   @return [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort, nil]
+                optional(
+                  :effort,
+                  enum: -> {
+                    OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort
+                  }
+                )
+
+                # @!method initialize(effort: nil)
+                #   Reasoning effort for SVG authoring. When omitted, uses the author model's
+                #   default in both Images and Responses.
+                #
+                #   @param effort [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort]
+                #     Controls how much effort the model should spend on reasoning for this request.
+
+                # Controls how much effort the model should spend on reasoning for this request.
+                #
+                # @see OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning#effort
+                module Effort
+                  extend OpenAI::Internal::Type::Enum
+
+                  NONE = :none
+                  MINIMAL = :minimal
+                  LOW = :low
+                  MEDIUM = :medium
+                  HIGH = :high
+                  XHIGH = :xhigh
+                  MAX = :max
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+            end
           end
 
           class LocalShell < OpenAI::Internal::Type::BaseModel

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

@@ -107,6 +107,12 @@ module OpenAI
           #   @return [Boolean, nil]
           optional :generate, OpenAI::Internal::Type::Boolean
 
+          # @!attribute image
+          #   Request level image options.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image, nil]
+          optional :image, -> { OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Image }
+
           # @!attribute include
           #   Specify additional output data to include in the model response. Currently
           #   supported values are:
@@ -253,7 +259,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.
           #
@@ -490,7 +496,7 @@ module OpenAI
           #   @return [String, nil]
           optional :user, String
 
-          # @!method initialize(access_programs: nil, background: nil, context_management: nil, conversation: nil, generate: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
+          # @!method initialize(access_programs: nil, background: nil, context_management: nil, conversation: nil, generate: nil, image: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
           #   Client event for creating a response over a persistent WebSocket connection.
           #   This payload uses the same top-level fields as `POST /v1/responses`, plus
           #   WebSocket-only envelope metadata.
@@ -522,6 +528,9 @@ module OpenAI
           #     to false to prepare request state without model output; the response ID can be
           #     used as previous_response_id on a later turn.
           #
+          #   @param image [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image]
+          #     Request level image options.
+          #
           #   @param include [Array<Symbol, OpenAI::Models::Beta::BetaResponseIncludable>, nil]
           #     Specify additional output data to include in the model response. Currently
           #     supported values are:
@@ -617,7 +626,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.
           #
@@ -874,6 +883,44 @@ module OpenAI
             #   @return [Array(String, OpenAI::Models::Beta::BetaResponseConversationParam)]
           end
 
+          # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate#image
+          class Image < OpenAI::Internal::Type::BaseModel
+            # @!attribute context_compression
+            #   Controls image context optimization. Defaults to `auto`, which uses the model,
+            #   transport, and input to select a policy. Use `enabled` to require compression
+            #   support or `disabled` to turn it off.
+            #
+            #   @return [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image::ContextCompression, nil]
+            optional(
+              :context_compression,
+              enum: -> { OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Image::ContextCompression }
+            )
+
+            # @!method initialize(context_compression: nil)
+            #   Request level image options.
+            #
+            #   @param context_compression [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image::ContextCompression]
+            #     Controls image context optimization. Defaults to `auto`, which uses the model,
+            #     transport, and input to select a policy. Use `enabled` to require compression
+            #     support or `disabled` to turn it off.
+
+            # Controls image context optimization. Defaults to `auto`, which uses the model,
+            # transport, and input to select a policy. Use `enabled` to require compression
+            # support or `disabled` to turn it off.
+            #
+            # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image#context_compression
+            module ContextCompression
+              extend OpenAI::Internal::Type::Enum
+
+              AUTO = :auto
+              ENABLED = :enabled
+              DISABLED = :disabled
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
           # Text, image, or file inputs to the model, used to generate a response.
           #
           # Learn more:
@@ -1884,8 +1931,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 +1947,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 +1969,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 +1991,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>]