openai 0.85.0 → 0.87.0

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

@@ -803,7 +803,26 @@ module OpenAI
           #   @return [OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall::Agent, nil]
           optional :agent, -> { OpenAI::Beta::BetaResponseItem::ImageGenerationCall::Agent }, nil?: true
 
-          # @!method initialize(id:, result:, status:, agent: nil, type: :image_generation_call)
+          # @!attribute quality
+          #   The quality of the image generated by the image generation tool call. One of
+          #   `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall::Quality, nil]
+          optional(
+            :quality,
+            enum: -> {
+              OpenAI::Beta::BetaResponseItem::ImageGenerationCall::Quality
+            },
+            nil?: true
+          )
+
+          # @!attribute size
+          #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #
+          #   @return [String, Symbol, OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall::Size, nil]
+          optional :size, union: -> { OpenAI::Beta::BetaResponseItem::ImageGenerationCall::Size }, nil?: true
+
+          # @!method initialize(id:, result:, status:, agent: nil, quality: nil, size: nil, type: :image_generation_call)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall} for more details.
           #
@@ -817,6 +836,10 @@ module OpenAI
           #
           #   @param agent [OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall::Agent, nil] The agent that produced this item.
           #
+          #   @param quality [Symbol, OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall::Quality, nil] The quality of the image generated by the image generation tool call. One of `lo
+          #
+          #   @param size [String, Symbol, OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall::Size, nil] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #
           #   @param type [Symbol, :image_generation_call] The type of the image generation call. Always `image_generation_call`.
 
           # The status of the image generation call.
@@ -847,6 +870,54 @@ module OpenAI
             #
             #   @param agent_name [String] The canonical name of the agent that produced this item.
           end
+
+          # The quality of the image generated by the image generation tool call. One of
+          # `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall#quality
+          module Quality
+            extend OpenAI::Internal::Type::Enum
+
+            LOW = :low
+            MEDIUM = :medium
+            HIGH = :high
+            XHIGH = :xhigh
+            MAX = :max
+            AUTO = :auto
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall#size
+          module Size
+            extend OpenAI::Internal::Type::Union
+
+            variant String
+
+            variant const: -> { OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall::Size::SIZE_1024X1024 }
+
+            variant const: -> { OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall::Size::SIZE_1024X1536 }
+
+            variant const: -> { OpenAI::Models::Beta::BetaResponseItem::ImageGenerationCall::Size::SIZE_1536X1024 }
+
+            # @!method self.variants
+            #   @return [Array(String, Symbol)]
+
+            define_sorbet_constant!(:Variants) do
+              T.type_alias { T.any(String, OpenAI::Beta::BetaResponseItem::ImageGenerationCall::Size::TaggedSymbol) }
+            end
+
+            # @!group
+
+            SIZE_1024X1024 = :"1024x1024"
+            SIZE_1024X1536 = :"1024x1536"
+            SIZE_1536X1024 = :"1536x1024"
+
+            # @!endgroup
+          end
         end
 
         class LocalShellCall < OpenAI::Internal::Type::BaseModel

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

@@ -802,7 +802,30 @@ module OpenAI
           #   @return [OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Agent, nil]
           optional :agent, -> { OpenAI::Beta::BetaResponseOutputItem::ImageGenerationCall::Agent }, nil?: true
 
-          # @!method initialize(id:, result:, status:, agent: nil, type: :image_generation_call)
+          # @!attribute quality
+          #   The quality of the image generated by the image generation tool call. One of
+          #   `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Quality, nil]
+          optional(
+            :quality,
+            enum: -> { OpenAI::Beta::BetaResponseOutputItem::ImageGenerationCall::Quality },
+            nil?: true
+          )
+
+          # @!attribute size
+          #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #
+          #   @return [String, Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Size, nil]
+          optional(
+            :size,
+            union: -> {
+              OpenAI::Beta::BetaResponseOutputItem::ImageGenerationCall::Size
+            },
+            nil?: true
+          )
+
+          # @!method initialize(id:, result:, status:, agent: nil, quality: nil, size: nil, type: :image_generation_call)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall} for more
           #   details.
@@ -817,6 +840,10 @@ module OpenAI
           #
           #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Agent, nil] The agent that produced this item.
           #
+          #   @param quality [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Quality, nil] The quality of the image generated by the image generation tool call. One of `lo
+          #
+          #   @param size [String, Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Size, nil] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #
           #   @param type [Symbol, :image_generation_call] The type of the image generation call. Always `image_generation_call`.
 
           # The status of the image generation call.
@@ -847,6 +874,62 @@ module OpenAI
             #
             #   @param agent_name [String] The canonical name of the agent that produced this item.
           end
