openai 0.123.0 → 0.124.0

data/rbi/openai/models/beta/responses/input_token_count_params.rbi

@@ -139,11 +139,15 @@ module OpenAI
           }
           attr_accessor :tools
 
-          # The truncation strategy to use for the model response. - `auto`: If the input to
-          # this Response exceeds the model's context window size, the model will truncate
-          # the response to fit the context window by dropping items from the beginning of
-          # the conversation. - `disabled` (default): If the input size will exceed the
-          # context window size for a model, the request will fail with a 400 error.
+          # The truncation strategy to use for the model response.
+          #
+          # - `auto`: If the input to this Response exceeds the model's context window size,
+          #   the model will truncate the response to fit the context window by dropping
+          #   items from the beginning of the conversation. On some models, trimming can
+          #   begin earlier because the API subtracts the model's maximum output allowance
+          #   from its input limit before counting tokens.
+          # - `disabled` (default): If the input size will exceed the context window size
+          #   for a model, the request will fail with a 400 error.
           sig { returns(T.nilable(OpenAI::Beta::Responses::InputTokenCountParams::Truncation::OrSymbol)) }
           attr_reader :truncation
 
@@ -278,11 +282,15 @@ module OpenAI
             # specify which tool to use by setting the `tool_choice` parameter.
             tools: nil,
 
-            # The truncation strategy to use for the model response. - `auto`: If the input to
-            # this Response exceeds the model's context window size, the model will truncate
-            # the response to fit the context window by dropping items from the beginning of
-            # the conversation. - `disabled` (default): If the input size will exceed the
-            # context window size for a model, the request will fail with a 400 error.
+            # The truncation strategy to use for the model response.
+            #
+            # - `auto`: If the input to this Response exceeds the model's context window size,
+            #   the model will truncate the response to fit the context window by dropping
+            #   items from the beginning of the conversation. On some models, trimming can
+            #   begin earlier because the API subtracts the model's maximum output allowance
+            #   from its input limit before counting tokens.
+            # - `disabled` (default): If the input size will exceed the context window size
+            #   for a model, the request will fail with a 400 error.
             truncation: nil,
 
             betas: nil,
@@ -900,11 +908,15 @@ module OpenAI
 
           end
 
-          # The truncation strategy to use for the model response. - `auto`: If the input to
-          # this Response exceeds the model's context window size, the model will truncate
-          # the response to fit the context window by dropping items from the beginning of
-          # the conversation. - `disabled` (default): If the input size will exceed the
-          # context window size for a model, the request will fail with a 400 error.
+          # The truncation strategy to use for the model response.
+          #
+          # - `auto`: If the input to this Response exceeds the model's context window size,
+          #   the model will truncate the response to fit the context window by dropping
+          #   items from the beginning of the conversation. On some models, trimming can
+          #   begin earlier because the API subtracts the model's maximum output allowance
+          #   from its input limit before counting tokens.
+          # - `disabled` (default): If the input size will exceed the context window size
+          #   for a model, the request will fail with a 400 error.
           module Truncation
             extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/content_provenance_check_create_params.rbi

@@ -16,6 +16,7 @@ module OpenAI
       end
 
       # The image or audio file to check for supported OpenAI provenance signals.
+      # Supported image formats are PNG, JPEG, WebP, and GIF (including animated GIFs).
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -35,6 +36,7 @@ module OpenAI
       def self.new(
 
         # The image or audio file to check for supported OpenAI provenance signals.
+        # Supported image formats are PNG, JPEG, WebP, and GIF (including animated GIFs).
         #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or

data/rbi/openai/models/image_edit_params.rbi

@@ -123,7 +123,8 @@ 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. The default value is `png`.
+      # supported for the GPT image models. The default value is `png`. SVG output
+      # requires a supported image model and project access.
       sig { returns(T.nilable(OpenAI::ImageEditParams::OutputFormat::OrSymbol)) }
       attr_accessor :output_format
 
@@ -171,6 +172,16 @@ module OpenAI
       sig { returns(T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol))) }
       attr_accessor :size
 
