openai 0.113.0 → 0.115.0

data/sig/openai/models/responses/response.rbs

@@ -35,6 +35,7 @@ module OpenAI
           ?service_tier: OpenAI::Models::Responses::Response::service_tier?,
           ?status: OpenAI::Models::Responses::response_status,
           ?text: OpenAI::Responses::ResponseTextConfig,
+          ?tool_usage: OpenAI::Responses::Response::ToolUsage,
           ?top_logprobs: Integer?,
           ?truncation: OpenAI::Models::Responses::Response::truncation?,
           ?usage: OpenAI::Responses::ResponseUsage,
@@ -278,6 +279,36 @@ module OpenAI
           OpenAI::Responses::ResponseTextConfig
         ) -> OpenAI::Responses::ResponseTextConfig
 
+        # Usage reported by hosted tools, separate from base model `usage`. The field can
+        # be omitted when tool usage is unavailable. When present, tool families with no
+        # recorded usage have zero counts.
+        #
+        # `image_gen` sums available token counts across image generation calls. Calls
+        # with missing or incomplete usage records may be skipped. Output token details
+        # and cached input counts can be omitted. An omitted cache count means cache usage
+        # is unknown.
+        #
+        # `web_search.num_requests` counts billable searches. Discounted searches and
+        # actions such as opening a page are excluded. Use billing records to reconcile
+        # final charges.
+        attr_reader tool_usage: OpenAI::Responses::Response::ToolUsage?
+
+        # Usage reported by hosted tools, separate from base model `usage`. The field can
+        # be omitted when tool usage is unavailable. When present, tool families with no
+        # recorded usage have zero counts.
+        #
+        # `image_gen` sums available token counts across image generation calls. Calls
+        # with missing or incomplete usage records may be skipped. Output token details
+        # and cached input counts can be omitted. An omitted cache count means cache usage
+        # is unknown.
+        #
+        # `web_search.num_requests` counts billable searches. Discounted searches and
+        # actions such as opening a page are excluded. Use billing records to reconcile
+        # final charges.
+        def tool_usage=: (
+          OpenAI::Responses::Response::ToolUsage
+        ) -> OpenAI::Responses::Response::ToolUsage
+
         # An integer between 0 and 20 specifying the maximum number of most likely tokens
         # to return at each token position, each with an associated log probability. In
         # some cases, the number of returned tokens may be fewer than requested.
@@ -491,6 +522,19 @@ module OpenAI
         #
         #   - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
         #   - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
+        # @param tool_usage
+        #   Usage reported by hosted tools, separate from base model `usage`. The field can
+        #   be omitted when tool usage is unavailable. When present, tool families with no
+        #   recorded usage have zero counts.
+        #
+        #   `image_gen` sums available token counts across image generation calls. Calls
+        #   with missing or incomplete usage records may be skipped. Output token details
+        #   and cached input counts can be omitted. An omitted cache count means cache usage
+        #   is unknown.
+        #
+        #   `web_search.num_requests` counts billable searches. Discounted searches and
+        #   actions such as opening a page are excluded. Use billing records to reconcile
+        #   final charges.
         # @param top_logprobs
         #   An integer between 0 and 20 specifying the maximum number of most likely tokens
         #   to return at each token position, each with an associated log probability. In
@@ -546,6 +590,7 @@ module OpenAI
           ?service_tier: OpenAI::Models::Responses::Response::service_tier?,
           ?status: OpenAI::Models::Responses::response_status,
           ?text: OpenAI::Responses::ResponseTextConfig,
+          ?tool_usage: OpenAI::Responses::Response::ToolUsage,
           ?top_logprobs: Integer?,
           ?truncation: OpenAI::Models::Responses::Response::truncation?,
           ?usage: OpenAI::Responses::ResponseUsage,
@@ -586,6 +631,7 @@ module OpenAI
           ?service_tier: OpenAI::Models::Responses::Response::service_tier?,
           ?status: OpenAI::Models::Responses::response_status,
           ?text: OpenAI::Responses::ResponseTextConfig,
+          ?tool_usage: OpenAI::Responses::Response::ToolUsage,
           ?top_logprobs: Integer?,
           ?truncation: OpenAI::Models::Responses::Response::truncation?,
           ?usage: OpenAI::Responses::ResponseUsage,
@@ -1175,6 +1221,183 @@ module OpenAI
           def self?.values: -> ::Array[OpenAI::Models::Responses::Response::service_tier]
         end
 
