openai 0.117.0 → 0.119.0

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

@@ -1294,6 +1294,43 @@ module OpenAI
             }
             attr_writer :background
 
+            # Computation spent planning the image, independently of rendering quality.
+            # Overrides the outer response's `reasoning.effort` for image generation. When
+            # omitted, inherits a supported outer reasoning effort or uses the image model's
+            # configured default. For SVG output, controls the reference image, not the SVG
+            # author's reasoning.
+            sig {
+              returns(
+                T.nilable(
+                  OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity::OrSymbol
+                )
+              )
+            }
+            attr_reader :complexity
+
+            sig {
+              params(
+                complexity: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity::OrSymbol
+              )
+                .void
+            }
+            attr_writer :complexity
+
+            # Number of GIF frames. Requires `output_format` to be `gif`. Default: 9.
+            sig { returns(T.nilable(Integer)) }
+            attr_reader :frame_count
+
+            sig { params(frame_count: Integer).void }
+            attr_writer :frame_count
+
+            # Duration of each GIF frame in milliseconds, rounded to 10 ms. Requires
+            # `output_format` to be `gif`. Default: 200.
+            sig { returns(T.nilable(Integer)) }
+            attr_reader :frame_duration_ms
+
+            sig { params(frame_duration_ms: Integer).void }
+            attr_writer :frame_duration_ms
+
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. Supports `high` and `low` on
             # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
@@ -1327,8 +1364,8 @@ module OpenAI
             # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
             # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
             # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
-            # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
-            # `gpt-image-2`.
+            # `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-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
             # `gpt-image-2.5-flare` instead.
@@ -1380,8 +1417,12 @@ module OpenAI
             sig { params(output_compression: Integer).void }
             attr_writer :output_compression
 
-            # The output format of the generated image. One of `png`, `webp`, or `jpeg`.
-            # Default: `png`.
+            # The output format of the generated image. One of `png`, `webp`, `jpeg`, `gif`,
+            # or `svg`. Default: `png`. GIF and SVG output require a model that supports the
+            # selected format. GIF output does not support partial image streaming
+            # (`partial_images` greater than `0`), `input_image_mask`, or custom
+            # `output_compression`. Responses lifecycle events can still be streamed for GIF
+            # output.
             sig {
               returns(
                 T.nilable(
@@ -1461,6 +1502,20 @@ module OpenAI
             }
             attr_writer :size
 
+            # SVG author model settings. Requires `output_format` to be `svg`. When SVG model
+            # selection is enabled, omitting this object uses the outer response model.
+            # Otherwise, the default SVG author is used and explicit model overrides are
+            # unavailable.
+            sig {
+              returns(T.nilable(OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg))
+            }
+            attr_reader :svg
+
+            sig {
+              params(svg: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::OrHash).void
+            }
+            attr_writer :svg
+
             # A tool that generates images using the GPT image models.
             sig do
               params(
@@ -1469,6 +1524,12 @@ module OpenAI
 
                 background: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Background::OrSymbol,
 
+                complexity: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity::OrSymbol,
+
+                frame_count: Integer,
+
+                frame_duration_ms: Integer,
+
                 input_fidelity: T.nilable(
                   OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity::OrSymbol
                 ),
@@ -1495,6 +1556,8 @@ module OpenAI
                   OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size::OrSymbol
                 ),
 
+                svg: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::OrHash,
+
                 type: Symbol
               )
                 .returns(T.attached_class)
@@ -1515,6 +1578,20 @@ module OpenAI
               # set the output format to `png` or `webp`.
               background: nil,
 
+              # Computation spent planning the image, independently of rendering quality.
+              # Overrides the outer response's `reasoning.effort` for image generation. When
+              # omitted, inherits a supported outer reasoning effort or uses the image model's
+              # configured default. For SVG output, controls the reference image, not the SVG
+              # author's reasoning.
+              complexity: nil,
+
+              # Number of GIF frames. Requires `output_format` to be `gif`. Default: 9.
+              frame_count: nil,
+
+              # Duration of each GIF frame in milliseconds, rounded to 10 ms. Requires
+              # `output_format` to be `gif`. Default: 200.
+              frame_duration_ms: nil,
+
               # Control how much effort the model will exert to match the style and features,
               # especially facial features, of input images. Supports `high` and `low` on
               # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
@@ -1528,8 +1605,8 @@ module OpenAI
               # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
               # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
               # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
-              # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
-              # `gpt-image-2`.
+              # `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-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
               # `gpt-image-2.5-flare` instead.
@@ -1541,8 +1618,12 @@ module OpenAI
               # Compression level for the output image. Default: 100.
               output_compression: nil,
 
-              # The output format of the generated image. One of `png`, `webp`, or `jpeg`.
-              # Default: `png`.
+              # The output format of the generated image. One of `png`, `webp`, `jpeg`, `gif`,
+              # or `svg`. Default: `png`. GIF and SVG output require a model that supports the
+              # selected format. GIF output does not support partial image streaming
+              # (`partial_images` greater than `0`), `input_image_mask`, or custom
+              # `output_compression`. Responses lifecycle events can still be streamed for GIF
+              # output.
               output_format: nil,
 
               # Number of partial images to generate in streaming mode, from 0 (default value)
@@ -1567,6 +1648,12 @@ module OpenAI
               # `auto` is supported for models that allow automatic sizing.
               size: nil,
 
+              # SVG author model settings. Requires `output_format` to be `svg`. When SVG model
+              # selection is enabled, omitting this object uses the outer response model.
+              # Otherwise, the default SVG author is used and explicit model overrides are
+              # unavailable.
+              svg: nil,
+
               # The type of the image generation tool. Always `image_generation`.
 
               type: :image_generation
@@ -1579,6 +1666,9 @@ module OpenAI
                   type: Symbol,
                   action: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Action::OrSymbol,
                   background: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Background::OrSymbol,
+                  complexity: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity::OrSymbol,
+                  frame_count: Integer,
+                  frame_duration_ms: Integer,
                   input_fidelity: T.nilable(
                     OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity::OrSymbol
                   ),
@@ -1595,7 +1685,8 @@ module OpenAI
                   size: T.any(
                     String,
                     OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size::OrSymbol
-                  )
+                  ),
+                  svg: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg
                 }
               )
             end
