openai 0.117.0 → 0.119.0

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

@@ -631,6 +631,29 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Background, nil]
           optional :background, enum: -> { OpenAI::Beta::BetaTool::ImageGeneration::Background }
 
+          # @!attribute complexity
+          #   Computation spent planning the image, independently of rendering quality.
+          #   Overrides the outer response's `reasoning.effort` for image generation. When
+          #   omitted, inherits a supported outer reasoning effort or uses the image model's
+          #   configured default. For SVG output, controls the reference image, not the SVG
+          #   author's reasoning.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Complexity, nil]
+          optional :complexity, enum: -> { OpenAI::Beta::BetaTool::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
@@ -657,8 +680,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.
@@ -679,8 +702,12 @@ module OpenAI
           optional :output_compression, Integer
 
           # @!attribute output_format
-          #   The output format of the generated image. One of `png`, `webp`, or `jpeg`.
-          #   Default: `png`.
+          #   The output format of the generated image. One of `png`, `webp`, `jpeg`, `gif`,
+          #   or `svg`. Default: `png`. GIF and SVG output require a model that supports the
+          #   selected format. GIF output does not support partial image streaming
+          #   (`partial_images` greater than `0`), `input_image_mask`, or custom
+          #   `output_compression`. Responses lifecycle events can still be streamed for GIF
+          #   output.
           #
           #   @return [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::OutputFormat, nil]
           optional :output_format, enum: -> { OpenAI::Beta::BetaTool::ImageGeneration::OutputFormat }
@@ -716,7 +743,16 @@ module OpenAI
           #   @return [String, Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Size, nil]
           optional :size, union: -> { OpenAI::Beta::BetaTool::ImageGeneration::Size }
 
-          # @!method initialize(action: nil, background: nil, input_fidelity: nil, input_image_mask: nil, model: nil, moderation: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, size: nil, type: :image_generation)
+          # @!attribute svg
+          #   SVG author model settings. Requires `output_format` to be `svg`. When SVG model
+          #   selection is enabled, omitting this object uses the outer response model.
+          #   Otherwise, the default SVG author is used and explicit model overrides are
+          #   unavailable.
+          #
+          #   @return [OpenAI::Models::Beta::BetaTool::ImageGeneration::Svg, nil]
+          optional :svg, -> { OpenAI::Beta::BetaTool::ImageGeneration::Svg }
+
+          # @!method initialize(action: nil, background: nil, complexity: nil, frame_count: nil, frame_duration_ms: nil, input_fidelity: nil, input_image_mask: nil, model: nil, moderation: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, size: nil, svg: nil, type: :image_generation)
           #   A tool that generates images using the GPT image models.
           #
           #   @param action [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Action]
@@ -733,6 +769,20 @@ module OpenAI
           #     `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
           #     set the output format to `png` or `webp`.
           #
+          #   @param complexity [Symbol, OpenAI::Models::Beta::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.
+          #
+          #   @param frame_count [Integer]
+          #     Number of GIF frames. Requires `output_format` to be `gif`. Default: 9.
+          #
+          #   @param frame_duration_ms [Integer]
+          #     Duration of each GIF frame in milliseconds, rounded to 10 ms. Requires
+          #     `output_format` to be `gif`. Default: 200.
+          #
           #   @param input_fidelity [Symbol, OpenAI::Models::Beta::BetaTool::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
@@ -747,8 +797,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.
@@ -760,8 +810,12 @@ module OpenAI
           #     Compression level for the output image. Default: 100.
           #
           #   @param output_format [Symbol, OpenAI::Models::Beta::BetaTool::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)
@@ -785,6 +839,12 @@ module OpenAI
           #     `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
           #     `auto` is supported for models that allow automatic sizing.
           #
+          #   @param svg [OpenAI::Models::Beta::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.
+          #
           #   @param type [Symbol, :image_generation]
           #     The type of the image generation tool. Always `image_generation`.
 
@@ -824,6 +884,24 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
 
+          # Computation spent planning the image, independently of rendering quality.
+          # Overrides the outer response's `reasoning.effort` for image generation. When
+          # omitted, inherits a supported outer reasoning effort or uses the image model's
+          # configured default. For SVG output, controls the reference image, not the SVG
+          # author's reasoning.
+          #
+          # @see OpenAI::Models::Beta::BetaTool::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
@@ -868,8 +946,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.
@@ -900,6 +978,10 @@ module OpenAI
               const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::GPT_IMAGE_2_5_FLARE_2026_09_08 }
             )
 