+
+          # The quality of the image generated by the image generation tool call. One of
+          # `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall#quality
+          module Quality
+            extend OpenAI::Internal::Type::Enum
+
+            LOW = :low
+            MEDIUM = :medium
+            HIGH = :high
+            XHIGH = :xhigh
+            MAX = :max
+            AUTO = :auto
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall#size
+          module Size
+            extend OpenAI::Internal::Type::Union
+
+            variant String
+
+            variant(
+              const: -> { OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Size::SIZE_1024X1024 }
+            )
+
+            variant(
+              const: -> { OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Size::SIZE_1024X1536 }
+            )
+
+            variant(
+              const: -> { OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Size::SIZE_1536X1024 }
+            )
+
+            # @!method self.variants
+            #   @return [Array(String, Symbol)]
+
+            define_sorbet_constant!(:Variants) do
+              T.type_alias {
+                T.any(String, OpenAI::Beta::BetaResponseOutputItem::ImageGenerationCall::Size::TaggedSymbol)
+              }
+            end
+
+            # @!group
+
+            SIZE_1024X1024 = :"1024x1024"
+            SIZE_1024X1536 = :"1024x1536"
+            SIZE_1536X1024 = :"1536x1024"
+
+            # @!endgroup
+          end
         end
 
         class LocalShellCall < OpenAI::Internal::Type::BaseModel

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

@@ -336,6 +336,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
@@ -1279,6 +1282,13 @@ module OpenAI
 
           # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate#prompt_cache_options
           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
@@ -1304,7 +1314,7 @@ module OpenAI
               enum: -> { OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::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::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions}
             #   for more details.
@@ -1319,6 +1329,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::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode] Controls whether OpenAI automatically creates an implicit cache breakpoint. Defa
             #
             #   @param ttl [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl] The minimum lifetime applied to every implicit and explicit cache breakpoint wri

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

@@ -862,7 +862,7 @@ module OpenAI
           #   @return [String, nil]
           optional :stream_id, String
 
-          # @!method initialize(arguments:, item_id:, name:, output_index:, sequence_number:, agent: nil, stream_id: nil, type: :"response.function_call_arguments.done")
+          # @!method initialize(arguments:, item_id:, output_index:, sequence_number:, agent: nil, stream_id: nil, type: :"response.function_call_arguments.done")
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFunctionCallArgumentsWsDone}
           #   for more details.
@@ -873,8 +873,6 @@ module OpenAI
           #
           #   @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/beta/beta_tool.rb

@@ -571,9 +571,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::Beta::BetaTool::ImageGeneration::Background, nil]
           optional :background, enum: -> { OpenAI::Beta::BetaTool::ImageGeneration::Background }
@@ -602,7 +604,9 @@ module OpenAI
 
           # @!attribute model
           #   The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          #   `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+          #   `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+          #   `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+          #   `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
           #   `chatgpt-image-latest`. Default: `gpt-image-1`.
           #
           #   @return [String, Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Model, nil]
@@ -635,24 +639,27 @@ module OpenAI
           optional :partial_images, Integer
 
           # @!attribute quality
-          #   The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-          #   Default: `auto`.
+          #   The quality of the generated image. The GPT image models support `low`,
+          #   `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+          #   including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+          #   `auto`.
           #
           #   @return [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Quality, nil]
           optional :quality, enum: -> { OpenAI::Beta::BetaTool::ImageGeneration::Quality }
 
           # @!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::Beta::BetaTool::ImageGeneration::Size, nil]
           optional :size, union: -> { OpenAI::Beta::BetaTool::ImageGeneration::Size }
@@ -665,7 +672,7 @@ module OpenAI
           #
           #   @param action [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Action] Whether to generate a new image or edit an existing image. Default: `auto`.
           #
-          #   @param background [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Background] Allows to set transparency for the background of the generated image(s).
+          #   @param background [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Background] Allows to set transparency for the background of the generated image(s). Must
           #
           #   @param input_fidelity [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::InputFidelity, nil] Control how much effort the model will exert to match the style and features, es
           #
@@ -681,9 +688,9 @@ module OpenAI
           #
           #   @param partial_images [Integer] Number of partial images to generate in streaming mode, from 0 (default value) t
           #
-          #   @param quality [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Quality] The quality of the generated image. One of `low`, `medium`, `high`,
+          #   @param quality [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Quality] The quality of the generated image. The GPT image models support `low`,
           #
-          #   @param size [String, Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Size] The size of the generated images. For `gpt-image-2` and `gpt-image-2-2026-04-21`
+          #   @param size [String, Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Size] The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`, `
           #
           #   @param type [Symbol, :image_generation] The type of the image generation tool. Always `image_generation`.
 