+        type tool_usage =
+          {
+            image_gen: OpenAI::Responses::Response::ToolUsage::ImageGen,
+            web_search: OpenAI::Responses::Response::ToolUsage::WebSearch
+          }
+
+        class ToolUsage < OpenAI::Internal::Type::BaseModel
+          # Aggregated usage statistics for image generation tool calls.
+          attr_accessor image_gen: OpenAI::Responses::Response::ToolUsage::ImageGen
+
+          # Aggregated billable usage statistics for web search tool calls.
+          attr_accessor web_search: OpenAI::Responses::Response::ToolUsage::WebSearch
+
+          # @param image_gen
+          #   Aggregated usage statistics for image generation tool calls.
+          # @param web_search
+          #   Aggregated billable usage statistics for web search tool calls.
+          def initialize: (
+            image_gen: OpenAI::Responses::Response::ToolUsage::ImageGen,
+            web_search: OpenAI::Responses::Response::ToolUsage::WebSearch
+          ) -> void
+
+          def to_hash: -> {
+            image_gen: OpenAI::Responses::Response::ToolUsage::ImageGen,
+            web_search: OpenAI::Responses::Response::ToolUsage::WebSearch
+          }
+
+          type image_gen =
+            {
+              input_tokens: Integer,
+              input_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::InputTokensDetails,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              ?cached_tokens: Integer,
+              ?cached_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails,
+              ?output_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails
+            }
+
+          class ImageGen < OpenAI::Internal::Type::BaseModel
+            # The number of tokens (images and text) in the input prompt.
+            attr_accessor input_tokens: Integer
+
+            # The input tokens detailed information for the image generation.
+            attr_accessor input_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::InputTokensDetails
+
+            # The number of output tokens generated by the model.
+            attr_accessor output_tokens: Integer
+
+            # The total number of tokens (images and text) used for the image generation.
+            attr_accessor total_tokens: Integer
+
+            attr_reader cached_tokens: Integer?
+
+            def cached_tokens=: (Integer) -> Integer
+
+            attr_reader cached_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails?
+
+            def cached_tokens_details=: (
+              OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails
+            ) -> OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails
+
+            # The output token details for the image generation.
+            attr_reader output_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails?
+
+            # The output token details for the image generation.
+            def output_tokens_details=: (
+              OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails
+            ) -> OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails
+
+            # @param input_tokens
+            #   The number of tokens (images and text) in the input prompt.
+            # @param input_tokens_details
+            #   The input tokens detailed information for the image generation.
+            # @param output_tokens
+            #   The number of output tokens generated by the model.
+            # @param total_tokens
+            #   The total number of tokens (images and text) used for the image generation.
+            # @param output_tokens_details
+            #   The output token details for the image generation.
+            def initialize: (
+              input_tokens: Integer,
+              input_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::InputTokensDetails,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              ?cached_tokens: Integer,
+              ?cached_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails,
+              ?output_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails
+            ) -> void
+
+            def to_hash: -> {
+              input_tokens: Integer,
+              input_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::InputTokensDetails,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              ?cached_tokens: Integer,
+              ?cached_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::CachedTokensDetails,
+              ?output_tokens_details: OpenAI::Responses::Response::ToolUsage::ImageGen::OutputTokensDetails
+            }
+
+            type input_tokens_details =
+              { image_tokens: Integer, text_tokens: Integer }
+
+            class InputTokensDetails < OpenAI::Internal::Type::BaseModel
+              # The number of image tokens in the input prompt.
+              attr_accessor image_tokens: Integer
+
+              # The number of text tokens in the input prompt.
+              attr_accessor text_tokens: Integer
+
+              # @param image_tokens
+              #   The number of image tokens in the input prompt.
+              # @param text_tokens
+              #   The number of text tokens in the input prompt.
+              def initialize: (
+                image_tokens: Integer,
+                text_tokens: Integer
+              ) -> void
+
+              def to_hash: -> { image_tokens: Integer, text_tokens: Integer }
+            end
+
+            type cached_tokens_details =
+              { cached_image_tokens: Integer, cached_text_tokens: Integer }
+
+            class CachedTokensDetails < OpenAI::Internal::Type::BaseModel
+              attr_accessor cached_image_tokens: Integer
+
+              attr_accessor cached_text_tokens: Integer
+
+              def initialize: (
+                cached_image_tokens: Integer,
+                cached_text_tokens: Integer
+              ) -> void
+
+              def to_hash: -> {
+                cached_image_tokens: Integer,
+                cached_text_tokens: Integer
+              }
+            end
+
+            type output_tokens_details =
+              { image_tokens: Integer, text_tokens: Integer }
+
+            class OutputTokensDetails < OpenAI::Internal::Type::BaseModel
+              # The number of image output tokens generated by the model.
+              attr_accessor image_tokens: Integer
+
+              # The number of text output tokens generated by the model.
+              attr_accessor text_tokens: Integer
+
+              # @param image_tokens
+              #   The number of image output tokens generated by the model.
+              # @param text_tokens
+              #   The number of text output tokens generated by the model.
+              def initialize: (
+                image_tokens: Integer,
+                text_tokens: Integer
+              ) -> void
+
+              def to_hash: -> { image_tokens: Integer, text_tokens: Integer }
+            end
+          end
+
+          type web_search = { num_requests: Integer }
+
+          class WebSearch < OpenAI::Internal::Type::BaseModel
+            # The number of billable web search requests issued.
+            attr_accessor num_requests: Integer
+
+            # @param num_requests
+            #   The number of billable web search requests issued.
+            def initialize: (num_requests: Integer) -> void
+
+            def to_hash: -> { num_requests: Integer }
+          end
+        end
+
         type truncation = :auto | :disabled
 
         module Truncation