+            variant const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::GPT_IMAGE_2_6_SUNBURST }
+
+            variant const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::GPT_IMAGE_2_6_FLARE }
+
             variant const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::GPT_IMAGE_1_5 }
 
             variant const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::CHATGPT_IMAGE_LATEST }
@@ -923,6 +1005,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"
 
@@ -942,8 +1026,12 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
 
-          # The output format of the generated image. One of `png`, `webp`, or `jpeg`.
-          # Default: `png`.
+          # The output format of the generated image. One of `png`, `webp`, `jpeg`, `gif`,
+          # or `svg`. Default: `png`. GIF and SVG output require a model that supports the
+          # selected format. GIF output does not support partial image streaming
+          # (`partial_images` greater than `0`), `input_image_mask`, or custom
+          # `output_compression`. Responses lifecycle events can still be streamed for GIF
+          # output.
           #
           # @see OpenAI::Models::Beta::BetaTool::ImageGeneration#output_format
           module OutputFormat
@@ -952,6 +1040,8 @@ module OpenAI
             PNG = :png
             WEBP = :webp
             JPEG = :jpeg
+            GIF = :gif
+            SVG = :svg
 
             # @!method self.values
             #   @return [Array<Symbol>]
@@ -1018,6 +1108,67 @@ module OpenAI
 
             # @!endgroup
           end
+
+          # @see OpenAI::Models::Beta::BetaTool::ImageGeneration#svg
+          class Svg < OpenAI::Internal::Type::BaseModel
+            # @!attribute model
+            #
+            #   @return [String, nil]
+            optional :model, String
+
+            # @!attribute reasoning
+            #   Reasoning effort for SVG authoring. When omitted, uses the author model's
+            #   default in both Images and Responses.
+            #
+            #   @return [OpenAI::Models::Beta::BetaTool::ImageGeneration::Svg::Reasoning, nil]
+            optional :reasoning, -> { OpenAI::Beta::BetaTool::ImageGeneration::Svg::Reasoning }, nil?: true
+
+            # @!method initialize(model: nil, reasoning: nil)
+            #   SVG author model settings. Requires `output_format` to be `svg`. When SVG model
+            #   selection is enabled, omitting this object uses the outer response model.
+            #   Otherwise, the default SVG author is used and explicit model overrides are
+            #   unavailable.
+            #
+            #   @param model [String]
+            #
+            #   @param reasoning [OpenAI::Models::Beta::BetaTool::ImageGeneration::Svg::Reasoning, nil]
+            #     Reasoning effort for SVG authoring. When omitted, uses the author model's
+            #     default in both Images and Responses.
+
+            # @see OpenAI::Models::Beta::BetaTool::ImageGeneration::Svg#reasoning
+            class Reasoning < OpenAI::Internal::Type::BaseModel
+              # @!attribute effort
+              #   Controls how much effort the model should spend on reasoning for this request.
+              #
+              #   @return [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Svg::Reasoning::Effort, nil]
+              optional :effort, enum: -> { OpenAI::Beta::BetaTool::ImageGeneration::Svg::Reasoning::Effort }
+
+              # @!method initialize(effort: nil)
+              #   Reasoning effort for SVG authoring. When omitted, uses the author model's
+              #   default in both Images and Responses.
+              #
+              #   @param effort [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Svg::Reasoning::Effort]
+              #     Controls how much effort the model should spend on reasoning for this request.
+
+              # Controls how much effort the model should spend on reasoning for this request.
+              #
+              # @see OpenAI::Models::Beta::BetaTool::ImageGeneration::Svg::Reasoning#effort
+              module Effort
+                extend OpenAI::Internal::Type::Enum
+
+                NONE = :none
+                MINIMAL = :minimal
+                LOW = :low
+                MEDIUM = :medium
+                HIGH = :high
+                XHIGH = :xhigh
+                MAX = :max
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
         end
 
         class LocalShell < OpenAI::Internal::Type::BaseModel

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

@@ -18,6 +18,12 @@ module OpenAI
         #   @return [Symbol, String, OpenAI::Models::Beta::ResponseCompactParams::Model, nil]
         required :model, union: -> { OpenAI::Beta::ResponseCompactParams::Model }, nil?: true
 
+        # @!attribute image
+        #   Request level image options.
+        #
+        #   @return [OpenAI::Models::Beta::ResponseCompactParams::Image, nil]
+        optional :image, -> { OpenAI::Beta::ResponseCompactParams::Image }
+
         # @!attribute input
         #   Text, image, or file inputs to the model, used to generate a response
         #
@@ -55,7 +61,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.
         #
@@ -106,7 +112,7 @@ module OpenAI
         #   @return [Array<Symbol, OpenAI::Models::Beta::ResponseCompactParams::Beta>, nil]
         optional :betas, -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Beta::ResponseCompactParams::Beta] }
 
