openai 0.85.0 → 0.87.0

data/lib/openai/models/image_generate_params.rb

@@ -22,9 +22,11 @@ module OpenAI
       #   one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
       #   the model will automatically determine the best background for the image.
       #
-      #   Transparent backgrounds are available for supported GPT Image models. For
-      #   `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-      #   using `transparent`, set the output format to `png` or `webp`.
+      #   `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+      #   snapshots, support `opaque` and `transparent` backgrounds. Transparent
+      #   backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+      #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+      #   set the output format to `png` or `webp`.
       #
       #   @return [Symbol, OpenAI::Models::ImageGenerateParams::Background, nil]
       optional :background, enum: -> { OpenAI::ImageGenerateParams::Background }, nil?: true
@@ -32,8 +34,10 @@ module OpenAI
       # @!attribute model
       #   The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
       #   image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
-      #   or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
-      #   to the GPT image models is used.
+      #   `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`). Defaults to `dall-e-2` unless a parameter
+      #   specific to the GPT image models is used.
       #
       #   @return [String, Symbol, OpenAI::Models::ImageModel, nil]
       optional :model, union: -> { OpenAI::ImageGenerateParams::Model }, nil?: true
@@ -85,6 +89,8 @@ module OpenAI
       #   - `auto` (default value) will automatically select the best quality for the
       #     given model.
       #   - `high`, `medium` and `low` are supported for the GPT image models.
+      #   - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
+      #     `2026-09-08` snapshots, also support `xhigh` and `max`.
       #   - `hd` and `standard` are supported for `dall-e-3`.
       #   - `standard` is the only option for `dall-e-2`.
       #
@@ -101,17 +107,18 @@ module OpenAI
       optional :response_format, enum: -> { OpenAI::ImageGenerateParams::ResponseFormat }, nil?: true
 
       # @!attribute size
-      #   The size of the generated images. For `gpt-image-2` and
-      #   `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
-      #   strings, for example `1536x864`. Width and height must both be divisible by 16
-      #   and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
-      #   `2560x1440` are experimental, and the maximum supported resolution is
-      #   `3840x2160`. The requested size must also satisfy the model's current pixel and
-      #   edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
-      #   supported by the GPT image models; `auto` is supported for models that allow
-      #   automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
-      #   `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
-      #   `1024x1792`.
+      #   The size of the generated images. For `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`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+      #   resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+      #   Width and height must both be divisible by 16 and the requested aspect ratio
+      #   must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+      #   the maximum supported resolution is `3840x2160`. The requested size must also
+      #   satisfy the model's current pixel and edge limits. The standard sizes
+      #   `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+      #   `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
+      #   one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
+      #   `1024x1024`, `1792x1024`, or `1024x1792`.
       #
       #   @return [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, nil]
       optional :size, union: -> { OpenAI::ImageGenerateParams::Size }, nil?: true
@@ -139,7 +146,7 @@ module OpenAI
       #
       #   @param prompt [String] A text description of the desired image(s). The maximum length is 32000 characte
       #
-      #   @param background [Symbol, OpenAI::Models::ImageGenerateParams::Background, nil] Allows to set transparency for the background of the generated image(s).
+      #   @param background [Symbol, OpenAI::Models::ImageGenerateParams::Background, nil] Allows to set transparency for the background of the generated image(s). Must
       #
       #   @param model [String, Symbol, OpenAI::Models::ImageModel, nil] The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT i
       #
@@ -157,7 +164,7 @@ module OpenAI
       #
       #   @param response_format [Symbol, OpenAI::Models::ImageGenerateParams::ResponseFormat, nil] The format in which generated images with `dall-e-2` and `dall-e-3` are returned
       #
-      #   @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, nil] The size of the generated images. For `gpt-image-2` and `gpt-image-2-2026-04-21`
+      #   @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, nil] The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`, `
       #
       #   @param style [Symbol, OpenAI::Models::ImageGenerateParams::Style, nil] The style of the generated images. This parameter is only supported for `dall-e-
       #