@@ -1676,6 +1767,43 @@ module OpenAI
               end
             end
 
+            # Computation spent planning the image, independently of rendering quality.
+            # Overrides the outer response's `reasoning.effort` for image generation. When
+            # omitted, inherits a supported outer reasoning effort or uses the image model's
+            # configured default. For SVG output, controls the reference image, not the SVG
+            # author's reasoning.
+            module Complexity
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias {
+                T.all(Symbol, OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity)
+              }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              LOW = T.let(
+                :low,
+                OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity::TaggedSymbol
+              )
+              MEDIUM = T.let(
+                :medium,
+                OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity::TaggedSymbol
+              )
+              HIGH = T.let(
+                :high,
+                OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity::TaggedSymbol
+              )
+
+              sig {
+                override.returns(
+                  T::Array[
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Complexity::TaggedSymbol
+                  ]
+                )
+              }
+              def self.values
+              end
+            end
+
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. Supports `high` and `low` on
             # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
@@ -1768,8 +1896,8 @@ module OpenAI
             # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
             # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
             # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
-            # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
-            # `gpt-image-2`.
+            # `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-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
             # `gpt-image-2.5-flare` instead.
@@ -1829,6 +1957,14 @@ module OpenAI
                 :"gpt-image-2.5-flare-2026-09-08",
                 OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::TaggedSymbol
               )
+              GPT_IMAGE_2_6_SUNBURST = T.let(
+                :"gpt-image-2.6-sunburst",
+                OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::TaggedSymbol
+              )
+              GPT_IMAGE_2_6_FLARE = T.let(
+                :"gpt-image-2.6-flare",
+                OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::TaggedSymbol
+              )
               GPT_IMAGE_1_5 = T.let(
                 :"gpt-image-1.5",
                 OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::TaggedSymbol
@@ -1869,8 +2005,12 @@ module OpenAI
               end
             end
 
-            # The output format of the generated image. One of `png`, `webp`, or `jpeg`.
-            # Default: `png`.
+            # The output format of the generated image. One of `png`, `webp`, `jpeg`, `gif`,
+            # or `svg`. Default: `png`. GIF and SVG output require a model that supports the
+            # selected format. GIF output does not support partial image streaming
+            # (`partial_images` greater than `0`), `input_image_mask`, or custom
+            # `output_compression`. Responses lifecycle events can still be streamed for GIF
+            # output.
             module OutputFormat
               extend OpenAI::Internal::Type::Enum
 
@@ -1891,6 +2031,14 @@ module OpenAI
                 :jpeg,
                 OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::OutputFormat::TaggedSymbol
               )