-        # @!method initialize(model:, input: nil, instructions: nil, previous_response_id: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, service_tier: nil, betas: nil, request_options: {})
+        # @!method initialize(model:, image: nil, input: nil, instructions: nil, previous_response_id: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, service_tier: nil, betas: nil, request_options: {})
         #   @param model [Symbol, String, OpenAI::Models::Beta::ResponseCompactParams::Model, nil]
         #     Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
         #     range of models with different capabilities, performance characteristics, and
@@ -114,6 +120,9 @@ module OpenAI
         #     [model guide](https://developers.openai.com/api/docs/models) to browse and
         #     compare available models.
         #
+        #   @param image [OpenAI::Models::Beta::ResponseCompactParams::Image]
+        #     Request level image options.
+        #
         #   @param input [String, Array<OpenAI::Models::Beta::BetaEasyInputMessage, OpenAI::Models::Beta::BetaResponseInputItem::Message, OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseFunctionToolCall, OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam, OpenAI::Models::Beta::BetaResponseInputItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseCompactionItemParam, OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ShellCall, OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::McpListTools, OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseInputItem::McpCall, OpenAI::Models::Beta::BetaResponseCustomToolCallOutput, OpenAI::Models::Beta::BetaResponseCustomToolCall, OpenAI::Models::Beta::BetaResponseInputItem::CompactionTrigger, OpenAI::Models::Beta::BetaResponseInputItem::ItemReference, OpenAI::Models::Beta::BetaResponseInputItem::Program, OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput>, nil]
         #     Text, image, or file inputs to the model, used to generate a response
         #
@@ -139,7 +148,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.
         #
@@ -784,6 +793,40 @@ module OpenAI
           # @!endgroup
         end
 
+        class Image < OpenAI::Internal::Type::BaseModel
+          # @!attribute context_compression
+          #   Controls image context optimization. Defaults to `auto`, which uses the model,
+          #   transport, and input to select a policy. Use `enabled` to require compression
+          #   support or `disabled` to turn it off.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::ResponseCompactParams::Image::ContextCompression, nil]
+          optional :context_compression, enum: -> { OpenAI::Beta::ResponseCompactParams::Image::ContextCompression }
+
+          # @!method initialize(context_compression: nil)
+          #   Request level image options.
+          #
+          #   @param context_compression [Symbol, OpenAI::Models::Beta::ResponseCompactParams::Image::ContextCompression]
+          #     Controls image context optimization. Defaults to `auto`, which uses the model,
+          #     transport, and input to select a policy. Use `enabled` to require compression
+          #     support or `disabled` to turn it off.
+
+          # Controls image context optimization. Defaults to `auto`, which uses the model,
+          # transport, and input to select a policy. Use `enabled` to require compression
+          # support or `disabled` to turn it off.
+          #
+          # @see OpenAI::Models::Beta::ResponseCompactParams::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
         module Input
           extend OpenAI::Internal::Type::Union
@@ -830,7 +873,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #

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

@@ -44,6 +44,12 @@ module OpenAI
         #   @return [String, OpenAI::Models::Beta::BetaResponseConversationParam, nil]
         optional :conversation, union: -> { OpenAI::Beta::ResponseCreateParams::Conversation }, nil?: true
 
+        # @!attribute image
+        #   Request level image options.
+        #
+        #   @return [OpenAI::Models::Beta::ResponseCreateParams::Image, nil]
+        optional :image, -> { OpenAI::Beta::ResponseCreateParams::Image }
+
         # @!attribute include
         #   Specify additional output data to include in the model response. Currently
         #   supported values are:
@@ -182,7 +188,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.
         #
@@ -382,7 +388,7 @@ module OpenAI
         #   @return [Array<Symbol, OpenAI::Models::Beta::ResponseCreateParams::Beta>, nil]
         optional :betas, -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Beta::ResponseCreateParams::Beta] }
 
-        # @!method initialize(access_programs: nil, background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, betas: nil, request_options: {})
+        # @!method initialize(access_programs: nil, background: nil, context_management: nil, conversation: nil, image: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, betas: nil, request_options: {})
         #   @param access_programs [OpenAI::Models::Beta::ResponseCreateParams::AccessPrograms]
         #     Domain-specific access programs to use for this request.
         #
@@ -399,6 +405,9 @@ module OpenAI
         #     items from this response are automatically added to this conversation after this
         #     response completes.
         #
