openai 0.117.0 → 0.119.0

data/rbi/openai/models/beta/response_compact_params.rbi

@@ -25,6 +25,13 @@ module OpenAI
         sig { returns(T.nilable(T.any(OpenAI::Beta::ResponseCompactParams::Model::OrSymbol, String))) }
         attr_accessor :model
 
+        # Request level image options.
+        sig { returns(T.nilable(OpenAI::Beta::ResponseCompactParams::Image)) }
+        attr_reader :image
+
+        sig { params(image: OpenAI::Beta::ResponseCompactParams::Image::OrHash).void }
+        attr_writer :image
+
         # Text, image, or file inputs to the model, used to generate a response
         sig { returns(T.nilable(OpenAI::Beta::ResponseCompactParams::Input::Variants)) }
         attr_accessor :input
@@ -53,7 +60,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.
         sig { returns(T.nilable(OpenAI::Beta::ResponseCompactParams::PromptCacheOptions)) }
@@ -98,6 +105,8 @@ module OpenAI
 
             model: T.nilable(T.any(OpenAI::Beta::ResponseCompactParams::Model::OrSymbol, String)),
 
+            image: OpenAI::Beta::ResponseCompactParams::Image::OrHash,
+
             input: T.nilable(OpenAI::Beta::ResponseCompactParams::Input::Variants),
 
             instructions: T.nilable(String),
@@ -127,6 +136,9 @@ module OpenAI
           # compare available models.
           model:,
 
+          # Request level image options.
+          image: nil,
+
           # Text, image, or file inputs to the model, used to generate a response
           input: nil,
 
@@ -151,7 +163,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.
           prompt_cache_options: nil,
