openai 0.123.0 → 0.124.0

data/lib/openai/models/content_provenance_check_create_params.rb

@@ -9,6 +9,7 @@ module OpenAI
 
       # @!attribute file
       #   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
@@ -20,6 +21,7 @@ module OpenAI
       # @!method initialize(file:, request_options: {})
       #   @param file [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #     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/lib/openai/models/image_edit_params.rb

@@ -136,7 +136,8 @@ module OpenAI
 
       # @!attribute output_format
       #   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.
       #
       #   @return [Symbol, OpenAI::Models::ImageEditParams::OutputFormat, nil]
       optional :output_format, enum: -> { OpenAI::ImageEditParams::OutputFormat }, nil?: true
@@ -197,6 +198,15 @@ module OpenAI
       #   @return [String, Symbol, OpenAI::Models::ImageEditParams::Size, nil]
       optional :size, union: -> { OpenAI::ImageEditParams::Size }, nil?: true
 
+      # @!attribute svg
+      #   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]`.
+      #
+      #   @return [OpenAI::Models::ImageEditParams::Svg, nil]
+      optional :svg, -> { OpenAI::ImageEditParams::Svg }, nil?: true
+
       # @!attribute user
       #   @deprecated
       #
@@ -208,7 +218,7 @@ module OpenAI
       #   @return [String, nil]
       optional :user, String
 
-      # @!method initialize(image:, prompt:, background: nil, complexity: nil, frame_count: nil, frame_duration_ms: nil, input_fidelity: nil, markup: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, user: nil, request_options: {})
+      # @!method initialize(image:, prompt:, background: nil, complexity: nil, frame_count: nil, frame_duration_ms: nil, input_fidelity: nil, markup: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, svg: nil, user: nil, request_options: {})
       #   @param image [Pathname, StringIO, IO, String, OpenAI::FilePart, Array<Pathname, StringIO, IO, String, OpenAI::FilePart>]
       #     The image(s) to edit. Must be a supported image file or an array of images.
       #
@@ -300,7 +310,8 @@ module OpenAI
       #
       #   @param output_format [Symbol, OpenAI::Models::ImageEditParams::OutputFormat, 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.
       #
       #   @param partial_images [Integer, nil]
       #     The number of partial images to generate. This parameter is used for streaming
@@ -341,6 +352,12 @@ module OpenAI
       #     `1024x1536` are supported by the GPT image models; `auto` is supported for
       #     models that allow automatic sizing.
       #
+      #   @param svg [OpenAI::Models::ImageEditParams::Svg, 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]`.
+      #
       #   @param user [String]
       #     Deprecated: use `safety_identifier` instead. This parameter remains accepted for
       #     backward compatibility and is used when `safety_identifier` is omitted, null, or
@@ -448,14 +465,16 @@ 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
 
         PNG = :png
-        JPEG = :jpeg
         WEBP = :webp
+        JPEG = :jpeg
         GIF = :gif
+        SVG = :svg
 
         # @!method self.values
         #   @return [Array<Symbol>]
@@ -546,6 +565,66 @@ module OpenAI
 
         # @!endgroup
       end
+
+      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::ImageEditParams::Svg::Reasoning, nil]
+        optional :reasoning, -> { OpenAI::ImageEditParams::Svg::Reasoning }, nil?: true
+
+        # @!method initialize(model: nil, reasoning: 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]`.
+        #
+        #   @param model [String]
+        #
+        #   @param reasoning [OpenAI::Models::ImageEditParams::Svg::Reasoning, nil]
+        #     Reasoning effort for SVG authoring. When omitted, uses the author model's
+        #     default in both Images and Responses.
+
+        # @see OpenAI::Models::ImageEditParams::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::ImageEditParams::Svg::Reasoning::Effort, nil]
+          optional :effort, enum: -> { OpenAI::ImageEditParams::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::ImageEditParams::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::ImageEditParams::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
   end
 end

data/lib/openai/models/image_generate_params.rb

@@ -172,7 +172,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.
       #
       #   @return [OpenAI::Models::ImageGenerateParams::Svg, nil]
       optional :svg, -> { OpenAI::ImageGenerateParams::Svg }, nil?: true
@@ -300,7 +300,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.
       #
       #   @param user [String]
       #     Deprecated: use `safety_identifier` instead. This parameter remains accepted for
@@ -392,8 +392,8 @@ module OpenAI
         extend OpenAI::Internal::Type::Enum
 
         PNG = :png
-        JPEG = :jpeg
         WEBP = :webp
+        JPEG = :jpeg
         GIF = :gif
         SVG = :svg
 
@@ -537,7 +537,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.
         #
         #   @param model [String]
         #     Model used to author the SVG. Required when SVG model selection is enabled.

data/lib/openai/models/images_response.rb

@@ -24,7 +24,7 @@ module OpenAI
       optional :data, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Image] }
 
       # @!attribute output_format