+      # Selects the author model and reasoning effort for `output_format=svg`. Supply
+      # `svg.model` when SVG model selection is enabled. Otherwise, omit this object.
+      # SVG output requires `n=1` and cannot use streaming, partial images, or output
+      # compression. Use multipart fields such as `svg[model]`.
+      sig { returns(T.nilable(OpenAI::ImageEditParams::Svg)) }
+      attr_reader :svg
+
+      sig { params(svg: T.nilable(OpenAI::ImageEditParams::Svg::OrHash)).void }
+      attr_writer :svg
+
       # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
       # backward compatibility and is used when `safety_identifier` is omitted, null, or
       # empty.
@@ -220,6 +231,8 @@ module OpenAI
 
           size: T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol)),
 
+          svg: T.nilable(OpenAI::ImageEditParams::Svg::OrHash),
+
           user: String,
 
           request_options: OpenAI::RequestOptions::OrHash
@@ -318,7 +331,8 @@ module OpenAI
         output_compression: nil,
 
         # The format in which the generated images are returned. This parameter is only
-        # supported for the GPT image models. The default value is `png`.
+        # supported for the GPT image models. The default value is `png`. SVG output
+        # requires a supported image model and project access.
         output_format: nil,
 
         # The number of partial images to generate. This parameter is used for streaming
@@ -360,6 +374,12 @@ module OpenAI
         # models that allow automatic sizing.
         size: nil,
 
+        # Selects the author model and reasoning effort for `output_format=svg`. Supply
+        # `svg.model` when SVG model selection is enabled. Otherwise, omit this object.
+        # SVG output requires `n=1` and cannot use streaming, partial images, or output
+        # compression. Use multipart fields such as `svg[model]`.
+        svg: nil,
+
         # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
         # backward compatibility and is used when `safety_identifier` is omitted, null, or
         # empty.
@@ -391,6 +411,7 @@ module OpenAI
             response_format: T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
             safety_identifier: T.nilable(String),
             size: T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol)),
+            svg: T.nilable(OpenAI::ImageEditParams::Svg),
             user: String,
             request_options: OpenAI::RequestOptions
           }
@@ -503,7 +524,8 @@ module OpenAI
       end
 
       # The format in which the generated images are returned. This parameter is only
-      # supported for the GPT image models. The default value is `png`.
+      # supported for the GPT image models. The default value is `png`. SVG output
+      # requires a supported image model and project access.
       module OutputFormat
         extend OpenAI::Internal::Type::Enum
 