data/sig/openai/models/responses/response_configuration_update_item.rbs

@@ -5,7 +5,8 @@ module OpenAI
         {
           id: String,
           ?type: :configuration_update,
-          ?reasoning: OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning
+          ?reasoning: OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning,
+          ?text: OpenAI::Responses::ResponseConfigurationUpdateItem::Text
         }
 
       class ResponseConfigurationUpdateItem < OpenAI::Internal::Type::BaseModel
@@ -23,22 +24,34 @@ module OpenAI
           OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning
         ) -> OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning
 
+        # The text output configuration for subsequent responses.
+        attr_reader text: OpenAI::Responses::ResponseConfigurationUpdateItem::Text?
+
+        # The text output configuration for subsequent responses.
+        def text=: (
+          OpenAI::Responses::ResponseConfigurationUpdateItem::Text
+        ) -> OpenAI::Responses::ResponseConfigurationUpdateItem::Text
+
         # @param id
         #   The unique ID of the configuration update item.
         # @param reasoning
         #   The reasoning configuration applied by this update.
+        # @param text
+        #   The text output configuration for subsequent responses.
         # @param type
         #   The item type. Always `configuration_update`.
         def initialize: (
           id: String,
           ?reasoning: OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning,
+          ?text: OpenAI::Responses::ResponseConfigurationUpdateItem::Text,
           ?type: :configuration_update
         ) -> void
 
         def to_hash: -> {
           id: String,
           ?type: :configuration_update,
-          ?reasoning: OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning
+          ?reasoning: OpenAI::Responses::ResponseConfigurationUpdateItem::Reasoning,
+          ?text: OpenAI::Responses::ResponseConfigurationUpdateItem::Text
         }
 
         type reasoning = { ?effort: OpenAI::Models::reasoning_effort? }
@@ -55,6 +68,36 @@ module OpenAI
 
           def to_hash: -> { ?effort: OpenAI::Models::reasoning_effort? }
         end
+
+        type text =
+          {
+            format_: OpenAI::Models::Responses::ResponseConfigurationUpdateItem::Text::format_
+          }
+
+        class Text < OpenAI::Internal::Type::BaseModel
+          # Use a JSON schema for structured output or text to return to plain text.
+          attr_accessor format_: OpenAI::Models::Responses::ResponseConfigurationUpdateItem::Text::format_
+
+          # @param format_
+          #   Use a JSON schema for structured output or text to return to plain text.
+          def initialize: (
+            format_: OpenAI::Models::Responses::ResponseConfigurationUpdateItem::Text::format_
+          ) -> void
+
+          def to_hash: -> {
+            format_: OpenAI::Models::Responses::ResponseConfigurationUpdateItem::Text::format_
+          }
+
+          type format_ =
+            OpenAI::ResponseFormatText
+            | OpenAI::Responses::ResponseFormatTextJSONSchemaConfig
+
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            def self?.variants: -> ::Array[OpenAI::Models::Responses::ResponseConfigurationUpdateItem::Text::format_]
+          end
+        end
       end
     end
   end

data/sig/openai/models/responses/response_configuration_update_item_param.rbs