+        #   @param image [OpenAI::Models::Beta::ResponseCreateParams::Image]
+        #     Request level image options.
+        #
         #   @param include [Array<Symbol, OpenAI::Models::Beta::BetaResponseIncludable>, nil]
         #     Specify additional output data to include in the model response. Currently
         #     supported values are:
@@ -494,7 +503,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.
         #
@@ -731,6 +740,40 @@ module OpenAI
           #   @return [Array(String, OpenAI::Models::Beta::BetaResponseConversationParam)]
         end
 
+        class Image < OpenAI::Internal::Type::BaseModel
+          # @!attribute context_compression
+          #   Controls image context optimization. Defaults to `auto`, which uses the model,
+          #   transport, and input to select a policy. Use `enabled` to require compression
+          #   support or `disabled` to turn it off.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::ResponseCreateParams::Image::ContextCompression, nil]
+          optional :context_compression, enum: -> { OpenAI::Beta::ResponseCreateParams::Image::ContextCompression }
+
+          # @!method initialize(context_compression: nil)
+          #   Request level image options.
+          #
+          #   @param context_compression [Symbol, OpenAI::Models::Beta::ResponseCreateParams::Image::ContextCompression]
+          #     Controls image context optimization. Defaults to `auto`, which uses the model,
+          #     transport, and input to select a policy. Use `enabled` to require compression
+          #     support or `disabled` to turn it off.
+
+          # Controls image context optimization. Defaults to `auto`, which uses the model,
+          # transport, and input to select a policy. Use `enabled` to require compression
+          # support or `disabled` to turn it off.
+          #
+          # @see OpenAI::Models::Beta::ResponseCreateParams::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:
@@ -1533,8 +1576,8 @@ module OpenAI
 
           # @!attribute ttl
           #   The minimum lifetime applied to every implicit and explicit cache breakpoint
-          #   written by the request. Defaults to `30m`, which is currently the only supported
-          #   value. The backend may retain cache entries for longer.
+          #   written by the request. Supported values are `30m` (the default) and `12h`. The
+          #   backend may retain cache entries for longer.
           #
           #   @return [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Ttl, nil]
           optional :ttl, enum: -> { OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl }
@@ -1546,7 +1589,7 @@ module OpenAI
           #   request can write up to four breakpoints. For cache matching, OpenAI considers
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
-          #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+          #   `ttl` defaults to `30m`. Supported lifetimes depend on the API. See the
           #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #
@@ -1568,8 +1611,8 @@ module OpenAI
           #
           #   @param ttl [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Ttl]
           #     The minimum lifetime applied to every implicit and explicit cache breakpoint
-          #     written by the request. Defaults to `30m`, which is currently the only supported
-          #     value. The backend may retain cache entries for longer.
+          #     written by the request. Supported values are `30m` (the default) and `12h`. The
+          #     backend may retain cache entries for longer.
 
           # Controls whether OpenAI automatically creates an implicit cache breakpoint.
           # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -1590,14 +1633,15 @@ module OpenAI
           end
 
           # The minimum lifetime applied to every implicit and explicit cache breakpoint
-          # written by the request. Defaults to `30m`, which is currently the only supported
-          # value. The backend may retain cache entries for longer.
+          # written by the request. Supported values are `30m` (the default) and `12h`. The
+          # backend may retain cache entries for longer.
           #
           # @see OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions#ttl
           module Ttl
             extend OpenAI::Internal::Type::Enum
 
             TTL_30M = :"30m"
+            TTL_12H = :"12h"
 
             # @!method self.values
             #   @return [Array<Symbol>]

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

@@ -34,6 +34,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/lib/openai/models/chat/completion_create_params.rb

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

data/lib/openai/models/conversations/conversation_item.rb

@@ -189,7 +189,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::Conversations::ConversationItem::ImageGenerationCall::SvgUsage, nil]
+          optional :svg_usage, -> { OpenAI::Conversations::ConversationItem::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]
@@ -223,6 +228,8 @@ module OpenAI
           #   @param size [String, Symbol, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Size, nil]
           #     The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
           #
+          #   @param svg_usage [OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::SvgUsage]
+          #
           #   @param type [Symbol, :image_generation_call]
           #     The type of the image generation call. Always `image_generation_call`.
 
@@ -375,6 +382,8 @@ module OpenAI
             PNG = :png
             WEBP = :webp
             JPEG = :jpeg
+            GIF = :gif
+            SVG = :svg
 
             # @!method self.values
             #   @return [Array<Symbol>]
@@ -435,6 +444,41 @@ module OpenAI
 
             # @!endgroup
           end
+
+          # @see OpenAI::Models::Conversations::ConversationItem::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 AdditionalTools < OpenAI::Internal::Type::BaseModel