@@ -169,9 +176,11 @@ module OpenAI
       # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
       # the model will automatically determine the best background for the image.
       #
-      # Transparent backgrounds are available for supported GPT Image models. For
-      # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-      # using `transparent`, set the output format to `png` or `webp`.
+      # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+      # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+      # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+      # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+      # set the output format to `png` or `webp`.
       module Background
         extend OpenAI::Internal::Type::Enum
 
@@ -185,14 +194,16 @@ module OpenAI
 
       # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
       # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
-      # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
-      # to the GPT image models is used.
+      # `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`). Defaults to `dall-e-2` unless a parameter
+      # specific to the GPT image models is used.
       module Model
         extend OpenAI::Internal::Type::Union
 
         variant String
 
-        # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`, or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific to the GPT image models is used.
+        # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT image model (`gpt-image-1`, `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`). Defaults to `dall-e-2` unless a parameter specific to the GPT image models is used.
         variant enum: -> { OpenAI::ImageModel }
 
         # @!method self.variants
@@ -230,6 +241,8 @@ module OpenAI
       # - `auto` (default value) will automatically select the best quality for the
       #   given model.
       # - `high`, `medium` and `low` are supported for the GPT image models.
+      # - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
+      #   `2026-09-08` snapshots, also support `xhigh` and `max`.
       # - `hd` and `standard` are supported for `dall-e-3`.
       # - `standard` is the only option for `dall-e-2`.
       module Quality
@@ -240,6 +253,8 @@ module OpenAI
         LOW = :low
         MEDIUM = :medium
         HIGH = :high
+        XHIGH = :xhigh
+        MAX = :max
         AUTO = :auto
 
         # @!method self.values
@@ -260,17 +275,18 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # The size of the generated images. For `gpt-image-2` and
-      # `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
-      # strings, for example `1536x864`. Width and height must both be divisible by 16
-      # and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
-      # `2560x1440` are experimental, and the maximum supported resolution is
-      # `3840x2160`. The requested size must also satisfy the model's current pixel and
-      # edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
-      # supported by the GPT image models; `auto` is supported for models that allow
-      # automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
-      # `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
-      # `1024x1792`.
+      # The size of the generated images. For `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`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+      # resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+      # Width and height must both be divisible by 16 and the requested aspect ratio
+      # must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+      # the maximum supported resolution is `3840x2160`. The requested size must also
+      # satisfy the model's current pixel and edge limits. The standard sizes
+      # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+      # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
+      # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
+      # `1024x1024`, `1792x1024`, or `1024x1792`.
       module Size
         extend OpenAI::Internal::Type::Union
 

data/lib/openai/models/image_model.rb

@@ -9,6 +9,10 @@ module OpenAI
       GPT_IMAGE_1_MINI = :"gpt-image-1-mini"
       GPT_IMAGE_2 = :"gpt-image-2"
       GPT_IMAGE_2_2026_04_21 = :"gpt-image-2-2026-04-21"
+      GPT_IMAGE_2_5_SUNBURST = :"gpt-image-2.5-sunburst"
+      GPT_IMAGE_2_5_SUNBURST_2026_09_08 = :"gpt-image-2.5-sunburst-2026-09-08"
+      GPT_IMAGE_2_5_FLARE = :"gpt-image-2.5-flare"
+      GPT_IMAGE_2_5_FLARE_2026_09_08 = :"gpt-image-2.5-flare-2026-09-08"
       GPT_IMAGE_1_5 = :"gpt-image-1.5"
       CHATGPT_IMAGE_LATEST = :"chatgpt-image-latest"
       DALL_E_2 = :"dall-e-2"

data/lib/openai/models/images_response.rb

@@ -30,17 +30,17 @@ module OpenAI
       optional :output_format, enum: -> { OpenAI::ImagesResponse::OutputFormat }
 
       # @!attribute quality
