openai 0.117.0 → 0.119.0

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

@@ -596,6 +596,9 @@ module OpenAI
             ?type: :image_generation,
             ?action: OpenAI::Models::Beta::BetaTool::ImageGeneration::action,
             ?background: OpenAI::Models::Beta::BetaTool::ImageGeneration::background,
+            ?complexity: OpenAI::Models::Beta::BetaTool::ImageGeneration::complexity,
+            ?frame_count: Integer,
+            ?frame_duration_ms: Integer,
             ?input_fidelity: OpenAI::Models::Beta::BetaTool::ImageGeneration::input_fidelity?,
             ?input_image_mask: OpenAI::Beta::BetaTool::ImageGeneration::InputImageMask,
             ?model: OpenAI::Models::Beta::BetaTool::ImageGeneration::model,
@@ -604,7 +607,8 @@ module OpenAI
             ?output_format: OpenAI::Models::Beta::BetaTool::ImageGeneration::output_format,
             ?partial_images: Integer,
             ?quality: OpenAI::Models::Beta::BetaTool::ImageGeneration::quality,
-            ?size: OpenAI::Models::Beta::BetaTool::ImageGeneration::size
+            ?size: OpenAI::Models::Beta::BetaTool::ImageGeneration::size,
+            ?svg: OpenAI::Beta::BetaTool::ImageGeneration::Svg
           }
 
         class ImageGeneration < OpenAI::Internal::Type::BaseModel
@@ -643,6 +647,36 @@ module OpenAI
             OpenAI::Models::Beta::BetaTool::ImageGeneration::background
           ) -> OpenAI::Models::Beta::BetaTool::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::BetaTool::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::BetaTool::ImageGeneration::complexity
+          ) -> OpenAI::Models::Beta::BetaTool::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
@@ -662,8 +696,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.
@@ -672,8 +706,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.
@@ -695,12 +729,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::BetaTool::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::BetaTool::ImageGeneration::output_format
           ) -> OpenAI::Models::Beta::BetaTool::ImageGeneration::output_format
@@ -753,6 +795,20 @@ module OpenAI
             OpenAI::Models::Beta::BetaTool::ImageGeneration::size
           ) -> OpenAI::Models::Beta::BetaTool::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::BetaTool::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::BetaTool::ImageGeneration::Svg
+          ) -> OpenAI::Beta::BetaTool::ImageGeneration::Svg
+
           # @param action
           #   Whether to generate a new image or edit an existing image. Default: `auto`.
           # @param background
@@ -765,6 +821,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
@@ -777,8 +844,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.
@@ -787,8 +854,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.
@@ -808,11 +879,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::BetaTool::ImageGeneration::action,
             ?background: OpenAI::Models::Beta::BetaTool::ImageGeneration::background,
+            ?complexity: OpenAI::Models::Beta::BetaTool::ImageGeneration::complexity,
+            ?frame_count: Integer,
+            ?frame_duration_ms: Integer,
             ?input_fidelity: OpenAI::Models::Beta::BetaTool::ImageGeneration::input_fidelity?,
             ?input_image_mask: OpenAI::Beta::BetaTool::ImageGeneration::InputImageMask,
             ?model: OpenAI::Models::Beta::BetaTool::ImageGeneration::model,
@@ -822,6 +901,7 @@ module OpenAI
             ?partial_images: Integer,
             ?quality: OpenAI::Models::Beta::BetaTool::ImageGeneration::quality,
             ?size: OpenAI::Models::Beta::BetaTool::ImageGeneration::size,
+            ?svg: OpenAI::Beta::BetaTool::ImageGeneration::Svg,
             ?type: :image_generation
           ) -> void
 
@@ -829,6 +909,9 @@ module OpenAI
             ?type: :image_generation,
             ?action: OpenAI::Models::Beta::BetaTool::ImageGeneration::action,
             ?background: OpenAI::Models::Beta::BetaTool::ImageGeneration::background,