@@ -5,7 +5,8 @@ module OpenAI
         {
           ?type: :configuration_update,
           ?id: String?,
-          ?reasoning: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning
+          ?reasoning: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning,
+          ?text: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text
         }
 
       class ResponseConfigurationUpdateItemParam < OpenAI::Internal::Type::BaseModel
@@ -23,22 +24,34 @@ module OpenAI
           OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning
         ) -> OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning
 
+        # The text output configuration for subsequent responses.
+        attr_reader text: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text?
+
+        # The text output configuration for subsequent responses.
+        def text=: (
+          OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text
+        ) -> OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text
+
         # @param id
         #   The unique ID of the configuration update item.
         # @param reasoning
         #   Updates to reasoning configuration. Only effort is supported.
+        # @param text
+        #   The text output configuration for subsequent responses.
         # @param type
         #   The item type. Always `configuration_update`.
         def initialize: (
           ?id: String?,
           ?reasoning: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning,
+          ?text: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text,
           ?type: :configuration_update
         ) -> void
 
         def to_hash: -> {
           ?type: :configuration_update,
           ?id: String?,
-          ?reasoning: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning
+          ?reasoning: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Reasoning,
+          ?text: OpenAI::Responses::ResponseConfigurationUpdateItemParam::Text
         }
 
         type reasoning = { ?effort: OpenAI::Models::reasoning_effort? }
@@ -55,6 +68,36 @@ module OpenAI
 
           def to_hash: -> { ?effort: OpenAI::Models::reasoning_effort? }
         end
+
+        type text =
+          {
+            format_: OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam::Text::format_
+          }
+
+        class Text < OpenAI::Internal::Type::BaseModel
+          # Use a JSON schema for structured output or text to return to plain text.
+          attr_accessor format_: OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam::Text::format_
+
+          # @param format_
+          #   Use a JSON schema for structured output or text to return to plain text.
+          def initialize: (
+            format_: OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam::Text::format_
+          ) -> void
+
+          def to_hash: -> {
+            format_: OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam::Text::format_
+          }
+
+          type format_ =
+            OpenAI::ResponseFormatText
+            | OpenAI::Responses::ResponseFormatTextJSONSchemaConfig
+
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            def self?.variants: -> ::Array[OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam::Text::format_]
+          end
+        end
       end
     end
   end

data/sig/openai/models/responses/response_create_params.rbs

@@ -293,7 +293,9 @@ module OpenAI
         # can call.
         def tool_choice=: (
           OpenAI::Models::Responses::ResponseCreateParams::tool_choice
-        ) -> OpenAI::Models::Responses::ResponseCreateParams::tool_choice
+          | { type: :programmatic_tool_calling }
+        ) -> (OpenAI::Models::Responses::ResponseCreateParams::tool_choice
+        | { type: :programmatic_tool_calling })
 
         # An array of tools the model may call while generating a response. You can
         # specify which tool to use by setting the `tool_choice` parameter.
@@ -619,7 +621,8 @@ module OpenAI
           ?stream_options: OpenAI::Responses::ResponseCreateParams::StreamOptions?,
           ?temperature: Float?,
           ?text: OpenAI::Responses::ResponseTextConfig,
-          ?tool_choice: OpenAI::Models::Responses::ResponseCreateParams::tool_choice,
+          ?tool_choice: OpenAI::Models::Responses::ResponseCreateParams::tool_choice
+          | { type: :programmatic_tool_calling },
           ?tools: ::Array[OpenAI::Models::Responses::tool],
           ?top_logprobs: Integer?,
           ?top_p: Float?,

data/sig/openai/models/responses/response_input_file.rbs

@@ -53,14 +53,14 @@ module OpenAI
         # The name of the file to be sent to the model.
         def filename=: (String) -> String
 
-        # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        # token block.
+        # Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        # breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        # not rounded to a token block.
         attr_reader prompt_cache_breakpoint: OpenAI::Responses::ResponseInputFile::PromptCacheBreakpoint?
 
-        # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        # token block.
+        # Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        # breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        # not rounded to a token block.
         def prompt_cache_breakpoint=: (
           OpenAI::Responses::ResponseInputFile::PromptCacheBreakpoint
         ) -> OpenAI::Responses::ResponseInputFile::PromptCacheBreakpoint