@@ -187,6 +199,7 @@ module OpenAI
           override.returns(
             {
               model: T.nilable(T.any(OpenAI::Beta::ResponseCompactParams::Model::OrSymbol, String)),
+              image: OpenAI::Beta::ResponseCompactParams::Image,
               input: T.nilable(OpenAI::Beta::ResponseCompactParams::Input::Variants),
               instructions: T.nilable(String),
               previous_response_id: T.nilable(String),
@@ -434,6 +447,74 @@ module OpenAI
 
         end
 
+        class Image < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::ResponseCompactParams::Image,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # 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.
+          sig { returns(T.nilable(OpenAI::Beta::ResponseCompactParams::Image::ContextCompression::OrSymbol)) }
+          attr_reader :context_compression
+
+          sig {
+            params(context_compression: OpenAI::Beta::ResponseCompactParams::Image::ContextCompression::OrSymbol).void
+          }
+          attr_writer :context_compression
+
+          # Request level image options.
+          sig do
+            params(
+
+              context_compression: OpenAI::Beta::ResponseCompactParams::Image::ContextCompression::OrSymbol
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # 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.
+
+            context_compression: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {context_compression: OpenAI::Beta::ResponseCompactParams::Image::ContextCompression::OrSymbol}
+            )
+          end
+          def to_hash
+          end
+
+          # 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.
+          module ContextCompression
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias {
+              T.all(Symbol, OpenAI::Beta::ResponseCompactParams::Image::ContextCompression)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            AUTO = T.let(:auto, OpenAI::Beta::ResponseCompactParams::Image::ContextCompression::TaggedSymbol)
+            ENABLED = T.let(:enabled, OpenAI::Beta::ResponseCompactParams::Image::ContextCompression::TaggedSymbol)
+            DISABLED = T.let(:disabled, OpenAI::Beta::ResponseCompactParams::Image::ContextCompression::TaggedSymbol)
+
+            sig {
+              override.returns(T::Array[OpenAI::Beta::ResponseCompactParams::Image::ContextCompression::TaggedSymbol])
+            }
+            def self.values
+            end
+          end
+        end
+
         # Text, image, or file inputs to the model, used to generate a response
         module Input
           extend OpenAI::Internal::Type::Union
@@ -486,7 +567,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.
           sig do

data/rbi/openai/models/beta/response_create_params.rbi

@@ -40,6 +40,13 @@ module OpenAI
         sig { returns(T.nilable(T.any(String, OpenAI::Beta::BetaResponseConversationParam))) }
         attr_accessor :conversation
 
+        # Request level image options.
+        sig { returns(T.nilable(OpenAI::Beta::ResponseCreateParams::Image)) }
+        attr_reader :image
+
+        sig { params(image: OpenAI::Beta::ResponseCreateParams::Image::OrHash).void }
+        attr_writer :image
+
         # Specify additional output data to include in the model response. Currently
         # supported values are:
         #
@@ -162,7 +169,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.
         sig { returns(T.nilable(OpenAI::Beta::ResponseCreateParams::PromptCacheOptions)) }
@@ -436,6 +443,8 @@ module OpenAI
 
             conversation: T.nilable(T.any(String, OpenAI::Beta::BetaResponseConversationParam::OrHash)),
 
+            image: OpenAI::Beta::ResponseCreateParams::Image::OrHash,
+
             include: T.nilable(T::Array[OpenAI::Beta::BetaResponseIncludable::OrSymbol]),
 
             input: OpenAI::Beta::ResponseCreateParams::Input::Variants,
@@ -545,6 +554,9 @@ module OpenAI
           # response completes.
           conversation: nil,
 
+          # Request level image options.
+          image: nil,
+
           # Specify additional output data to include in the model response. Currently
           # supported values are:
           #
@@ -639,7 +651,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.
           prompt_cache_options: nil,
@@ -793,6 +805,7 @@ module OpenAI
               background: T.nilable(T::Boolean),
               context_management: T.nilable(T::Array[OpenAI::Beta::ResponseCreateParams::ContextManagement]),
               conversation: T.nilable(T.any(String, OpenAI::Beta::BetaResponseConversationParam)),
+              image: OpenAI::Beta::ResponseCreateParams::Image,
               include: T.nilable(T::Array[OpenAI::Beta::BetaResponseIncludable::OrSymbol]),
               input: OpenAI::Beta::ResponseCreateParams::Input::Variants,
               instructions: T.nilable(String),
@@ -1005,6 +1018,74 @@ module OpenAI
 
         end
 
+        class Image < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::ResponseCreateParams::Image,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # 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.
+          sig { returns(T.nilable(OpenAI::Beta::ResponseCreateParams::Image::ContextCompression::OrSymbol)) }
+          attr_reader :context_compression
+
+          sig {
+            params(context_compression: OpenAI::Beta::ResponseCreateParams::Image::ContextCompression::OrSymbol).void
+          }
+          attr_writer :context_compression
+
+          # Request level image options.
+          sig do
+            params(
+
+              context_compression: OpenAI::Beta::ResponseCreateParams::Image::ContextCompression::OrSymbol
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # 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.
+
+            context_compression: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {context_compression: OpenAI::Beta::ResponseCreateParams::Image::ContextCompression::OrSymbol}
+            )
+          end
+          def to_hash
+          end
+
+          # 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.
+          module ContextCompression
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias {
+              T.all(Symbol, OpenAI::Beta::ResponseCreateParams::Image::ContextCompression)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            AUTO = T.let(:auto, OpenAI::Beta::ResponseCreateParams::Image::ContextCompression::TaggedSymbol)
+            ENABLED = T.let(:enabled, OpenAI::Beta::ResponseCreateParams::Image::ContextCompression::TaggedSymbol)
+            DISABLED = T.let(:disabled, OpenAI::Beta::ResponseCreateParams::Image::ContextCompression::TaggedSymbol)
+
+            sig {
+              override.returns(T::Array[OpenAI::Beta::ResponseCreateParams::Image::ContextCompression::TaggedSymbol])
+            }
+            def self.values
+            end
+          end
+        end
+
         # Text, image, or file inputs to the model, used to generate a response.
         #
         # Learn more:
@@ -1563,8 +1644,8 @@ module OpenAI
           attr_writer :prewarm
 
           # 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.
           sig { returns(T.nilable(OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl::OrSymbol)) }
           attr_reader :ttl
 
@@ -1577,7 +1658,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.
           sig do
@@ -1612,8 +1693,8 @@ module OpenAI
             prewarm: nil,
 
             # 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.
 
             ttl: nil
           )
@@ -1655,8 +1736,8 @@ 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.
           module Ttl
             extend OpenAI::Internal::Type::Enum
 
@@ -1664,6 +1745,7 @@ module OpenAI
             OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             TTL_30M = T.let(:"30m", OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl::TaggedSymbol)
+            TTL_12H = T.let(:"12h", OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl::TaggedSymbol)
 
             sig {
               override.returns(T::Array[OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl::TaggedSymbol])

data/rbi/openai/models/beta/session_turn_error.rbi

@@ -61,6 +61,9 @@ module OpenAI
           # The request exceeds the model's context window.
           CONTEXT_LENGTH_EXCEEDED = T.let(:context_length_exceeded, OpenAI::Beta::SessionTurnError::Code::TaggedSymbol)
 
+          # The model reached its output token limit before finishing the response.
+          MAX_OUTPUT_TOKENS = T.let(:max_output_tokens, OpenAI::Beta::SessionTurnError::Code::TaggedSymbol)
+
           # The session has reached its usage budget.
           SESSION_BUDGET_EXCEEDED = T.let(:session_budget_exceeded, OpenAI::Beta::SessionTurnError::Code::TaggedSymbol)
 

data/rbi/openai/models/chat/completion_create_params.rbi

@@ -214,7 +214,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.
         sig { returns(T.nilable(OpenAI::Chat::CompletionCreateParams::PromptCacheOptions)) }
@@ -704,7 +704,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.
           prompt_cache_options: nil,
@@ -1359,7 +1359,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.
           sig do

data/rbi/openai/models/conversations/conversation_item.rbi

@@ -111,6 +111,14 @@ module OpenAI
           sig { returns(T.nilable(OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::Variants)) }
           attr_accessor :size
 
+          sig { returns(T.nilable(OpenAI::Conversations::ConversationItem::ImageGenerationCall::SvgUsage)) }
+          attr_reader :svg_usage
+
+          sig {
+            params(svg_usage: OpenAI::Conversations::ConversationItem::ImageGenerationCall::SvgUsage::OrHash).void
+          }
+          attr_writer :svg_usage
+
           # An image generation request made by the model.
           sig do
             params(
@@ -139,6 +147,8 @@ module OpenAI
                 T.any(String, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::OrSymbol)
               ),
 
+              svg_usage: OpenAI::Conversations::ConversationItem::ImageGenerationCall::SvgUsage::OrHash,
+
               type: Symbol
             )
               .returns(T.attached_class)
@@ -176,6 +186,8 @@ module OpenAI
             # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
             size: nil,
 
+            svg_usage: nil,
+
             # The type of the image generation call. Always `image_generation_call`.
 
             type: :image_generation_call
@@ -199,7 +211,8 @@ module OpenAI
                 ),
                 quality: T.nilable(OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality::TaggedSymbol),
                 revised_prompt: T.nilable(String),
-                size: T.nilable(OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::Variants)
+                size: T.nilable(OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::Variants),
+                svg_usage: OpenAI::Conversations::ConversationItem::ImageGenerationCall::SvgUsage
               }
             )
           end