@@ -511,9 +533,10 @@ module OpenAI
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         PNG = T.let(:png, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
-        JPEG = T.let(:jpeg, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
         WEBP = T.let(:webp, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
+        JPEG = T.let(:jpeg, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
         GIF = T.let(:gif, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
+        SVG = T.let(:svg, OpenAI::ImageEditParams::OutputFormat::TaggedSymbol)
 
         sig { override.returns(T::Array[OpenAI::ImageEditParams::OutputFormat::TaggedSymbol]) }
         def self.values
@@ -594,6 +617,122 @@ module OpenAI
 
       end
 
+      class Svg < OpenAI::Internal::Type::BaseModel
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::ImageEditParams::Svg,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :model
+
+        sig { params(model: String).void }
+        attr_writer :model
+
+        # Reasoning effort for SVG authoring. When omitted, uses the author model's
+        # default in both Images and Responses.
+        sig { returns(T.nilable(OpenAI::ImageEditParams::Svg::Reasoning)) }
+        attr_reader :reasoning
+
+        sig { params(reasoning: T.nilable(OpenAI::ImageEditParams::Svg::Reasoning::OrHash)).void }
+        attr_writer :reasoning
+
+        # Selects the author model and reasoning effort for `output_format=svg`. Supply
+        # `svg.model` when SVG model selection is enabled. Otherwise, omit this object.
+        # SVG output requires `n=1` and cannot use streaming, partial images, or output
+        # compression. Use multipart fields such as `svg[model]`.
+        sig do
+          params(
+
+            model: String,
+
+            reasoning: T.nilable(OpenAI::ImageEditParams::Svg::Reasoning::OrHash)
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          model: nil,
+
+          # Reasoning effort for SVG authoring. When omitted, uses the author model's
+          # default in both Images and Responses.
+
+          reasoning: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {model: String, reasoning: T.nilable(OpenAI::ImageEditParams::Svg::Reasoning)}
+          )
+        end
+        def to_hash
+        end
+
+        class Reasoning < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::ImageEditParams::Svg::Reasoning,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # Controls how much effort the model should spend on reasoning for this request.
+          sig { returns(T.nilable(OpenAI::ImageEditParams::Svg::Reasoning::Effort::OrSymbol)) }
+          attr_reader :effort
+
+          sig { params(effort: OpenAI::ImageEditParams::Svg::Reasoning::Effort::OrSymbol).void }
+          attr_writer :effort
+
+          # Reasoning effort for SVG authoring. When omitted, uses the author model's
+          # default in both Images and Responses.
+          sig do
+            params(
+
+              effort: OpenAI::ImageEditParams::Svg::Reasoning::Effort::OrSymbol
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # Controls how much effort the model should spend on reasoning for this request.
+
+            effort: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {effort: OpenAI::ImageEditParams::Svg::Reasoning::Effort::OrSymbol}
+            )
+          end
+          def to_hash
+          end
+
+          # Controls how much effort the model should spend on reasoning for this request.
+          module Effort
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::ImageEditParams::Svg::Reasoning::Effort) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            NONE = T.let(:none, OpenAI::ImageEditParams::Svg::Reasoning::Effort::TaggedSymbol)
+            MINIMAL = T.let(:minimal, OpenAI::ImageEditParams::Svg::Reasoning::Effort::TaggedSymbol)
+            LOW = T.let(:low, OpenAI::ImageEditParams::Svg::Reasoning::Effort::TaggedSymbol)
+            MEDIUM = T.let(:medium, OpenAI::ImageEditParams::Svg::Reasoning::Effort::TaggedSymbol)
+            HIGH = T.let(:high, OpenAI::ImageEditParams::Svg::Reasoning::Effort::TaggedSymbol)
+            XHIGH = T.let(:xhigh, OpenAI::ImageEditParams::Svg::Reasoning::Effort::TaggedSymbol)
+            MAX = T.let(:max, OpenAI::ImageEditParams::Svg::Reasoning::Effort::TaggedSymbol)
+
+            sig { override.returns(T::Array[OpenAI::ImageEditParams::Svg::Reasoning::Effort::TaggedSymbol]) }
+            def self.values
+            end
+          end
+        end
+      end
+
     end
 
   end

data/rbi/openai/models/image_generate_params.rbi

@@ -141,7 +141,7 @@ module OpenAI
       # enabled, supply svg.model. When model selection is disabled, omit this object.
       # The top-level model selects the image model that creates the reference image.
       # SVG generation requires n=1 and does not support streaming, partial images,
-      # prompt_rewriter, or output_compression. SVG edits are not supported.
+      # prompt_rewriter, or output_compression.
       sig { returns(T.nilable(OpenAI::ImageGenerateParams::Svg)) }
       attr_reader :svg
 
@@ -313,7 +313,7 @@ module OpenAI
         # enabled, supply svg.model. When model selection is disabled, omit this object.
         # The top-level model selects the image model that creates the reference image.
         # SVG generation requires n=1 and does not support streaming, partial images,
-        # prompt_rewriter, or output_compression. SVG edits are not supported.
+        # prompt_rewriter, or output_compression.
         svg: nil,
 
         # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
@@ -442,8 +442,8 @@ module OpenAI
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         PNG = T.let(:png, OpenAI::ImageGenerateParams::OutputFormat::TaggedSymbol)
-        JPEG = T.let(:jpeg, OpenAI::ImageGenerateParams::OutputFormat::TaggedSymbol)
         WEBP = T.let(:webp, OpenAI::ImageGenerateParams::OutputFormat::TaggedSymbol)
+        JPEG = T.let(:jpeg, OpenAI::ImageGenerateParams::OutputFormat::TaggedSymbol)
         GIF = T.let(:gif, OpenAI::ImageGenerateParams::OutputFormat::TaggedSymbol)
         SVG = T.let(:svg, OpenAI::ImageGenerateParams::OutputFormat::TaggedSymbol)
 
@@ -573,7 +573,7 @@ module OpenAI
         # enabled, supply svg.model. When model selection is disabled, omit this object.
         # The top-level model selects the image model that creates the reference image.
         # SVG generation requires n=1 and does not support streaming, partial images,
-        # prompt_rewriter, or output_compression. SVG edits are not supported.
+        # prompt_rewriter, or output_compression.
         sig do
           params(
 

data/rbi/openai/models/images_response.rbi

@@ -31,7 +31,7 @@ module OpenAI
       sig { params(data: T::Array[OpenAI::Image::OrHash]).void }
       attr_writer :data
 
-      # The output format of the generated image.
+      # The output format of the generated or edited image.
       sig { returns(T.nilable(OpenAI::ImagesResponse::OutputFormat::TaggedSymbol)) }
       attr_reader :output_format
 
@@ -59,15 +59,14 @@ module OpenAI
       sig { params(size: T.any(String, OpenAI::ImagesResponse::Size::OrSymbol)).void }
       attr_writer :size
 
-      # Token usage for the model that authored the SVG, separate from image rendering
-      # usage.
+      # Token usage for SVG authoring, separate from image rendering usage.
       sig { returns(T.nilable(OpenAI::ImagesResponse::SvgUsage)) }
       attr_reader :svg_usage
 
       sig { params(svg_usage: OpenAI::ImagesResponse::SvgUsage::OrHash).void }
       attr_writer :svg_usage
 
-      # For `gpt-image-1` only, the token usage information for the image generation.
+      # Token usage information for image generation with GPT Image models.
       sig { returns(T.nilable(OpenAI::ImagesResponse::Usage)) }
       attr_reader :usage
 
@@ -110,7 +109,7 @@ module OpenAI
         # The list of generated images.
         data: nil,
 
-        # The output format of the generated image.
+        # The output format of the generated or edited image.
         output_format: nil,
 
         # The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
@@ -125,11 +124,10 @@ module OpenAI
         # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
         size: nil,
 
-        # Token usage for the model that authored the SVG, separate from image rendering
-        # usage.
+        # Token usage for SVG authoring, separate from image rendering usage.
         svg_usage: nil,
 
-        # For `gpt-image-1` only, the token usage information for the image generation.
+        # Token usage information for image generation with GPT Image models.
 
         usage: nil
       )
@@ -169,7 +167,7 @@ module OpenAI
         end
       end
 
-      # The output format of the generated image.
+      # The output format of the generated or edited image.
       module OutputFormat
         extend OpenAI::Internal::Type::Enum
 
@@ -255,8 +253,7 @@ module OpenAI
         sig { returns(Integer) }
         attr_accessor :total_tokens
 
-        # Token usage for the model that authored the SVG, separate from image rendering
-        # usage.
+        # Token usage for SVG authoring, separate from image rendering usage.
         sig do
           params(
 
@@ -336,7 +333,7 @@ module OpenAI
         sig { params(output_tokens_details: OpenAI::ImagesResponse::Usage::OutputTokensDetails::OrHash).void }
         attr_writer :output_tokens_details
 
-        # For `gpt-image-1` only, the token usage information for the image generation.
+        # Token usage information for image generation with GPT Image models.
         sig do
           params(
 

data/rbi/openai/models/live/media_session_config.rbi

@@ -93,6 +93,11 @@ module OpenAI
         sig { returns(T.nilable(String)) }
         attr_accessor :instructions
 
+        # A stable identifier for your end user, used for safety monitoring and abuse
+        # detection.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :safety_identifier
+
         # Whether to store the session for later forking and recording download. Defaults
         # to false for new sessions.
         sig { returns(T.nilable(T::Boolean)) }
@@ -142,6 +147,8 @@ module OpenAI
 
             instructions: T.nilable(String),
 
+            safety_identifier: T.nilable(String),
+
             store: T::Boolean,
 
             triggers: T::Array[OpenAI::Live::DecisionTrigger::OrHash]
@@ -181,6 +188,10 @@ module OpenAI
           # server defaults. Immutable after startup.
           instructions: nil,
 
+          # A stable identifier for your end user, used for safety monitoring and abuse
+          # detection.
+          safety_identifier: nil,
+
           # Whether to store the session for later forking and recording download. Defaults
           # to false for new sessions.
           store: nil,
@@ -215,6 +226,7 @@ module OpenAI
                 )
               ],
               instructions: T.nilable(String),
+              safety_identifier: T.nilable(String),
               store: T::Boolean,
               triggers: T::Array[OpenAI::Live::DecisionTrigger]
             }

data/rbi/openai/models/live/session_accept_params.rbi

@@ -146,6 +146,11 @@ module OpenAI
           sig { returns(T.nilable(String)) }
           attr_accessor :instructions
 
+          # A stable identifier for your end user, used for safety monitoring and abuse
+          # detection.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :safety_identifier
+
           # Whether to store the session for later forking and recording download. Defaults
           # to false for new sessions.
           sig { returns(T.nilable(T::Boolean)) }
@@ -191,6 +196,8 @@ module OpenAI
 
               instructions: T.nilable(String),
 
+              safety_identifier: T.nilable(String),
+
               store: T::Boolean,
 
               triggers: T::Array[OpenAI::Live::DecisionTrigger::OrHash],
@@ -228,6 +235,10 @@ module OpenAI
             # server defaults. Immutable after startup.
             instructions: nil,
 
+            # A stable identifier for your end user, used for safety monitoring and abuse
+            # detection.
+            safety_identifier: nil,
+
             # Whether to store the session for later forking and recording download. Defaults
             # to false for new sessions.
             store: nil,
@@ -265,6 +276,7 @@ module OpenAI
                   )
                 ],
                 instructions: T.nilable(String),
+                safety_identifier: T.nilable(String),
                 store: T::Boolean,
                 triggers: T::Array[OpenAI::Live::DecisionTrigger]
               }