+            ?complexity: OpenAI::Models::Beta::BetaTool::ImageGeneration::complexity,
+            ?frame_count: Integer,
+            ?frame_duration_ms: Integer,
             ?input_fidelity: OpenAI::Models::Beta::BetaTool::ImageGeneration::input_fidelity?,
             ?input_image_mask: OpenAI::Beta::BetaTool::ImageGeneration::InputImageMask,
             ?model: OpenAI::Models::Beta::BetaTool::ImageGeneration::model,
@@ -837,7 +920,8 @@ module OpenAI
             ?output_format: OpenAI::Models::Beta::BetaTool::ImageGeneration::output_format,
             ?partial_images: Integer,
             ?quality: OpenAI::Models::Beta::BetaTool::ImageGeneration::quality,
-            ?size: OpenAI::Models::Beta::BetaTool::ImageGeneration::size
+            ?size: OpenAI::Models::Beta::BetaTool::ImageGeneration::size,
+            ?svg: OpenAI::Beta::BetaTool::ImageGeneration::Svg
           }
 
           type action = :generate | :edit | :auto
@@ -864,6 +948,18 @@ module OpenAI
             def self?.values: -> ::Array[OpenAI::Models::Beta::BetaTool::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::BetaTool::ImageGeneration::complexity]
+          end
+
           type input_fidelity = :high | :low
 
           module InputFidelity
@@ -909,6 +1005,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"
 
@@ -925,6 +1023,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
@@ -940,7 +1040,7 @@ module OpenAI
             def self?.values: -> ::Array[OpenAI::Models::Beta::BetaTool::ImageGeneration::moderation]
           end
 
-          type output_format = :png | :webp | :jpeg
+          type output_format = :png | :webp | :jpeg | :gif | :svg
 
           module OutputFormat
             extend OpenAI::Internal::Type::Enum
@@ -948,6 +1048,8 @@ module OpenAI
             PNG: :png
             WEBP: :webp
             JPEG: :jpeg
+            GIF: :gif
+            SVG: :svg
 
             def self?.values: -> ::Array[OpenAI::Models::Beta::BetaTool::ImageGeneration::output_format]
           end
@@ -980,6 +1082,77 @@ module OpenAI
             SIZE_1536X1024: :"1536x1024"
             AUTO: :auto
           end
+
+          type svg =
+            {
+              ?model: String,
+              ?reasoning: OpenAI::Beta::BetaTool::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::BetaTool::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::BetaTool::ImageGeneration::Svg::Reasoning?
+            ) -> void
+
+            def to_hash: -> {
+              ?model: String,
+              ?reasoning: OpenAI::Beta::BetaTool::ImageGeneration::Svg::Reasoning?
+            }
+
+            type reasoning =
+              {
+                ?effort: OpenAI::Models::Beta::BetaTool::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::BetaTool::ImageGeneration::Svg::Reasoning::effort?
+
+              # Controls how much effort the model should spend on reasoning for this request.
+              def effort=: (
+                OpenAI::Models::Beta::BetaTool::ImageGeneration::Svg::Reasoning::effort
+              ) -> OpenAI::Models::Beta::BetaTool::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::BetaTool::ImageGeneration::Svg::Reasoning::effort
+              ) -> void
+
+              def to_hash: -> {
+                ?effort: OpenAI::Models::Beta::BetaTool::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::BetaTool::ImageGeneration::Svg::Reasoning::effort]
+              end
+            end
+          end
         end
 
         type local_shell = { ?type: :local_shell }

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

