openai 0.117.0 → 0.119.0

data/sig/openai/models/beta/beta_response_tool_search_output_item_param.rbs

@@ -671,6 +671,9 @@ module OpenAI
               ?type: :image_generation,
               ?action: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::action,
               ?background: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::background,
+              ?complexity: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::complexity,
+              ?frame_count: Integer,
+              ?frame_duration_ms: Integer,
               ?input_fidelity: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::input_fidelity?,
               ?input_image_mask: OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputImageMask,
               ?model: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::model,
@@ -679,7 +682,8 @@ module OpenAI
               ?output_format: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::output_format,
               ?partial_images: Integer,
               ?quality: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::quality,
-              ?size: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::size
+              ?size: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::size,
+              ?svg: OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg
             }
 
           class ImageGeneration < OpenAI::Internal::Type::BaseModel
@@ -718,6 +722,36 @@ module OpenAI
               OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::background
             ) -> OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::background
 
+            # 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.
+            attr_reader complexity: 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.
+            def complexity=: (
+              OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::complexity
+            ) -> OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::complexity
+
+            # Number of GIF frames. Requires `output_format` to be `gif`. Default: 9.
+            attr_reader frame_count: Integer?
+
+            # Number of GIF frames. Requires `output_format` to be `gif`. Default: 9.
+            def frame_count=: (Integer) -> Integer
+
+            # Duration of each GIF frame in milliseconds, rounded to 10 ms. Requires
+            # `output_format` to be `gif`. Default: 200.
+            attr_reader frame_duration_ms: Integer?
+
+            # Duration of each GIF frame in milliseconds, rounded to 10 ms. Requires
+            # `output_format` to be `gif`. Default: 200.
+            def frame_duration_ms=: (Integer) -> Integer
+
             # 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
@@ -737,8 +771,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.
@@ -747,8 +781,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.
@@ -770,12 +804,20 @@ module OpenAI
             # Compression level for the output image. Default: 100.
             def output_compression=: (Integer) -> Integer
 
-            # 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.
             attr_reader output_format: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::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.
             def output_format=: (
               OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::output_format
             ) -> OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::output_format
@@ -828,6 +870,20 @@ module OpenAI
               OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::size
             ) -> OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::size
 
+            # 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.
+            attr_reader svg: OpenAI::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.
+            def svg=: (
+              OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg
+            ) -> OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg
+
             # @param action
             #   Whether to generate a new image or edit an existing image. Default: `auto`.
             # @param background
@@ -840,6 +896,17 @@ module OpenAI
             #   backgrounds are available for supported GPT Image models. For `gpt-image-2` and
             #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
             #   set the output format to `png` or `webp`.
+            # @param 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
+            #   Number of GIF frames. Requires `output_format` to be `gif`. Default: 9.
+            # @param frame_duration_ms
+            #   Duration of each GIF frame in milliseconds, rounded to 10 ms. Requires
+            #   `output_format` to be `gif`. Default: 200.
             # @param 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
@@ -852,8 +919,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.
@@ -862,8 +929,12 @@ module OpenAI
             # @param output_compression
             #   Compression level for the output image. Default: 100.
             # @param 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.
             # @param partial_images
             #   Number of partial images to generate in streaming mode, from 0 (default value)
             #   to 3.
@@ -883,11 +954,19 @@ module OpenAI
             #   satisfy the model's current pixel and edge limits. The standard sizes
             #   `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
             #   `auto` is supported for models that allow automatic sizing.
+            # @param 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
             #   The type of the image generation tool. Always `image_generation`.
             def initialize: (
               ?action: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::action,
               ?background: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::background,
+              ?complexity: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::complexity,
+              ?frame_count: Integer,
+              ?frame_duration_ms: Integer,
               ?input_fidelity: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::input_fidelity?,
               ?input_image_mask: OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputImageMask,
               ?model: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::model,
@@ -897,6 +976,7 @@ module OpenAI
               ?partial_images: Integer,
               ?quality: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::quality,
               ?size: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::size,
+              ?svg: OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg,
               ?type: :image_generation
             ) -> void
 
@@ -904,6 +984,9 @@ module OpenAI
               ?type: :image_generation,
               ?action: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::action,
               ?background: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::background,
+              ?complexity: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::complexity,
+              ?frame_count: Integer,
+              ?frame_duration_ms: Integer,
               ?input_fidelity: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::input_fidelity?,
               ?input_image_mask: OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputImageMask,
               ?model: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::model,
@@ -912,7 +995,8 @@ module OpenAI
               ?output_format: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::output_format,
               ?partial_images: Integer,
               ?quality: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::quality,
-              ?size: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::size
+              ?size: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::size,
+              ?svg: OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg
             }
 
             type action = :generate | :edit | :auto
@@ -939,6 +1023,18 @@ module OpenAI
               def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::background]
             end
 