-      #   The quality of the image generated. Either `low`, `medium`, or `high`.
+      #   The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
+      #   `max`.
       #
       #   @return [Symbol, OpenAI::Models::ImagesResponse::Quality, nil]
       optional :quality, enum: -> { OpenAI::ImagesResponse::Quality }
 
       # @!attribute size
-      #   The size of the image generated. Either `1024x1024`, `1024x1536`, or
-      #   `1536x1024`.
+      #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
-      #   @return [Symbol, OpenAI::Models::ImagesResponse::Size, nil]
-      optional :size, enum: -> { OpenAI::ImagesResponse::Size }
+      #   @return [String, Symbol, OpenAI::Models::ImagesResponse::Size, nil]
+      optional :size, union: -> { OpenAI::ImagesResponse::Size }
 
       # @!attribute usage
       #   For `gpt-image-1` only, the token usage information for the image generation.
@@ -62,9 +62,9 @@ module OpenAI
       #
       #   @param output_format [Symbol, OpenAI::Models::ImagesResponse::OutputFormat] The output format of the image generation. Either `png`, `webp`, or `jpeg`.
       #
-      #   @param quality [Symbol, OpenAI::Models::ImagesResponse::Quality] The quality of the image generated. Either `low`, `medium`, or `high`.
+      #   @param quality [Symbol, OpenAI::Models::ImagesResponse::Quality] The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
       #
-      #   @param size [Symbol, OpenAI::Models::ImagesResponse::Size] The size of the image generated. Either `1024x1024`, `1024x1536`, or `1536x1024`
+      #   @param size [String, Symbol, OpenAI::Models::ImagesResponse::Size] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       #   @param usage [OpenAI::Models::ImagesResponse::Usage] For `gpt-image-1` only, the token usage information for the image generation.
 
@@ -96,7 +96,8 @@ module OpenAI
         #   @return [Array<Symbol>]
       end
 
-      # The quality of the image generated. Either `low`, `medium`, or `high`.
+      # The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
+      # `max`.
       #
       # @see OpenAI::Models::ImagesResponse#quality
       module Quality
@@ -105,24 +106,47 @@ module OpenAI
         LOW = :low
         MEDIUM = :medium
         HIGH = :high
+        XHIGH = :xhigh
+        MAX = :max
 
         # @!method self.values
         #   @return [Array<Symbol>]
       end
 
-      # The size of the image generated. Either `1024x1024`, `1024x1536`, or
-      # `1536x1024`.
+      # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
       # @see OpenAI::Models::ImagesResponse#size
       module Size
-        extend OpenAI::Internal::Type::Enum
+        extend OpenAI::Internal::Type::Union
+
+        variant const: -> { OpenAI::Models::ImagesResponse::Size::SIZE_1024X1024 }
+
+        variant const: -> { OpenAI::Models::ImagesResponse::Size::SIZE_1024X1536 }
+
+        variant const: -> { OpenAI::Models::ImagesResponse::Size::SIZE_1536X1024 }
+
+        # Keep known dimensions as symbols when reading existing API responses.
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(String, Symbol)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(String, OpenAI::ImagesResponse::Size::TaggedSymbol) }
+        end
+
+        # @!group
 
         SIZE_1024X1024 = :"1024x1024"
         SIZE_1024X1536 = :"1024x1536"
         SIZE_1536X1024 = :"1536x1024"
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+        # @!endgroup
+
+        # Preserve the enum helper available before custom dimensions were supported.
+        #
+        # @return [Array<Symbol>]
+        def self.values = [SIZE_1024X1024, SIZE_1024X1536, SIZE_1536X1024]
       end
 
       # @see OpenAI::Models::ImagesResponse#usage

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

@@ -198,6 +198,12 @@ module OpenAI
         #   @return [OpenAI::Models::Responses::ResponsePrompt, nil]
         optional :prompt, -> { OpenAI::Responses::ResponsePrompt }, nil?: true
 