-      #   The output format of the generated image.
+      #   The output format of the generated or edited image.
       #
       #   @return [Symbol, OpenAI::Models::ImagesResponse::OutputFormat, nil]
       optional :output_format, enum: -> { OpenAI::ImagesResponse::OutputFormat }
@@ -51,14 +51,13 @@ module OpenAI
       optional :size, union: -> { OpenAI::ImagesResponse::Size }
 
       # @!attribute svg_usage
-      #   Token usage for the model that authored the SVG, separate from image rendering
-      #   usage.
+      #   Token usage for SVG authoring, separate from image rendering usage.
       #
       #   @return [OpenAI::Models::ImagesResponse::SvgUsage, nil]
       optional :svg_usage, -> { OpenAI::ImagesResponse::SvgUsage }
 
       # @!attribute usage
-      #   For `gpt-image-1` only, the token usage information for the image generation.
+      #   Token usage information for image generation with GPT Image models.
       #
       #   @return [OpenAI::Models::ImagesResponse::Usage, nil]
       optional :usage, -> { OpenAI::ImagesResponse::Usage }
@@ -77,7 +76,7 @@ module OpenAI
       #     The list of generated images.
       #
       #   @param output_format [Symbol, OpenAI::Models::ImagesResponse::OutputFormat]
-      #     The output format of the generated image.
+      #     The output format of the generated or edited image.
       #
       #   @param quality [Symbol, OpenAI::Models::ImagesResponse::Quality]
       #     The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
@@ -92,11 +91,10 @@ module OpenAI
       #     The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       #   @param svg_usage [OpenAI::Models::ImagesResponse::SvgUsage]
-      #     Token usage for the model that authored the SVG, separate from image rendering
-      #     usage.
+      #     Token usage for SVG authoring, separate from image rendering usage.
       #
       #   @param usage [OpenAI::Models::ImagesResponse::Usage]
-      #     For `gpt-image-1` only, the token usage information for the image generation.
+      #     Token usage information for image generation with GPT Image models.
 
       # The background parameter used for the image generation. Either `transparent` or
       # `opaque`.
@@ -112,7 +110,7 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # The output format of the generated image.
+      # The output format of the generated or edited image.
       #
       # @see OpenAI::Models::ImagesResponse#output_format
       module OutputFormat
@@ -208,8 +206,7 @@ module OpenAI
         required :total_tokens, Integer
 
         # @!method initialize(input_tokens:, model:, output_tokens:, reasoning_tokens:, 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.
         #
         #   @param input_tokens [Integer]
         #   @param model [String]
@@ -251,7 +248,7 @@ module OpenAI
         optional :output_tokens_details, -> { OpenAI::ImagesResponse::Usage::OutputTokensDetails }
 
         # @!method initialize(input_tokens:, input_tokens_details:, output_tokens:, total_tokens:, output_tokens_details: nil)
-        #   For `gpt-image-1` only, the token usage information for the image generation.
+        #   Token usage information for image generation with GPT Image models.
         #
         #   @param input_tokens [Integer]
         #     The number of tokens (images and text) in the input prompt.

data/lib/openai/models/live/media_session_config.rb

@@ -53,6 +53,13 @@ module OpenAI
         #   @return [String, nil]
         optional :instructions, String, nil?: true
 
+        # @!attribute safety_identifier
+        #   A stable identifier for your end user, used for safety monitoring and abuse
+        #   detection.
+        #
+        #   @return [String, nil]
+        optional :safety_identifier, String, nil?: true
+
         # @!attribute store
         #   Whether to store the session for later forking and recording download. Defaults
         #   to false for new sessions.
@@ -69,7 +76,7 @@ module OpenAI
         #   @return [Array<OpenAI::Models::Live::DecisionTrigger>, nil]
         optional :triggers, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Live::DecisionTrigger] }
 
-        # @!method initialize(model:, audio: nil, client: nil, delegation: nil, input: nil, instructions: nil, store: nil, triggers: nil)
+        # @!method initialize(model:, audio: nil, client: nil, delegation: nil, input: nil, instructions: nil, safety_identifier: nil, store: nil, triggers: nil)
         #   Startup configuration for a Live media session. Follow the
         #   [Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting)
         #   when writing frontend instructions and the backend prompt under
@@ -106,6 +113,10 @@ module OpenAI
         #     Limited to 16,384 client-supplied tokens. Omitted or blank instructions use
         #     server defaults. Immutable after startup.
         #
+        #   @param safety_identifier [String, nil]
+        #     A stable identifier for your end user, used for safety monitoring and abuse
+        #     detection.
+        #
         #   @param store [Boolean]
         #     Whether to store the session for later forking and recording download. Defaults
         #     to false for new sessions.

data/lib/openai/models/live/session_accept_params.rb

@@ -84,6 +84,13 @@ module OpenAI
           #   @return [String, nil]
           optional :instructions, String, nil?: true
 