+            type complexity = :low | :medium | :high
+
+            module Complexity
+              extend OpenAI::Internal::Type::Enum
+
+              LOW: :low
+              MEDIUM: :medium
+              HIGH: :high
+
+              def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::complexity]
+            end
+
             type input_fidelity = :high | :low
 
             module InputFidelity
@@ -984,6 +1080,8 @@ module OpenAI
               | :"gpt-image-2.5-sunburst-2026-09-08"
               | :"gpt-image-2.5-flare"
               | :"gpt-image-2.5-flare-2026-09-08"
+              | :"gpt-image-2.6-sunburst"
+              | :"gpt-image-2.6-flare"
               | :"gpt-image-1.5"
               | :"chatgpt-image-latest"
 
@@ -1000,6 +1098,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"
             end
@@ -1015,7 +1115,7 @@ module OpenAI
               def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::moderation]
             end
 
-            type output_format = :png | :webp | :jpeg
+            type output_format = :png | :webp | :jpeg | :gif | :svg
 
             module OutputFormat
               extend OpenAI::Internal::Type::Enum
@@ -1023,6 +1123,8 @@ module OpenAI
               PNG: :png
               WEBP: :webp
               JPEG: :jpeg
+              GIF: :gif
+              SVG: :svg
 
               def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::output_format]
             end
@@ -1055,6 +1157,77 @@ module OpenAI
               SIZE_1536X1024: :"1536x1024"
               AUTO: :auto
             end
+
+            type svg =
+              {
+                ?model: String,
+                ?reasoning: OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning?
+              }
+
+            class Svg < OpenAI::Internal::Type::BaseModel
+              attr_reader model: String?
+
+              def model=: (String) -> String
+
+              # Reasoning effort for SVG authoring. When omitted, uses the author model's
+              # default in both Images and Responses.
+              attr_accessor reasoning: OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning?
+
+              # @param reasoning
+              #   Reasoning effort for SVG authoring. When omitted, uses the author model's
+              #   default in both Images and Responses.
+              def initialize: (
+                ?model: String,
+                ?reasoning: OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning?
+              ) -> void
+
+              def to_hash: -> {
+                ?model: String,
+                ?reasoning: OpenAI::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning?
+              }
+
+              type reasoning =
+                {
+                  ?effort: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::effort
+                }
+
+              class Reasoning < OpenAI::Internal::Type::BaseModel
+                # Controls how much effort the model should spend on reasoning for this request.
+                attr_reader effort: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::effort?
+
+                # Controls how much effort the model should spend on reasoning for this request.
+                def effort=: (
+                  OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::effort
+                ) -> OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::effort
+
+                # @param effort
+                #   Controls how much effort the model should spend on reasoning for this request.
+                def initialize: (
+                  ?effort: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::effort
+                ) -> void
+
+                def to_hash: -> {
+                  ?effort: OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::effort
+                }
+
+                type effort =
+                  :none | :minimal | :low | :medium | :high | :xhigh | :max
+
+                module Effort
+                  extend OpenAI::Internal::Type::Enum
+
+                  NONE: :none
+                  MINIMAL: :minimal
+                  LOW: :low
+                  MEDIUM: :medium
+                  HIGH: :high
+                  XHIGH: :xhigh
+                  MAX: :max
+
+                  def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::effort]
+                end
+              end
+            end
           end
 
           type local_shell = { ?type: :local_shell }

data/sig/openai/models/beta/beta_response_usage.rbs

@@ -55,7 +55,11 @@ module OpenAI
         }
 
         type input_tokens_details =
-          { cache_write_tokens: Integer, cached_tokens: Integer }
+          {
+            cache_write_tokens: Integer,
+            cached_tokens: Integer,
+            ?cache_write_tokens_details: OpenAI::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails
+          }
 
         class InputTokensDetails < OpenAI::Internal::Type::BaseModel
           # The number of input tokens that were written to the cache.
@@ -65,6 +69,12 @@ module OpenAI
           # [More on prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching).
           attr_accessor cached_tokens: Integer
 
+          attr_reader cache_write_tokens_details: OpenAI::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails?
+
+          def cache_write_tokens_details=: (
+            OpenAI::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails
+          ) -> OpenAI::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails
+
           # @param cache_write_tokens
           #   The number of input tokens that were written to the cache.
           # @param cached_tokens
@@ -72,13 +82,40 @@ module OpenAI
           #   [More on prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching).
           def initialize: (
             cache_write_tokens: Integer,
-            cached_tokens: Integer
+            cached_tokens: Integer,
+            ?cache_write_tokens_details: OpenAI::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails
           ) -> void
 
           def to_hash: -> {
             cache_write_tokens: Integer,
-            cached_tokens: Integer
+            cached_tokens: Integer,
+            ?cache_write_tokens_details: OpenAI::Beta::BetaResponseUsage::InputTokensDetails::CacheWriteTokensDetails
           }