@@ -705,9 +712,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`.
           #
           # @see OpenAI::Models::Beta::BetaTool::ImageGeneration#background
           module Background
@@ -765,7 +774,9 @@ module OpenAI
           end
 
           # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+          # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
           # `chatgpt-image-latest`. Default: `gpt-image-1`.
           #
           # @see OpenAI::Models::Beta::BetaTool::ImageGeneration#model
@@ -782,6 +793,18 @@ module OpenAI
 
             variant const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::GPT_IMAGE_2_2026_04_21 }
 
+            variant const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::GPT_IMAGE_2_5_SUNBURST }
+
+            variant(
+              const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::GPT_IMAGE_2_5_SUNBURST_2026_09_08 }
+            )
+
+            variant const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::GPT_IMAGE_2_5_FLARE }
+
+            variant(
+              const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::GPT_IMAGE_2_5_FLARE_2026_09_08 }
+            )
+
             variant const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::GPT_IMAGE_1_5 }
 
             variant const: -> { OpenAI::Models::Beta::BetaTool::ImageGeneration::Model::CHATGPT_IMAGE_LATEST }
@@ -799,6 +822,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"
 
@@ -833,8 +860,10 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
 
-          # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-          # Default: `auto`.
+          # The quality of the generated image. The GPT image models support `low`,
+          # `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+          # including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+          # `auto`.
           #
           # @see OpenAI::Models::Beta::BetaTool::ImageGeneration#quality
           module Quality
@@ -843,23 +872,26 @@ module OpenAI
             LOW = :low
             MEDIUM = :medium
             HIGH = :high
+            XHIGH = :xhigh
+            MAX = :max
             AUTO = :auto
 
             # @!method self.values
             #   @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`.
           #
           # @see OpenAI::Models::Beta::BetaTool::ImageGeneration#size
           module Size

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

@@ -90,12 +90,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::Beta::ResponseCompactParams::ServiceTier, nil]
         optional :service_tier, enum: -> { OpenAI::Beta::ResponseCompactParams::ServiceTier }, nil?: true
@@ -578,12 +579,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/beta/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
@@ -965,6 +968,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
@@ -984,7 +994,7 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Ttl, nil]
           optional :ttl, enum: -> { OpenAI::Beta::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::Beta::ResponseCreateParams::PromptCacheOptions} for more
           #   details.
@@ -999,6 +1009,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::Beta::ResponseCreateParams::PromptCacheOptions::Mode] Controls whether OpenAI automatically creates an implicit cache breakpoint. Defa
           #
           #   @param ttl [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Ttl] The minimum lifetime applied to every implicit and explicit cache breakpoint wri

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

@@ -126,7 +126,28 @@ module OpenAI
           #   @return [Symbol, :image_generation_call]
           required :type, const: :image_generation_call
 
-          # @!method initialize(id:, result:, status:, type: :image_generation_call)
+          # @!attribute quality
+          #   The quality of the image generated by the image generation tool call. One of
+          #   `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+          #
+          #   @return [Symbol, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Quality, nil]
+          optional(
+            :quality,
+            enum: -> { OpenAI::Conversations::ConversationItem::ImageGenerationCall::Quality },
+            nil?: true
+          )
+
+          # @!attribute size
+          #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #
+          #   @return [String, Symbol, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Size, nil]
+          optional(
+            :size,
+            union: -> { OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size },
+            nil?: true
+          )
+
+          # @!method initialize(id:, result:, status:, quality: nil, size: nil, type: :image_generation_call)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall} for more
           #   details.
@@ -139,6 +160,10 @@ module OpenAI
           #
           #   @param status [Symbol, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Status] The status of the image generation call.
           #
+          #   @param quality [Symbol, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Quality, nil] The quality of the image generated by the image generation tool call. One of `lo
+          #
+          #   @param size [String, Symbol, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Size, nil] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #
           #   @param type [Symbol, :image_generation_call] The type of the image generation call. Always `image_generation_call`.
 
           # The status of the image generation call.
@@ -155,6 +180,62 @@ module OpenAI
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # The quality of the image generated by the image generation tool call. One of
+          # `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
+          #
+          # @see OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall#quality
+          module Quality
+            extend OpenAI::Internal::Type::Enum
+
+            LOW = :low
+            MEDIUM = :medium
+            HIGH = :high
+            XHIGH = :xhigh
+            MAX = :max
+            AUTO = :auto
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #
+          # @see OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall#size
+          module Size
+            extend OpenAI::Internal::Type::Union
+
+            variant String
+
+            variant(
+              const: -> { OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Size::SIZE_1024X1024 }
+            )
+
+            variant(
+              const: -> { OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Size::SIZE_1024X1536 }
+            )
+
+            variant(
+              const: -> { OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall::Size::SIZE_1536X1024 }
+            )
+
+            # @!method self.variants
+            #   @return [Array(String, Symbol)]
+
+            define_sorbet_constant!(:Variants) do
+              T.type_alias {
+                T.any(String, OpenAI::Conversations::ConversationItem::ImageGenerationCall::Size::TaggedSymbol)
+              }
+            end
+
+            # @!group
+
+            SIZE_1024X1024 = :"1024x1024"
+            SIZE_1024X1536 = :"1024x1536"
+            SIZE_1536X1024 = :"1536x1024"
+
+            # @!endgroup
+          end
         end
 
         class AdditionalTools < OpenAI::Internal::Type::BaseModel