+              GIF = T.let(
+                :gif,
+                OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::OutputFormat::TaggedSymbol
+              )
+              SVG = T.let(
+                :svg,
+                OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::OutputFormat::TaggedSymbol
+              )
 
               sig {
                 override.returns(
@@ -2003,6 +2151,185 @@ module OpenAI
               )
 
             end
+
+            class Svg < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              sig { returns(T.nilable(String)) }
+              attr_reader :model
+
+              sig { params(model: String).void }
+              attr_writer :model
+
+              # Reasoning effort for SVG authoring. When omitted, uses the author model's
+              # default in both Images and Responses.
+              sig {
+                returns(
+                  T.nilable(OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning)
+                )
+              }
+              attr_reader :reasoning
+
+              sig {
+                params(
+                  reasoning: T.nilable(
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::OrHash
+                  )
+                )
+                  .void
+              }
+              attr_writer :reasoning
+
+              # SVG author model settings. Requires `output_format` to be `svg`. When SVG model
+              # selection is enabled, omitting this object uses the outer response model.
+              # Otherwise, the default SVG author is used and explicit model overrides are
+              # unavailable.
+              sig do
+                params(
+
+                  model: String,
+
+                  reasoning: T.nilable(
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::OrHash
+                  )
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                model: nil,
+
+                # Reasoning effort for SVG authoring. When omitted, uses the author model's
+                # default in both Images and Responses.
+
+                reasoning: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    model: String,
+                    reasoning: T.nilable(
+                      OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning
+                    )
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Reasoning < OpenAI::Internal::Type::BaseModel
+                OrHash = T.type_alias do
+                  T.any(
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning,
+                    OpenAI::Internal::AnyHash
+                  )
+                end
+
+                # Controls how much effort the model should spend on reasoning for this request.
+                sig {
+                  returns(
+                    T.nilable(
+                      OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::OrSymbol
+                    )
+                  )
+                }
+                attr_reader :effort
+
+                sig {
+                  params(
+                    effort: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::OrSymbol
+                  )
+                    .void
+                }
+                attr_writer :effort
+
+                # Reasoning effort for SVG authoring. When omitted, uses the author model's
+                # default in both Images and Responses.
+                sig do
+                  params(
+
+                    effort: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::OrSymbol
+                  )
+                    .returns(T.attached_class)
+                end
+                def self.new(
+
+                  # Controls how much effort the model should spend on reasoning for this request.
+
+                  effort: nil
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      effort: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::OrSymbol
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                # Controls how much effort the model should spend on reasoning for this request.
+                module Effort
+                  extend OpenAI::Internal::Type::Enum
+
+                  TaggedSymbol = T.type_alias {
+                    T.all(
+                      Symbol,
+                      OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  NONE = T.let(
+                    :none,
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::TaggedSymbol
+                  )
+                  MINIMAL = T.let(
+                    :minimal,
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::TaggedSymbol
+                  )
+                  LOW = T.let(
+                    :low,
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::TaggedSymbol
+                  )
+                  MEDIUM = T.let(
+                    :medium,
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::TaggedSymbol
+                  )
+                  HIGH = T.let(
+                    :high,
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::TaggedSymbol
+                  )
+                  XHIGH = T.let(
+                    :xhigh,
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::TaggedSymbol
+                  )
+                  MAX = T.let(
+                    :max,
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Svg::Reasoning::Effort::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
+              end
+            end
           end
 
           class LocalShell < OpenAI::Internal::Type::BaseModel

data/rbi/openai/models/responses/response_usage.rbi

@@ -108,13 +108,26 @@ module OpenAI
           sig { returns(Integer) }
           attr_accessor :cached_tokens
 
+          sig { returns(T.nilable(OpenAI::Responses::ResponseUsage::InputTokensDetails::CacheWriteTokensDetails)) }
+          attr_reader :cache_write_tokens_details
+
+          sig {
+            params(
+              cache_write_tokens_details: OpenAI::Responses::ResponseUsage::InputTokensDetails::CacheWriteTokensDetails::OrHash
+            )
+              .void
+          }
+          attr_writer :cache_write_tokens_details
+
           # A detailed breakdown of the input tokens.
           sig do
             params(
 
               cache_write_tokens: Integer,
 
-              cached_tokens: Integer
+              cached_tokens: Integer,
+
+              cache_write_tokens_details: OpenAI::Responses::ResponseUsage::InputTokensDetails::CacheWriteTokensDetails::OrHash
             )
               .returns(T.attached_class)
           end
@@ -125,19 +138,69 @@ module OpenAI
 
             # The number of tokens that were retrieved from the cache.
             # [More on prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching).
+            cached_tokens:,
 
-            cached_tokens:
+            cache_write_tokens_details: nil
           )
           end
 
           sig do
             override.returns(
-              {cache_write_tokens: Integer, cached_tokens: Integer}
+              {
+                cache_write_tokens: Integer,
+                cached_tokens: Integer,
+                cache_write_tokens_details: OpenAI::Responses::ResponseUsage::InputTokensDetails::CacheWriteTokensDetails
+              }
             )
           end
           def to_hash
           end
 
+          class CacheWriteTokensDetails < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseUsage::InputTokensDetails::CacheWriteTokensDetails,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The number of input tokens written with 12-hour retention.
+            sig { returns(Integer) }
+            attr_accessor :ttl_12h_tokens
+
+            # The number of input tokens written with 30-minute retention.
+            sig { returns(Integer) }
+            attr_accessor :ttl_30m_tokens
+
+            sig do
+              params(
+
+                ttl_12h_tokens: Integer,
+
+                ttl_30m_tokens: Integer
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The number of input tokens written with 12-hour retention.
+              ttl_12h_tokens:,
+
+              # The number of input tokens written with 30-minute retention.
+
+              ttl_30m_tokens:
+            )
+            end
+
+            sig do
+              override.returns(
+                {ttl_12h_tokens: Integer, ttl_30m_tokens: Integer}
+              )
+            end
+            def to_hash
+            end
+
+          end
         end
 
         class OutputTokensDetails < OpenAI::Internal::Type::BaseModel