data/rbi/openai/models/responses/input_token_count_params.rbi

@@ -134,11 +134,15 @@ module OpenAI
         }
         attr_accessor :tools
 
-        # The truncation strategy to use for the model response. - `auto`: If the input to
-        # this Response exceeds the model's context window size, the model will truncate
-        # the response to fit the context window by dropping items from the beginning of
-        # the conversation. - `disabled` (default): If the input size will exceed the
-        # context window size for a model, the request will fail with a 400 error.
+        # The truncation strategy to use for the model response.
+        #
+        # - `auto`: If the input to this Response exceeds the model's context window size,
+        #   the model will truncate the response to fit the context window by dropping
+        #   items from the beginning of the conversation. On some models, trimming can
+        #   begin earlier because the API subtracts the model's maximum output allowance
+        #   from its input limit before counting tokens.
+        # - `disabled` (default): If the input size will exceed the context window size
+        #   for a model, the request will fail with a 400 error.
         sig { returns(T.nilable(OpenAI::Responses::InputTokenCountParams::Truncation::OrSymbol)) }
         attr_reader :truncation
 
@@ -265,11 +269,15 @@ module OpenAI
           # specify which tool to use by setting the `tool_choice` parameter.
           tools: nil,
 
-          # The truncation strategy to use for the model response. - `auto`: If the input to
-          # this Response exceeds the model's context window size, the model will truncate
-          # the response to fit the context window by dropping items from the beginning of
-          # the conversation. - `disabled` (default): If the input size will exceed the
-          # context window size for a model, the request will fail with a 400 error.
+          # The truncation strategy to use for the model response.
+          #
+          # - `auto`: If the input to this Response exceeds the model's context window size,
+          #   the model will truncate the response to fit the context window by dropping
+          #   items from the beginning of the conversation. On some models, trimming can
+          #   begin earlier because the API subtracts the model's maximum output allowance
+          #   from its input limit before counting tokens.
+          # - `disabled` (default): If the input size will exceed the context window size
+          #   for a model, the request will fail with a 400 error.
           truncation: nil,
 
           request_options: {}