+        # @!attribute prompt_cache_diagnostics
+        #   Prompt cache diagnostics requested for this response.
+        #
+        #   @return [OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheHit, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::ComparisonResponseNotFound, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::Unavailable, nil]
+        optional :prompt_cache_diagnostics, union: -> { OpenAI::Responses::Response::PromptCacheDiagnostics }
+
         # @!attribute prompt_cache_key
         #   Used by OpenAI to cache responses for similar requests to optimize your cache
         #   hit rates. Replaces the `user` field.
@@ -353,18 +359,19 @@ module OpenAI
           texts = []
 
           output.each do |item|
-            next unless item.type == :message
+            next unless item.is_a?(OpenAI::Models::Responses::ResponseOutputMessage)
+
             item.content.each do |content|
-              if content.type == :output_text
-                texts << content.text
-              end
+              next unless content.is_a?(OpenAI::Models::Responses::ResponseOutputText)
+
+              texts << content.text
             end
           end
 
           texts.join
         end
 
-        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, completed_at: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, moderation: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
+        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, completed_at: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, moderation: nil, previous_response_id: nil, prompt: nil, prompt_cache_diagnostics: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::Response} for more details.
         #
@@ -410,6 +417,8 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
         #
+        #   @param prompt_cache_diagnostics [OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheHit, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::ComparisonResponseNotFound, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::Unavailable] Prompt cache diagnostics requested for this response.
+        #
         #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Responses::Response::PromptCacheOptions] The prompt-caching options that were applied to the response. Supported for `gpt
@@ -842,6 +851,118 @@ module OpenAI
           end
         end
 
+        # Prompt cache diagnostics requested for this response.
+        #
+        # @see OpenAI::Models::Responses::Response#prompt_cache_diagnostics
+        module PromptCacheDiagnostics
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          variant :cache_miss, -> { OpenAI::Responses::Response::PromptCacheDiagnostics::CacheMiss }
+
+          variant :cache_hit, -> { OpenAI::Responses::Response::PromptCacheDiagnostics::CacheHit }
+
+          variant(
+            :comparison_response_not_found,
+            -> { OpenAI::Responses::Response::PromptCacheDiagnostics::ComparisonResponseNotFound }
+          )
+
+          variant :unavailable, -> { OpenAI::Responses::Response::PromptCacheDiagnostics::Unavailable }
+
+          class CacheMiss < OpenAI::Internal::Type::BaseModel
+            # @!attribute cache_missed_tokens
+            #   The estimated number of input tokens affected after the first detected
+            #   divergence.
+            #
+            #   @return [Integer]
+            required :cache_missed_tokens, Integer
+
+            # @!attribute reason
+            #   The reason prompt cache reuse did not occur.
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss::Reason]
+            required :reason, enum: -> { OpenAI::Responses::Response::PromptCacheDiagnostics::CacheMiss::Reason }
+
+            # @!attribute type
+            #
+            #   @return [Symbol, :cache_miss]
+            required :type, const: :cache_miss
+
+            # @!attribute comparison_reusable_tokens
+            #   The raw token count of the reusable prefix in the compared response.
+            #
+            #   @return [Integer, nil]
+            optional :comparison_reusable_tokens, Integer
+
+            # @!method initialize(cache_missed_tokens:, reason:, comparison_reusable_tokens: nil, type: :cache_miss)
+            #   Some parameter documentations has been truncated, see
+            #   {OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss} for
+            #   more details.
+            #
+            #   @param cache_missed_tokens [Integer] The estimated number of input tokens affected after the first detected divergenc
+            #
+            #   @param reason [Symbol, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss::Reason] The reason prompt cache reuse did not occur.
+            #
+            #   @param comparison_reusable_tokens [Integer] The raw token count of the reusable prefix in the compared response.
+            #
+            #   @param type [Symbol, :cache_miss]
+
+            # The reason prompt cache reuse did not occur.
+            #
+            # @see OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss#reason
+            module Reason
+              extend OpenAI::Internal::Type::Enum
+
+              MODEL_CHANGED = :model_changed
+              PROMPT_CACHE_KEY_CHANGED = :prompt_cache_key_changed
+              TOOLS_CHANGED = :tools_changed
+              TEXT_FORMAT_CHANGED = :text_format_changed
+              REASONING_EFFORT_CHANGED = :reasoning_effort_changed
+              VERBOSITY_CHANGED = :verbosity_changed
+              CONTEXT_COMPACTED = :context_compacted
+              INPUT_CHANGED = :input_changed
+              SERVICE_TIER_CHANGED = :service_tier_changed
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          class CacheHit < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :cache_hit]
+            required :type, const: :cache_hit
+
+            # @!method initialize(type: :cache_hit)
+            #   @param type [Symbol, :cache_hit]
+          end
+
+          class ComparisonResponseNotFound < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :comparison_response_not_found]
+            required :type, const: :comparison_response_not_found
+
+            # @!method initialize(type: :comparison_response_not_found)
+            #   @param type [Symbol, :comparison_response_not_found]
+          end
+
+          class Unavailable < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :unavailable]
+            required :type, const: :unavailable
+
+            # @!method initialize(type: :unavailable)
+            #   @param type [Symbol, :unavailable]
+          end
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheHit, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::ComparisonResponseNotFound, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::Unavailable)]
+        end
+
         # @see OpenAI::Models::Responses::Response#prompt_cache_options
         class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
           # @!attribute mode
