openai 0.117.0 → 0.119.0

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

@@ -354,7 +354,12 @@ module OpenAI
           #   @return [String, Symbol, OpenAI::Models::Responses::ResponseItem::ImageGenerationCall::Size, nil]
           optional :size, union: -> { OpenAI::Responses::ResponseItem::ImageGenerationCall::Size }, nil?: true
 
-          # @!method initialize(id:, result:, status:, action: nil, background: nil, error: nil, output_format: nil, quality: nil, revised_prompt: nil, size: nil, type: :image_generation_call)
+          # @!attribute svg_usage
+          #
+          #   @return [OpenAI::Models::Responses::ResponseItem::ImageGenerationCall::SvgUsage, nil]
+          optional :svg_usage, -> { OpenAI::Responses::ResponseItem::ImageGenerationCall::SvgUsage }
+
+          # @!method initialize(id:, result:, status:, action: nil, background: nil, error: nil, output_format: nil, quality: nil, revised_prompt: nil, size: nil, svg_usage: nil, type: :image_generation_call)
           #   An image generation request made by the model.
           #
           #   @param id [String]
@@ -388,6 +393,8 @@ module OpenAI
           #   @param size [String, Symbol, OpenAI::Models::Responses::ResponseItem::ImageGenerationCall::Size, nil]
           #     The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
           #
+          #   @param svg_usage [OpenAI::Models::Responses::ResponseItem::ImageGenerationCall::SvgUsage]
+          #
           #   @param type [Symbol, :image_generation_call]
           #     The type of the image generation call. Always `image_generation_call`.
 
@@ -540,6 +547,8 @@ module OpenAI
             PNG = :png
             WEBP = :webp
             JPEG = :jpeg
+            GIF = :gif
+            SVG = :svg
 
             # @!method self.values
             #   @return [Array<Symbol>]
@@ -592,6 +601,41 @@ module OpenAI
 
             # @!endgroup
           end
+
+          # @see OpenAI::Models::Responses::ResponseItem::ImageGenerationCall#svg_usage
+          class SvgUsage < OpenAI::Internal::Type::BaseModel
+            # @!attribute input_tokens
+            #
+            #   @return [Integer]
+            required :input_tokens, Integer
+
+            # @!attribute model
+            #
+            #   @return [String]
+            required :model, String
+
+            # @!attribute output_tokens
+            #
+            #   @return [Integer]
+            required :output_tokens, Integer
+
+            # @!attribute reasoning_tokens
+            #
+            #   @return [Integer]
+            required :reasoning_tokens, Integer
+
+            # @!attribute total_tokens
+            #
+            #   @return [Integer]
+            required :total_tokens, Integer
+
+            # @!method initialize(input_tokens:, model:, output_tokens:, reasoning_tokens:, total_tokens:)
+            #   @param input_tokens [Integer]
+            #   @param model [String]
+            #   @param output_tokens [Integer]
+            #   @param reasoning_tokens [Integer]
+            #   @param total_tokens [Integer]
+          end
         end
 
         class LocalShellCall < OpenAI::Internal::Type::BaseModel

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

@@ -350,7 +350,12 @@ module OpenAI
             nil?: true
           )
 
-          # @!method initialize(id:, result:, status:, action: nil, background: nil, error: nil, output_format: nil, quality: nil, revised_prompt: nil, size: nil, type: :image_generation_call)
+          # @!attribute svg_usage
+          #
+          #   @return [OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall::SvgUsage, nil]
+          optional :svg_usage, -> { OpenAI::Responses::ResponseOutputItem::ImageGenerationCall::SvgUsage }
+
+          # @!method initialize(id:, result:, status:, action: nil, background: nil, error: nil, output_format: nil, quality: nil, revised_prompt: nil, size: nil, svg_usage: nil, type: :image_generation_call)
           #   An image generation request made by the model.
           #
           #   @param id [String]
@@ -384,6 +389,8 @@ module OpenAI
           #   @param size [String, Symbol, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall::Size, nil]
           #     The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
           #
+          #   @param svg_usage [OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall::SvgUsage]
+          #
           #   @param type [Symbol, :image_generation_call]
           #     The type of the image generation call. Always `image_generation_call`.
 
@@ -536,6 +543,8 @@ module OpenAI
             PNG = :png
             WEBP = :webp
             JPEG = :jpeg
+            GIF = :gif
+            SVG = :svg
 
             # @!method self.values
             #   @return [Array<Symbol>]
@@ -596,6 +605,41 @@ module OpenAI
 
             # @!endgroup
           end
+
+          # @see OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall#svg_usage
+          class SvgUsage < OpenAI::Internal::Type::BaseModel
+            # @!attribute input_tokens
+            #
+            #   @return [Integer]
+            required :input_tokens, Integer
+
+            # @!attribute model
+            #
+            #   @return [String]
+            required :model, String
+
+            # @!attribute output_tokens
+            #
+            #   @return [Integer]
+            required :output_tokens, Integer
+
+            # @!attribute reasoning_tokens
+            #
+            #   @return [Integer]
+            required :reasoning_tokens, Integer
+
+            # @!attribute total_tokens
+            #
+            #   @return [Integer]
+            required :total_tokens, Integer
+
+            # @!method initialize(input_tokens:, model:, output_tokens:, reasoning_tokens:, total_tokens:)
+            #   @param input_tokens [Integer]
+            #   @param model [String]
+            #   @param output_tokens [Integer]
+            #   @param reasoning_tokens [Integer]
+            #   @param total_tokens [Integer]
+          end
         end
 
         class LocalShellCall < OpenAI::Internal::Type::BaseModel

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