@@ -487,6 +500,8 @@ module OpenAI
               :jpeg,
               OpenAI::Conversations::ConversationItem::ImageGenerationCall::OutputFormat::TaggedSymbol
             )
+            GIF = T.let(:gif, OpenAI::Conversations::ConversationItem::ImageGenerationCall::OutputFormat::TaggedSymbol)
+            SVG = T.let(:svg, OpenAI::Conversations::ConversationItem::ImageGenerationCall::OutputFormat::TaggedSymbol)
 
             sig {
               override.returns(
@@ -557,6 +572,74 @@ module OpenAI
             )
 
           end
+
+          class SvgUsage < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Conversations::ConversationItem::ImageGenerationCall::SvgUsage,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            sig { returns(Integer) }
+            attr_accessor :input_tokens
+
+            sig { returns(String) }
+            attr_accessor :model
+
+            sig { returns(Integer) }
+            attr_accessor :output_tokens
+
+            sig { returns(Integer) }
+            attr_accessor :reasoning_tokens
+
+            sig { returns(Integer) }
+            attr_accessor :total_tokens
+
+            sig do
+              params(
+
+                input_tokens: Integer,
+
+                model: String,
+
+                output_tokens: Integer,
+
+                reasoning_tokens: Integer,
+
+                total_tokens: Integer
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              input_tokens:,
+
+              model:,
+
+              output_tokens:,
+
+              reasoning_tokens:,
+
+              total_tokens:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  input_tokens: Integer,
+                  model: String,
+                  output_tokens: Integer,
+                  reasoning_tokens: Integer,
+                  total_tokens: Integer
+                }
+              )
+            end
+            def to_hash
+            end
+
+          end
         end
 
         class AdditionalTools < OpenAI::Internal::Type::BaseModel