@@ -581,11 +589,15 @@ module OpenAI
 
         end
 
-        # The truncation strategy to use for the model response. - `auto`: If the input to
-        # this Response exceeds the model's context window size, the model will truncate
-        # the response to fit the context window by dropping items from the beginning of
-        # the conversation. - `disabled` (default): If the input size will exceed the
-        # context window size for a model, the request will fail with a 400 error.
+        # The truncation strategy to use for the model response.
+        #
+        # - `auto`: If the input to this Response exceeds the model's context window size,
+        #   the model will truncate the response to fit the context window by dropping
+        #   items from the beginning of the conversation. On some models, trimming can
+        #   begin earlier because the API subtracts the model's maximum output allowance
+        #   from its input limit before counting tokens.
+        # - `disabled` (default): If the input size will exceed the context window size
+        #   for a model, the request will fail with a 400 error.
         module Truncation
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/responses/response.rbi

@@ -340,7 +340,9 @@ module OpenAI
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,
         #   the model will truncate the response to fit the context window by dropping
-        #   items from the beginning of the conversation.
+        #   items from the beginning of the conversation. On some models, trimming can
+        #   begin earlier because the API subtracts the model's maximum output allowance
+        #   from its input limit, even if you set a lower `max_output_tokens`.
         # - `disabled` (default): If the input size will exceed the context window size
         #   for a model, the request will fail with a 400 error.
         sig { returns(T.nilable(OpenAI::Responses::Response::Truncation::TaggedSymbol)) }