+
+          type cache_write_tokens_details =
+            { :ttl_12h_tokens => Integer, :ttl_30m_tokens => Integer }
+
+          class CacheWriteTokensDetails < OpenAI::Internal::Type::BaseModel
+            # The number of input tokens written with 12-hour retention.
+            attr_accessor ttl_12h_tokens: Integer
+
+            # The number of input tokens written with 30-minute retention.
+            attr_accessor ttl_30m_tokens: Integer
+
+            # @param ttl_12h_tokens
+            #   The number of input tokens written with 12-hour retention.
+            # @param ttl_30m_tokens
+            #   The number of input tokens written with 30-minute retention.
+            def initialize: (
+              ttl_12h_tokens: Integer,
+              ttl_30m_tokens: Integer
+            ) -> void
+
+            def to_hash: -> {
+              :ttl_12h_tokens => Integer,
+              :ttl_30m_tokens => Integer
+            }
+          end
         end
 
         type output_tokens_details = { reasoning_tokens: Integer }

data/sig/openai/models/beta/beta_responses_client_event.rbs

@@ -19,6 +19,7 @@ module OpenAI
             ?context_management: ::Array[OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement]?,
             ?conversation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation?,
             ?generate: bool,
+            ?image: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Image,
             ?include: ::Array[OpenAI::Models::Beta::beta_response_includable]?,
             ?input: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::input,
             ?instructions: String?,
@@ -86,6 +87,14 @@ module OpenAI
           # used as previous_response_id on a later turn.
           def generate=: (bool) -> bool
 
+          # Request level image options.
+          attr_reader image: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Image?
+
+          # Request level image options.
+          def image=: (
+            OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Image
+          ) -> OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Image
+
           # Specify additional output data to include in the model response. Currently
           # supported values are:
           #
@@ -202,7 +211,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.
           attr_reader prompt_cache_options: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions?
@@ -213,7 +222,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.
           def prompt_cache_options=: (
@@ -441,6 +450,8 @@ module OpenAI
           #   Whether to generate output for this response. Defaults to true when omitted. Set
           #   to false to prepare request state without model output; the response ID can be
           #   used as previous_response_id on a later turn.
+          # @param image
+          #   Request level image options.
           # @param include
           #   Specify additional output data to include in the model response. Currently
           #   supported values are:
@@ -523,7 +534,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.
           # @param prompt_cache_retention
@@ -669,6 +680,7 @@ module OpenAI
             ?context_management: ::Array[OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement]?,
             ?conversation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation?,
             ?generate: bool,
+            ?image: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Image,
             ?include: ::Array[OpenAI::Models::Beta::beta_response_includable]?,
             ?input: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::input,
             ?instructions: String?,
@@ -709,6 +721,7 @@ module OpenAI
             ?context_management: ::Array[OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ContextManagement]?,
             ?conversation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation?,
             ?generate: bool,
+            ?image: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Image,
             ?include: ::Array[OpenAI::Models::Beta::beta_response_includable]?,
             ?input: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::input,
             ?instructions: String?,
@@ -833,6 +846,49 @@ module OpenAI
             def self?.variants: -> ::Array[OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::conversation]
           end
 
+          type image =
+            {
+              ?context_compression: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image::context_compression
+            }
+
+          class Image < OpenAI::Internal::Type::BaseModel
+            # 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.
+            attr_reader context_compression: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image::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.
+            def context_compression=: (
+              OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image::context_compression
+            ) -> OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image::context_compression
+
+            # @param 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.
+            def initialize: (
+              ?context_compression: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image::context_compression
+            ) -> void
+
+            def to_hash: -> {
+              ?context_compression: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image::context_compression
+            }
+
+            type context_compression = :auto | :enabled | :disabled
+
+            module ContextCompression
+              extend OpenAI::Internal::Type::Enum
+
+              AUTO: :auto
+              ENABLED: :enabled
+              DISABLED: :disabled
+
+              def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Image::context_compression]
+            end
+          end
+
           type input = String | OpenAI::Models::Beta::beta_response_input
 
           module Input
@@ -1268,13 +1324,13 @@ module OpenAI
             def prewarm=: (bool) -> bool
 
             # 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.
             attr_reader ttl: 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.
             def ttl=: (
               OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::ttl
             ) -> OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::ttl
@@ -1294,8 +1350,8 @@ module OpenAI
             #   set to `true`, overrides the `generate` field to `false`.
             # @param 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.
             def initialize: (
               ?comparison_response_id: String?,
               ?mode: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::mode,
@@ -1321,12 +1377,13 @@ module OpenAI
               def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::mode]
             end
 
-            type ttl = :"30m"
+            type ttl = :"30m" | :"12h"
 
             module Ttl
               extend OpenAI::Internal::Type::Enum
 
               TTL_30M: :"30m"
+              TTL_12H: :"12h"
 
               def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::ttl]
             end