data/rbi/openai/models/image_edit_params.rbi

@@ -47,6 +47,26 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageEditParams::Background::OrSymbol)) }
       attr_accessor :background
 
+      # Computation spent planning the image, independently of rendering quality. Uses
+      # the image model's configured default when omitted. For SVG output, controls the
+      # reference image, independently of the SVG author's reasoning.
+      sig { returns(T.nilable(OpenAI::ImageEditParams::Complexity::OrSymbol)) }
+      attr_accessor :complexity
+
+      # Number of frames for GIF output. Accepts integers from 2 through 16. Defaults to
+      # 9 when omitted. Only supported with output_format=gif. The requested size must
+      # satisfy the selected model's GIF size limits. GIF output does not support
+      # streaming, partial images, masks, or custom output compression. Requires access
+      # to the GIF preview for the selected model.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :frame_count
+
+      # Requested delay per GIF frame, in milliseconds. Defaults to 200 when omitted.
+      # GIF output rounds to the nearest 10 ms and caps the encoded delay at 655,350 ms
+      # per frame. Only supported with output_format=gif.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :frame_duration_ms
+
       # 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
@@ -56,7 +76,7 @@ module OpenAI
 
       # A transparent PNG overlaid on the first image to guide the edit. Must match that
       # image's dimensions after orientation and contain transparent pixels. Supports
-      # GPT Image 2.5 and 2.6. Cannot be combined with mask.
+      # GPT Image 2.5. Cannot be combined with mask.
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -84,8 +104,8 @@ module OpenAI
       # The GPT image model to use for image editing (`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`).
+      # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`,
+      # `gpt-image-2.6-sunburst`, `gpt-image-2.6-flare`, or `chatgpt-image-latest`).
       #
       # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
       # `gpt-image-2.5-flare` instead.
@@ -103,8 +123,7 @@ module OpenAI
       attr_accessor :output_compression
 
       # The format in which the generated images are returned. This parameter is only
-      # supported for the GPT image models. Must be one of `png`, `jpeg`, or `webp`. The
-      # default value is `png`.
+      # supported for the GPT image models. The default value is `png`.
       sig { returns(T.nilable(OpenAI::ImageEditParams::OutputFormat::OrSymbol)) }
       attr_accessor :output_format
 
@@ -171,6 +190,12 @@ module OpenAI
 
           background: T.nilable(OpenAI::ImageEditParams::Background::OrSymbol),
 
+          complexity: T.nilable(OpenAI::ImageEditParams::Complexity::OrSymbol),
+
+          frame_count: T.nilable(Integer),
+
+          frame_duration_ms: T.nilable(Integer),
+
           input_fidelity: T.nilable(OpenAI::ImageEditParams::InputFidelity::OrSymbol),
 
           markup: OpenAI::Internal::FileInput,
@@ -232,6 +257,23 @@ module OpenAI
         # set the output format to `png` or `webp`.
         background: nil,
 