@@ -752,6 +752,32 @@ module OpenAI
               enum: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::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::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity, nil]
+            optional(
+              :complexity,
+              enum: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::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
@@ -781,8 +807,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.
@@ -809,8 +835,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::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::OutputFormat, nil]
             optional(
@@ -855,7 +885,16 @@ module OpenAI
               union: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::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::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg, nil]
+            optional :svg, -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::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::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Action]
@@ -872,6 +911,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::Responses::ResponseToolSearchOutputItemParam::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::Responses::ResponseToolSearchOutputItemParam::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
@@ -886,8 +939,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.
@@ -899,8 +952,12 @@ module OpenAI
             #     Compression level for the output image. Default: 100.
             #
             #   @param output_format [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::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)
@@ -924,6 +981,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::Responses::ResponseToolSearchOutputItemParam::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`.
 
@@ -963,6 +1026,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::Responses::ResponseToolSearchOutputItemParam::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
@@ -1007,8 +1088,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.
@@ -1067,6 +1148,18 @@ module OpenAI
                 }
               )
 
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_2_6_SUNBURST
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_2_6_FLARE
+                }
+              )
+
               variant(
                 const: -> {
                   OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_1_5
@@ -1103,6 +1196,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"
 
@@ -1122,8 +1217,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::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#output_format
             module OutputFormat
@@ -1132,6 +1231,8 @@ module OpenAI
               PNG = :png
               WEBP = :webp
               JPEG = :jpeg
+              GIF = :gif
+              SVG = :svg
 
               # @!method self.values
               #   @return [Array<Symbol>]
@@ -1219,6 +1320,78 @@ module OpenAI
 
               # @!endgroup
             end
+
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::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::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning, nil]
+              optional(
+                :reasoning,
+                -> {
+                  OpenAI::Responses::ResponseToolSearchOutputItemParam::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::Responses::ResponseToolSearchOutputItemParam::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::Responses::ResponseToolSearchOutputItemParam::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::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort, nil]
+                optional(
+                  :effort,
+                  enum: -> {
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::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::Responses::ResponseToolSearchOutputItemParam::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::Responses::ResponseToolSearchOutputItemParam::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/responses/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::Responses::ResponseUsage::InputTokensDetails::CacheWriteTokensDetails, nil]
+          optional(
+            :cache_write_tokens_details,
+            -> { OpenAI::Responses::ResponseUsage::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::Responses::ResponseUsage::InputTokensDetails::CacheWriteTokensDetails]
+
+          # @see OpenAI::Models::Responses::ResponseUsage::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::Responses::ResponseUsage#output_tokens_details

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

@@ -104,6 +104,12 @@ module OpenAI
           #   @return [Boolean, nil]
           optional :generate, OpenAI::Internal::Type::Boolean
 
+          # @!attribute image
+          #   Request level image options.
+          #
+          #   @return [OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate::Image, nil]
+          optional :image, -> { OpenAI::Responses::ResponsesClientEvent::ResponseCreate::Image }
+
           # @!attribute include
           #   Specify additional output data to include in the model response. Currently
           #   supported values are:
@@ -240,7 +246,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.
           #
@@ -471,7 +477,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, 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, 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.
@@ -503,6 +509,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::Responses::ResponsesClientEvent::ResponseCreate::Image]
+          #     Request level image options.
+          #
           #   @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>, nil]
           #     Specify additional output data to include in the model response. Currently
           #     supported values are:
@@ -595,7 +604,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.
           #
@@ -852,6 +861,44 @@ module OpenAI
             #   @return [Array(String, OpenAI::Models::Responses::ResponseConversationParam)]
           end
 
+          # @see OpenAI::Models::Responses::ResponsesClientEvent::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::Responses::ResponsesClientEvent::ResponseCreate::Image::ContextCompression, nil]
+            optional(
+              :context_compression,
+              enum: -> { OpenAI::Responses::ResponsesClientEvent::ResponseCreate::Image::ContextCompression }
+            )
+
+            # @!method initialize(context_compression: nil)
+            #   Request level image options.
+            #
+            #   @param context_compression [Symbol, OpenAI::Models::Responses::ResponsesClientEvent::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::Responses::ResponsesClientEvent::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:
@@ -1032,8 +1079,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::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl, nil]
             optional(
@@ -1048,7 +1095,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.
             #
@@ -1070,8 +1117,8 @@ module OpenAI
             #
             #   @param ttl [Symbol, OpenAI::Models::Responses::ResponsesClientEvent::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
@@ -1092,14 +1139,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::ResponsesClientEvent::ResponseCreate::PromptCacheOptions#ttl
             module Ttl
               extend OpenAI::Internal::Type::Enum
 
               TTL_30M = :"30m"
+              TTL_12H = :"12h"
 
               # @!method self.values
               #   @return [Array<Symbol>]