@@ -750,7 +752,9 @@ module OpenAI
           #
           # - `auto`: If the input to this Response exceeds the model's context window size,
           #   the model will truncate the response to fit the context window by dropping
-          #   items from the beginning of the conversation.
+          #   items from the beginning of the conversation. On some models, trimming can
+          #   begin earlier because the API subtracts the model's maximum output allowance
+          #   from its input limit, even if you set a lower `max_output_tokens`.
           # - `disabled` (default): If the input size will exceed the context window size
           #   for a model, the request will fail with a 400 error.
           truncation: nil,
@@ -2471,7 +2475,9 @@ module OpenAI
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,
         #   the model will truncate the response to fit the context window by dropping
-        #   items from the beginning of the conversation.
+        #   items from the beginning of the conversation. On some models, trimming can
+        #   begin earlier because the API subtracts the model's maximum output allowance
+        #   from its input limit, even if you set a lower `max_output_tokens`.
         # - `disabled` (default): If the input size will exceed the context window size
         #   for a model, the request will fail with a 400 error.
         module Truncation

data/rbi/openai/models/responses/response_create_params.rbi

@@ -416,7 +416,9 @@ module OpenAI
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,
         #   the model will truncate the response to fit the context window by dropping
-        #   items from the beginning of the conversation.
+        #   items from the beginning of the conversation. On some models, trimming can
+        #   begin earlier because the API subtracts the model's maximum output allowance
+        #   from its input limit, even if you set a lower `max_output_tokens`.
         # - `disabled` (default): If the input size will exceed the context window size
         #   for a model, the request will fail with a 400 error.
         sig { returns(T.nilable(OpenAI::Responses::ResponseCreateParams::Truncation::OrSymbol)) }
@@ -774,7 +776,9 @@ module OpenAI
           #
           # - `auto`: If the input to this Response exceeds the model's context window size,
           #   the model will truncate the response to fit the context window by dropping
-          #   items from the beginning of the conversation.
+          #   items from the beginning of the conversation. On some models, trimming can
+          #   begin earlier because the API subtracts the model's maximum output allowance
+          #   from its input limit, even if you set a lower `max_output_tokens`.
           # - `disabled` (default): If the input size will exceed the context window size
           #   for a model, the request will fail with a 400 error.
           truncation: nil,
@@ -1690,7 +1694,9 @@ module OpenAI
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,
         #   the model will truncate the response to fit the context window by dropping
-        #   items from the beginning of the conversation.
+        #   items from the beginning of the conversation. On some models, trimming can
+        #   begin earlier because the API subtracts the model's maximum output allowance
+        #   from its input limit, even if you set a lower `max_output_tokens`.
         # - `disabled` (default): If the input size will exceed the context window size
         #   for a model, the request will fail with a 400 error.
         module Truncation

data/rbi/openai/models/responses/response_tool_search_output_item_param.rbi

@@ -1365,7 +1365,8 @@ module OpenAI
             # `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`, `gpt-image-2.6-sunburst`,
-            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
+            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default:
+            # `gpt-image-2.6-sunburst`.
             #
             # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
             # `gpt-image-2.5-flare` instead.
@@ -1606,7 +1607,8 @@ module OpenAI
               # `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`, `gpt-image-2.6-sunburst`,
-              # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
+              # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default:
+              # `gpt-image-2.6-sunburst`.
               #
               # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
               # `gpt-image-2.5-flare` instead.
@@ -1897,7 +1899,8 @@ module OpenAI
             # `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`, `gpt-image-2.6-sunburst`,
-            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
+            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default:
+            # `gpt-image-2.6-sunburst`.
             #
             # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
             # `gpt-image-2.5-flare` instead.