@@ -80,9 +80,9 @@ module OpenAI
         # @param filename
         #   The name of the file to be sent to the model.
         # @param prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         # @param type
         #   The type of the input item. Always `input_file`.
         def initialize: (

data/sig/openai/models/responses/response_input_file_content.rbs

@@ -44,9 +44,9 @@ module OpenAI
         # The name of the file to be sent to the model.
         attr_accessor filename: String?
 
-        # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        # token block.
+        # Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        # breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        # not rounded to a token block.
         attr_accessor prompt_cache_breakpoint: OpenAI::Responses::ResponseInputFileContent::PromptCacheBreakpoint?
 
         # @param detail
@@ -64,9 +64,9 @@ module OpenAI
         # @param filename
         #   The name of the file to be sent to the model.
         # @param prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         # @param type
         #   The type of the input item. Always `input_file`.
         def initialize: (

data/sig/openai/models/responses/response_input_image.rbs

@@ -25,14 +25,14 @@ module OpenAI
         # encoded image in a data URL.
         attr_accessor image_url: String?
 
-        # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        # token block.
+        # Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        # breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        # not rounded to a token block.
         attr_reader prompt_cache_breakpoint: OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint?
 
-        # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        # token block.
+        # Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        # breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        # not rounded to a token block.
         def prompt_cache_breakpoint=: (
           OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint
         ) -> OpenAI::Responses::ResponseInputImage::PromptCacheBreakpoint
@@ -46,9 +46,9 @@ module OpenAI
         #   The URL of the image to be sent to the model. A fully qualified URL or base64
         #   encoded image in a data URL.
         # @param prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         # @param type
         #   The type of the input item. Always `input_image`.
         def initialize: (

data/sig/openai/models/responses/response_input_image_content.rbs

@@ -25,9 +25,9 @@ module OpenAI
         # encoded image in a data URL.
         attr_accessor image_url: String?
 
-        # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        # token block.
+        # Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        # breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        # not rounded to a token block.
         attr_accessor prompt_cache_breakpoint: OpenAI::Responses::ResponseInputImageContent::PromptCacheBreakpoint?
 
         # @param detail
@@ -39,9 +39,9 @@ module OpenAI
         #   The URL of the image to be sent to the model. A fully qualified URL or base64
         #   encoded image in a data URL.
         # @param prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         # @param type
         #   The type of the input item. Always `input_image`.
         def initialize: (

data/sig/openai/models/responses/response_input_text.rbs

@@ -15,14 +15,14 @@ module OpenAI
         # The type of the input item. Always `input_text`.
         attr_accessor type: :input_text
 
-        # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        # token block.
+        # Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        # breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        # not rounded to a token block.
         attr_reader prompt_cache_breakpoint: OpenAI::Responses::ResponseInputText::PromptCacheBreakpoint?
 
-        # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        # token block.
+        # Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        # breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        # not rounded to a token block.
         def prompt_cache_breakpoint=: (
           OpenAI::Responses::ResponseInputText::PromptCacheBreakpoint
         ) -> OpenAI::Responses::ResponseInputText::PromptCacheBreakpoint
@@ -30,9 +30,9 @@ module OpenAI
         # @param text
         #   The text input to the model.
         # @param prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         # @param type
         #   The type of the input item. Always `input_text`.
         def initialize: (

data/sig/openai/models/responses/response_input_text_content.rbs

@@ -15,17 +15,17 @@ module OpenAI
         # The type of the input item. Always `input_text`.
         attr_accessor type: :input_text
 
-        # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        # token block.
+        # Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        # breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        # not rounded to a token block.
         attr_accessor prompt_cache_breakpoint: OpenAI::Responses::ResponseInputTextContent::PromptCacheBreakpoint?
 
         # @param text
         #   The text input to the model.
         # @param prompt_cache_breakpoint
-        #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
-        #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
-        #   token block.
+        #   Marks the exact end of a reusable prompt prefix. When `ttl` is omitted, the
+        #   breakpoint inherits the request's `prompt_cache_options.ttl`; the boundary is
+        #   not rounded to a token block.
         # @param type
         #   The type of the input item. Always `input_text`.
         def initialize: (

data/sig/openai/models/responses/response_tool_search_output_item_param.rbs

@@ -710,8 +710,8 @@ module OpenAI
 
             # 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` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            # this parameter. Defaults to `low` on supported models.
             attr_accessor input_fidelity: OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::input_fidelity?
 
             # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -833,8 +833,8 @@ module OpenAI
             # @param input_fidelity
             #   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` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            #   `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            #   this parameter. Defaults to `low` on supported models.
             # @param input_image_mask
             #   Optional mask for inpainting. Contains `image_url` (string, optional) and
             #   `file_id` (string, optional).