@@ -856,13 +977,21 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Responses::Response::PromptCacheOptions::Ttl]
           required :ttl, enum: -> { OpenAI::Responses::Response::PromptCacheOptions::Ttl }
 
-          # @!method initialize(mode:, ttl:)
+          # @!attribute comparison_response_id
+          #   The response ID supplied as the prompt cache diagnostics comparison.
+          #
+          #   @return [String, nil]
+          optional :comparison_response_id, String, nil?: true
+
+          # @!method initialize(mode:, ttl:, comparison_response_id: nil)
           #   The prompt-caching options that were applied to the response. Supported for
           #   `gpt-5.6` and later models.
           #
           #   @param mode [Symbol, OpenAI::Models::Responses::Response::PromptCacheOptions::Mode] Whether implicit prompt-cache breakpoints were enabled.
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::Response::PromptCacheOptions::Ttl] The minimum lifetime applied to each cache breakpoint.
+          #
+          #   @param comparison_response_id [String, nil] The response ID supplied as the prompt cache diagnostics comparison.
 
           # Whether implicit prompt-cache breakpoints were enabled.
           #

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

@@ -88,12 +88,13 @@ module OpenAI
         #   request will be processed with the Flex Processing service tier. - To opt-in to
         #   [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
         #   `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-        #   Completions. The response will show `service_tier=priority` regardless of if you
-        #   specify `service_tier=fast` or `priority` in your request. - When not set, the
-        #   default behavior is 'auto'. When the `service_tier` parameter is set, the
-        #   response body will include the `service_tier` value based on the processing mode
-        #   actually used to serve the request. This response value may be different from
-        #   the value set in the parameter.
+        #   Completions. For models with a dedicated Fast tier, either value resolves to
+        #   `service_tier=fast`; for other models, either value resolves to
+        #   `service_tier=priority`. - When not set, the default behavior is 'auto'. When
+        #   the `service_tier` parameter is set, the response body will include the
+        #   `service_tier` value based on the processing mode actually used to serve the
+        #   request. This response value may be different from the value set in the
+        #   parameter.
         #
         #   @return [Symbol, OpenAI::Models::Responses::ResponseCompactParams::ServiceTier, nil]
         optional :service_tier, enum: -> { OpenAI::Responses::ResponseCompactParams::ServiceTier }, nil?: true