+          # @!attribute safety_identifier
+          #   A stable identifier for your end user, used for safety monitoring and abuse
+          #   detection.
+          #
+          #   @return [String, nil]
+          optional :safety_identifier, String, nil?: true
+
           # @!attribute store
           #   Whether to store the session for later forking and recording download. Defaults
           #   to false for new sessions.
@@ -100,7 +107,7 @@ module OpenAI
           #   @return [Array<OpenAI::Models::Live::DecisionTrigger>, nil]
           optional :triggers, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Live::DecisionTrigger] }
 
-          # @!method initialize(model:, audio: nil, delegation: nil, input: nil, instructions: nil, store: nil, triggers: nil, type: :live)
+          # @!method initialize(model:, audio: nil, delegation: nil, input: nil, instructions: nil, safety_identifier: nil, store: nil, triggers: nil, type: :live)
           #   Model and startup configuration for the Live session that answers the incoming
           #   SIP call.
           #
@@ -131,6 +138,10 @@ module OpenAI
           #     Limited to 16,384 client-supplied tokens. Omitted or blank instructions use
           #     server defaults. Immutable after startup.
           #
+          #   @param safety_identifier [String, nil]
+          #     A stable identifier for your end user, used for safety monitoring and abuse
+          #     detection.
+          #
           #   @param store [Boolean]
           #     Whether to store the session for later forking and recording download. Defaults
           #     to false for new sessions.

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

@@ -104,11 +104,15 @@ module OpenAI
         # @!attribute truncation
         #   @deprecated
         #
-        #   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.
         #
         #   @return [Symbol, OpenAI::Models::Responses::InputTokenCountParams::Truncation, nil]
         optional :truncation, enum: -> { OpenAI::Responses::InputTokenCountParams::Truncation }
@@ -169,11 +173,15 @@ module OpenAI
         #     specify which tool to use by setting the `tool_choice` parameter.
         #
         #   @param truncation [Symbol, OpenAI::Models::Responses::InputTokenCountParams::Truncation]
-        #     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.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -374,11 +382,15 @@ module OpenAI
 
         # @deprecated
         #
-        # 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/lib/openai/models/responses/response.rb

@@ -363,7 +363,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.
         #
@@ -626,7 +628,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.
         #
@@ -1605,7 +1609,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.
         #

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

@@ -31,6 +31,8 @@ module OpenAI
         optional :input, union: -> { OpenAI::Responses::ResponseCompactParams::Input }, nil?: true
 
         # @!attribute instructions
+        #   @deprecated
+        #
         #   A system (or developer) message inserted into the model's context. When used
         #   along with `previous_response_id`, the instructions from a previous response
         #   will not be carried over to the next response. This makes it simple to swap out

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

@@ -369,7 +369,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.
         #
@@ -629,7 +631,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.
         #
@@ -1161,7 +1165,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/lib/openai/models/responses/response_tool_search_output_item_param.rb

@@ -808,7 +808,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.
@@ -940,7 +941,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.
@@ -1089,7 +1091,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.

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

@@ -454,7 +454,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.
           #
@@ -748,7 +750,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.
           #
@@ -1321,7 +1325,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.
           #

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

@@ -683,7 +683,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.
@@ -800,7 +801,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.
@@ -949,7 +951,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.

data/lib/openai/models/video_create_error.rb

@@ -16,8 +16,9 @@ module OpenAI
       required :message, String
 
       # @!attribute headers
-      #   The Retry-After and Retry-After-Ms headers returned with the original error, if
-      #   any.
+      #   Headers returned with the original error. These can include Retry-After,
+      #   Retry-After-Ms, and, on opted-in deployments,
+      #   x-openai-inference-capacity-reason.
       #
       #   @return [Hash{Symbol=>String}, nil]
       optional :headers, OpenAI::Internal::Type::HashOf[String]
@@ -49,8 +50,9 @@ module OpenAI
       #     A human-readable description of the error that was returned.
       #
       #   @param headers [Hash{Symbol=>String}]
-      #     The Retry-After and Retry-After-Ms headers returned with the original error, if
-      #     any.
+      #     Headers returned with the original error. These can include Retry-After,
+      #     Retry-After-Ms, and, on opted-in deployments,
+      #     x-openai-inference-capacity-reason.
       #
       #   @param misalignment [OpenAI::Models::VideoCreateError::Misalignment]
       #

data/lib/openai/models/webhooks/agent_session_action_required_webhook_event.rb

@@ -95,6 +95,7 @@ module OpenAI
               extend OpenAI::Internal::Type::Enum
 
               COMPUTER_USE_APPROVAL_REQUEST = :computer_use_approval_request
+              MCP_APPROVAL_REQUEST = :mcp_approval_request
               FUNCTION_CALL = :function_call
               ENVIRONMENT_CONNECTION = :environment_connection