+        # Computation spent planning the image, independently of rendering quality. Uses
+        # the image model's configured default when omitted. For SVG output, controls the
+        # reference image, independently of the SVG author's reasoning.
+        complexity: nil,
+
+        # Number of frames for GIF output. Accepts integers from 2 through 16. Defaults to
+        # 9 when omitted. Only supported with output_format=gif. The requested size must
+        # satisfy the selected model's GIF size limits. GIF output does not support
+        # streaming, partial images, masks, or custom output compression. Requires access
+        # to the GIF preview for the selected model.
+        frame_count: nil,
+
+        # Requested delay per GIF frame, in milliseconds. Defaults to 200 when omitted.
+        # GIF output rounds to the nearest 10 ms and caps the encoded delay at 655,350 ms
+        # per frame. Only supported with output_format=gif.
+        frame_duration_ms: 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
         # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
@@ -240,7 +282,7 @@ module OpenAI
 
         # A transparent PNG overlaid on the first image to guide the edit. Must match that
         # image's dimensions after orientation and contain transparent pixels. Supports
-        # GPT Image 2.5 and 2.6. Cannot be combined with mask.
+        # GPT Image 2.5. Cannot be combined with mask.
         #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -260,8 +302,8 @@ module OpenAI
         # The GPT image model to use for image editing (`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`).
+        # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`,
+        # `gpt-image-2.6-sunburst`, `gpt-image-2.6-flare`, or `chatgpt-image-latest`).
         #
         # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
         # `gpt-image-2.5-flare` instead.
@@ -276,8 +318,7 @@ module OpenAI
         output_compression: nil,
 
         # The format in which the generated images are returned. This parameter is only
-        # supported for the GPT image models. Must be one of `png`, `jpeg`, or `webp`. The
-        # default value is `png`.
+        # supported for the GPT image models. The default value is `png`.
         output_format: nil,
 
         # The number of partial images to generate. This parameter is used for streaming
@@ -335,6 +376,9 @@ module OpenAI
             image: OpenAI::ImageEditParams::Image::Variants,
             prompt: String,
             background: T.nilable(OpenAI::ImageEditParams::Background::OrSymbol),
+            complexity: T.nilable(OpenAI::ImageEditParams::Complexity::OrSymbol),
+            frame_count: T.nilable(Integer),
+            frame_duration_ms: T.nilable(Integer),
             input_fidelity: T.nilable(OpenAI::ImageEditParams::InputFidelity::OrSymbol),
             markup: OpenAI::Internal::FileInput,
             mask: OpenAI::Internal::FileInput,
@@ -403,6 +447,24 @@ module OpenAI
         end
       end
 
+      # Computation spent planning the image, independently of rendering quality. Uses
+      # the image model's configured default when omitted. For SVG output, controls the
+      # reference image, independently of the SVG author's reasoning.
+      module Complexity
+        extend OpenAI::Internal::Type::Enum
+
+        TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::ImageEditParams::Complexity) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        LOW = T.let(:low, OpenAI::ImageEditParams::Complexity::TaggedSymbol)
+        MEDIUM = T.let(:medium, OpenAI::ImageEditParams::Complexity::TaggedSymbol)
+        HIGH = T.let(:high, OpenAI::ImageEditParams::Complexity::TaggedSymbol)
+
+        sig { override.returns(T::Array[OpenAI::ImageEditParams::Complexity::TaggedSymbol]) }
+        def self.values
+        end
+      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
@@ -424,8 +486,8 @@ module OpenAI
       # The GPT image model to use for image editing (`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`).
+      # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`,
+      # `gpt-image-2.6-sunburst`, `gpt-image-2.6-flare`, or `chatgpt-image-latest`).
       #
       # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
       # `gpt-image-2.5-flare` instead.
@@ -441,8 +503,7 @@ module OpenAI
       end
 
       # The format in which the generated images are returned. This parameter is only
-      # supported for the GPT image models. Must be one of `png`, `jpeg`, or `webp`. The
-      # default value is `png`.
+      # supported for the GPT image models. The default value is `png`.
       module OutputFormat
         extend OpenAI::Internal::Type::Enum
 
@@ -452,6 +513,7 @@ module OpenAI
         PNG = T.let(:png, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
         JPEG = T.let(:jpeg, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
         WEBP = T.let(:webp, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
+        GIF = T.let(:gif, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
 
         sig { override.returns(T::Array[OpenAI::ImageEditParams::OutputFormat::TaggedSymbol]) }
         def self.values