@@ -581,12 +582,13 @@ module OpenAI
         # request will be processed with the Flex Processing service tier. - To opt-in to
         # [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
         # `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-        # Completions. The response will show `service_tier=priority` regardless of if you
-        # specify `service_tier=fast` or `priority` in your request. - When not set, the
-        # default behavior is 'auto'. When the `service_tier` parameter is set, the
-        # response body will include the `service_tier` value based on the processing mode
-        # actually used to serve the request. This response value may be different from
-        # the value set in the parameter.
+        # Completions. For models with a dedicated Fast tier, either value resolves to
+        # `service_tier=fast`; for other models, either value resolves to
+        # `service_tier=priority`. - When not set, the default behavior is 'auto'. When
+        # the `service_tier` parameter is set, the response body will include the
+        # `service_tier` value based on the processing mode actually used to serve the
+        # request. This response value may be different from the value set in the
+        # parameter.
         module ServiceTier
           extend OpenAI::Internal::Type::Enum
 

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

@@ -260,6 +260,9 @@ module OpenAI
 
         # @!attribute store
         #   Whether to store the generated model response for later retrieval via API.
+        #   Defaults to true when omitted. If set to true, response data will be stored for
+        #   at least 30 days, subject to the
+        #   [data retention exceptions](/api/docs/guides/your-data#v1responses).
         #
         #   @return [Boolean, nil]
         optional :store, OpenAI::Internal::Type::Boolean, nil?: true
@@ -607,6 +610,13 @@ module OpenAI
         end
 
         class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+          # @!attribute comparison_response_id
+          #   The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+          #   this field requests prompt cache diagnostics when the feature is enabled.
+          #
+          #   @return [String, nil]
+          optional :comparison_response_id, String, nil?: true
+
           # @!attribute mode
           #   Controls whether OpenAI automatically creates an implicit cache breakpoint.
           #   Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -626,7 +636,7 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Ttl, nil]
           optional :ttl, enum: -> { OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Ttl }
 
-          # @!method initialize(mode: nil, ttl: nil)
+          # @!method initialize(comparison_response_id: nil, mode: nil, ttl: nil)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions} for more
           #   details.
@@ -641,6 +651,8 @@ module OpenAI
           #   [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
           #   for current details.
           #
+          #   @param comparison_response_id [String, nil] The ID of a response to compare when diagnosing prompt cache reuse. Supplying th
+          #
           #   @param mode [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Mode] Controls whether OpenAI automatically creates an implicit cache breakpoint. Defa
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Ttl] The minimum lifetime applied to every implicit and explicit cache breakpoint wri

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

@@ -16,12 +16,6 @@ module OpenAI
         #   @return [String]
         required :item_id, String
 
-        # @!attribute name
-        #   The name of the function that was called.
-        #
-        #   @return [String]
-        required :name, String
-
         # @!attribute output_index
         #   The index of the output item.
         #
@@ -39,15 +33,13 @@ module OpenAI
         #   @return [Symbol, :"response.function_call_arguments.done"]
         required :type, const: :"response.function_call_arguments.done"
 
-        # @!method initialize(arguments:, item_id:, name:, output_index:, sequence_number:, type: :"response.function_call_arguments.done")
+        # @!method initialize(arguments:, item_id:, output_index:, sequence_number:, type: :"response.function_call_arguments.done")
         #   Emitted when function-call arguments are finalized.
         #
         #   @param arguments [String] The function-call arguments.
         #
         #   @param item_id [String] The ID of the item.
         #
-        #   @param name [String] The name of the function that was called.
-        #
         #   @param output_index [Integer] The index of the output item.
         #
         #   @param sequence_number [Integer] The sequence number of this event.

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

@@ -208,6 +208,7 @@ module OpenAI
           SEARCHING = :searching
           COMPLETED = :completed
           FAILED = :failed
+          INCOMPLETE = :incomplete
 
           # @!method self.values
           #   @return [Array<Symbol>]