@@ -4,6 +4,7 @@ module OpenAI
       type response_compact_params =
         {
           model: OpenAI::Models::Beta::ResponseCompactParams::model?,
+          ?image: OpenAI::Beta::ResponseCompactParams::Image,
           ?input: OpenAI::Models::Beta::ResponseCompactParams::input?,
           ?instructions: String?,
           ?previous_response_id: String?,
@@ -26,6 +27,14 @@ module OpenAI
         # compare available models.
         attr_accessor model: OpenAI::Models::Beta::ResponseCompactParams::model?
 
+        # Request level image options.
+        attr_reader image: OpenAI::Beta::ResponseCompactParams::Image?
+
+        # Request level image options.
+        def image=: (
+          OpenAI::Beta::ResponseCompactParams::Image
+        ) -> OpenAI::Beta::ResponseCompactParams::Image
+
         # Text, image, or file inputs to the model, used to generate a response
         attr_accessor input: OpenAI::Models::Beta::ResponseCompactParams::input?
 
@@ -50,7 +59,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_accessor prompt_cache_options: OpenAI::Beta::ResponseCompactParams::PromptCacheOptions?
@@ -88,6 +97,8 @@ module OpenAI
         #   price points. Refer to the
         #   [model guide](https://developers.openai.com/api/docs/models) to browse and
         #   compare available models.
+        # @param image
+        #   Request level image options.
         # @param input
         #   Text, image, or file inputs to the model, used to generate a response
         # @param instructions
@@ -109,7 +120,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
@@ -133,6 +144,7 @@ module OpenAI
         #   the parameter.
         def initialize: (
           model: OpenAI::Models::Beta::ResponseCompactParams::model?,
+          ?image: OpenAI::Beta::ResponseCompactParams::Image,
           ?input: OpenAI::Models::Beta::ResponseCompactParams::input?,
           ?instructions: String?,
           ?previous_response_id: String?,
@@ -146,6 +158,7 @@ module OpenAI
 
         def to_hash: -> {
           model: OpenAI::Models::Beta::ResponseCompactParams::model?,
+          ?image: OpenAI::Beta::ResponseCompactParams::Image,
           ?input: OpenAI::Models::Beta::ResponseCompactParams::input?,
           ?instructions: String?,
           ?previous_response_id: String?,
@@ -387,6 +400,49 @@ module OpenAI
           GPT_ROSALIND_RESEARCH: :"gpt-rosalind-research"
         end
 
+        type image =
+          {
+            ?context_compression: OpenAI::Models::Beta::ResponseCompactParams::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::ResponseCompactParams::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::ResponseCompactParams::Image::context_compression
+          ) -> OpenAI::Models::Beta::ResponseCompactParams::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::ResponseCompactParams::Image::context_compression
+          ) -> void
+
+          def to_hash: -> {
+            ?context_compression: OpenAI::Models::Beta::ResponseCompactParams::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::ResponseCompactParams::Image::context_compression]
+          end
+        end
+
         type input =
           String | ::Array[OpenAI::Models::Beta::beta_response_input_item]
 

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

@@ -7,6 +7,7 @@ module OpenAI
           ?background: bool?,
           ?context_management: ::Array[OpenAI::Beta::ResponseCreateParams::ContextManagement]?,
           ?conversation: OpenAI::Models::Beta::ResponseCreateParams::conversation?,
+          ?image: OpenAI::Beta::ResponseCreateParams::Image,
           ?include: ::Array[OpenAI::Models::Beta::beta_response_includable]?,
           ?input: OpenAI::Models::Beta::ResponseCreateParams::input,
           ?instructions: String?,
@@ -64,6 +65,14 @@ module OpenAI
         # response completes.
         attr_accessor conversation: OpenAI::Models::Beta::ResponseCreateParams::conversation?
 
+        # Request level image options.
+        attr_reader image: OpenAI::Beta::ResponseCreateParams::Image?
+
+        # Request level image options.
+        def image=: (
+          OpenAI::Beta::ResponseCreateParams::Image
+        ) -> OpenAI::Beta::ResponseCreateParams::Image
+
         # Specify additional output data to include in the model response. Currently
         # supported values are:
         #
@@ -180,7 +189,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::ResponseCreateParams::PromptCacheOptions?
@@ -191,7 +200,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=: (
@@ -401,6 +410,8 @@ module OpenAI
         #   prepended to `input_items` for this response request. Input items and output
         #   items from this response are automatically added to this conversation after this
         #   response completes.
+        # @param image
+        #   Request level image options.
         # @param include
         #   Specify additional output data to include in the model response. Currently
         #   supported values are:
@@ -483,7 +494,7 @@ module OpenAI
         #   request can write up to four breakpoints. For cache matching, OpenAI considers
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-        #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
         #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         # @param prompt_cache_retention
@@ -613,6 +624,7 @@ module OpenAI
           ?background: bool?,
           ?context_management: ::Array[OpenAI::Beta::ResponseCreateParams::ContextManagement]?,
           ?conversation: OpenAI::Models::Beta::ResponseCreateParams::conversation?,
+          ?image: OpenAI::Beta::ResponseCreateParams::Image,
           ?include: ::Array[OpenAI::Models::Beta::beta_response_includable]?,
           ?input: OpenAI::Models::Beta::ResponseCreateParams::input,
           ?instructions: String?,
@@ -651,6 +663,7 @@ module OpenAI
           ?background: bool?,
           ?context_management: ::Array[OpenAI::Beta::ResponseCreateParams::ContextManagement]?,
           ?conversation: OpenAI::Models::Beta::ResponseCreateParams::conversation?,
+          ?image: OpenAI::Beta::ResponseCreateParams::Image,
           ?include: ::Array[OpenAI::Models::Beta::beta_response_includable]?,
           ?input: OpenAI::Models::Beta::ResponseCreateParams::input,
           ?instructions: String?,
@@ -773,6 +786,49 @@ module OpenAI
           def self?.variants: -> ::Array[OpenAI::Models::Beta::ResponseCreateParams::conversation]
         end
 
+        type image =
+          {
+            ?context_compression: OpenAI::Models::Beta::ResponseCreateParams::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::ResponseCreateParams::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::ResponseCreateParams::Image::context_compression
+          ) -> OpenAI::Models::Beta::ResponseCreateParams::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::ResponseCreateParams::Image::context_compression
+          ) -> void
+
+          def to_hash: -> {
+            ?context_compression: OpenAI::Models::Beta::ResponseCreateParams::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::ResponseCreateParams::Image::context_compression]
+          end
+        end
+
         type input = String | OpenAI::Models::Beta::beta_response_input
 
         module Input
@@ -1204,13 +1260,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::ResponseCreateParams::PromptCacheOptions::ttl?
 
           # The minimum lifetime applied to every implicit and explicit cache breakpoint
-          # written by the request. Defaults to `30m`, which is currently the only supported
-          # value. The backend may retain cache entries for longer.
+          # written by the request. Supported values are `30m` (the default) and `12h`. The
+          # backend may retain cache entries for longer.
           def ttl=: (
             OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::ttl
           ) -> OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::ttl
@@ -1230,8 +1286,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::ResponseCreateParams::PromptCacheOptions::mode,
@@ -1257,12 +1313,13 @@ module OpenAI
             def self?.values: -> ::Array[OpenAI::Models::Beta::ResponseCreateParams::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::ResponseCreateParams::PromptCacheOptions::ttl]
           end

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

@@ -27,6 +27,7 @@ module OpenAI
 
         type code =
           :context_length_exceeded
+          | :max_output_tokens
           | :session_budget_exceeded
           | :usage_limit_exceeded
           | :project_spend_limit_exceeded
@@ -56,6 +57,9 @@ module OpenAI
           # The request exceeds the model's context window.
           CONTEXT_LENGTH_EXCEEDED: :context_length_exceeded
 
+          # The model reached its output token limit before finishing the response.
+          MAX_OUTPUT_TOKENS: :max_output_tokens
+
           # The session has reached its usage budget.
           SESSION_BUDGET_EXCEEDED: :session_budget_exceeded
 

data/sig/openai/models/chat/completion_create_params.rbs

@@ -207,7 +207,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::Chat::CompletionCreateParams::PromptCacheOptions?
@@ -218,7 +218,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=: (
@@ -537,7 +537,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