openai 0.113.0 → 0.115.0

data/sig/openai/models/beta/beta_response.rbs

@@ -37,6 +37,7 @@ module OpenAI
           ?service_tier: OpenAI::Models::Beta::BetaResponse::service_tier?,
           ?status: OpenAI::Models::Beta::beta_response_status,
           ?text: OpenAI::Beta::BetaResponseTextConfig,
+          ?tool_usage: OpenAI::Beta::BetaResponse::ToolUsage,
           ?top_logprobs: Integer?,
           ?truncation: OpenAI::Models::Beta::BetaResponse::truncation?,
           ?usage: OpenAI::Beta::BetaResponseUsage,
@@ -280,6 +281,36 @@ module OpenAI
           OpenAI::Beta::BetaResponseTextConfig
         ) -> OpenAI::Beta::BetaResponseTextConfig
 
+        # 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::Beta::BetaResponse::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::Beta::BetaResponse::ToolUsage
+        ) -> OpenAI::Beta::BetaResponse::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.
@@ -493,6 +524,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
@@ -548,6 +592,7 @@ module OpenAI
           ?service_tier: OpenAI::Models::Beta::BetaResponse::service_tier?,
           ?status: OpenAI::Models::Beta::beta_response_status,
           ?text: OpenAI::Beta::BetaResponseTextConfig,
+          ?tool_usage: OpenAI::Beta::BetaResponse::ToolUsage,
           ?top_logprobs: Integer?,
           ?truncation: OpenAI::Models::Beta::BetaResponse::truncation?,
           ?usage: OpenAI::Beta::BetaResponseUsage,
@@ -588,6 +633,7 @@ module OpenAI
           ?service_tier: OpenAI::Models::Beta::BetaResponse::service_tier?,
           ?status: OpenAI::Models::Beta::beta_response_status,
           ?text: OpenAI::Beta::BetaResponseTextConfig,
+          ?tool_usage: OpenAI::Beta::BetaResponse::ToolUsage,
           ?top_logprobs: Integer?,
           ?truncation: OpenAI::Models::Beta::BetaResponse::truncation?,
           ?usage: OpenAI::Beta::BetaResponseUsage,
@@ -1572,6 +1618,183 @@ module OpenAI
           def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponse::service_tier]
         end
 
+        type tool_usage =
+          {
+            image_gen: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen,
+            web_search: OpenAI::Beta::BetaResponse::ToolUsage::WebSearch
+          }
+
+        class ToolUsage < OpenAI::Internal::Type::BaseModel
+          # Aggregated usage statistics for image generation tool calls.
+          attr_accessor image_gen: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen
+
+          # Aggregated billable usage statistics for web search tool calls.
+          attr_accessor web_search: OpenAI::Beta::BetaResponse::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::Beta::BetaResponse::ToolUsage::ImageGen,
+            web_search: OpenAI::Beta::BetaResponse::ToolUsage::WebSearch
+          ) -> void
+
+          def to_hash: -> {
+            image_gen: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen,
+            web_search: OpenAI::Beta::BetaResponse::ToolUsage::WebSearch
+          }
+
+          type image_gen =
+            {
+              input_tokens: Integer,
+              input_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::InputTokensDetails,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              ?cached_tokens: Integer,
+              ?cached_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails,
+              ?output_tokens_details: OpenAI::Beta::BetaResponse::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::Beta::BetaResponse::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::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails?
+
+            def cached_tokens_details=: (
+              OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails
+            ) -> OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails
+
+            # The output token details for the image generation.
+            attr_reader output_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails?
+
+            # The output token details for the image generation.
+            def output_tokens_details=: (
+              OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails
+            ) -> OpenAI::Beta::BetaResponse::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::Beta::BetaResponse::ToolUsage::ImageGen::InputTokensDetails,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              ?cached_tokens: Integer,
+              ?cached_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails,
+              ?output_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::OutputTokensDetails
+            ) -> void
+
+            def to_hash: -> {
+              input_tokens: Integer,
+              input_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::InputTokensDetails,
+              output_tokens: Integer,
+              total_tokens: Integer,
+              ?cached_tokens: Integer,
+              ?cached_tokens_details: OpenAI::Beta::BetaResponse::ToolUsage::ImageGen::CachedTokensDetails,
+              ?output_tokens_details: OpenAI::Beta::BetaResponse::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/beta/beta_response_configuration_update_item.rbs

@@ -8,7 +8,8 @@ module OpenAI
           id: String,
           ?type: :configuration_update,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Agent,
-          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning
+          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text
         }
 
       class BetaResponseConfigurationUpdateItem < OpenAI::Internal::Type::BaseModel
@@ -34,18 +35,29 @@ module OpenAI
           OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning
         ) -> OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning
 
+        # The text output configuration for subsequent responses.
+        attr_reader text: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text?
+
+        # The text output configuration for subsequent responses.
+        def text=: (
+          OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text
+        ) -> OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text
+
         # @param id
         #   The unique ID of the configuration update item.
         # @param agent
         #   The agent that produced this 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,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Agent,
           ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text,
           ?type: :configuration_update
         ) -> void
 
@@ -53,7 +65,8 @@ module OpenAI
           id: String,
           ?type: :configuration_update,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Agent,
-          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning
+          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text
         }
 
         type agent = { agent_name: String }
@@ -107,6 +120,49 @@ module OpenAI
             def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Reasoning::effort]
           end
         end
+
+        type text =
+          {
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::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::Beta::BetaResponseConfigurationUpdateItem::Text::format_
+
+          # @param format_
+          #   Use a JSON schema for structured output or text to return to plain text.
+          def initialize: (
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::format_
+          ) -> void
+
+          def to_hash: -> {
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::format_
+          }
+
+          type format_ =
+            OpenAI::Beta::BetaResponseConfigurationUpdateItem::Text::Format::Text
+            | OpenAI::Beta::BetaResponseFormatTextJSONSchemaConfig
+
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            type text = { ?type: :text }
+
+            class Text < OpenAI::Internal::Type::BaseModel
+              # The type of response format being defined. Always `text`.
+              attr_accessor type: :text
+
+              # @param type
+              #   The type of response format being defined. Always `text`.
+              def initialize: (?type: :text) -> void
+
+              def to_hash: -> { ?type: :text }
+            end
+
+            def self?.variants: -> ::Array[OpenAI::Models::Beta::BetaResponseConfigurationUpdateItem::Text::format_]
+          end
+        end
       end
     end
   end

data/sig/openai/models/beta/beta_response_configuration_update_item_param.rbs

@@ -8,7 +8,8 @@ module OpenAI
           ?type: :configuration_update,
           ?id: String?,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Agent?,
-          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning
+          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text
         }
 
       class BetaResponseConfigurationUpdateItemParam < OpenAI::Internal::Type::BaseModel
@@ -29,18 +30,29 @@ module OpenAI
           OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning
         ) -> OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning
 
+        # The text output configuration for subsequent responses.
+        attr_reader text: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text?
+
+        # The text output configuration for subsequent responses.
+        def text=: (
+          OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text
+        ) -> OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text
+
         # @param id
         #   The unique ID of the configuration update item.
         # @param agent
         #   The agent that produced this 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?,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Agent?,
           ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text,
           ?type: :configuration_update
         ) -> void
 
@@ -48,7 +60,8 @@ module OpenAI
           ?type: :configuration_update,
           ?id: String?,
           ?agent: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Agent?,
-          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning
+          ?reasoning: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning,
+          ?text: OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text
         }
 
         type agent = { agent_name: String }
@@ -102,6 +115,49 @@ module OpenAI
             def self?.values: -> ::Array[OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning::effort]
           end
         end
+
+        type text =
+          {
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::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::Beta::BetaResponseConfigurationUpdateItemParam::Text::format_
+
+          # @param format_
+          #   Use a JSON schema for structured output or text to return to plain text.
+          def initialize: (
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::format_
+          ) -> void
+
+          def to_hash: -> {
+            format_: OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::format_
+          }
+
+          type format_ =
+            OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text::Format::Text
+            | OpenAI::Beta::BetaResponseFormatTextJSONSchemaConfig
+
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            type text = { ?type: :text }
+
+            class Text < OpenAI::Internal::Type::BaseModel
+              # The type of response format being defined. Always `text`.
+              attr_accessor type: :text
+
+              # @param type
+              #   The type of response format being defined. Always `text`.
+              def initialize: (?type: :text) -> void
+
+              def to_hash: -> { ?type: :text }
+            end
+
+            def self?.variants: -> ::Array[OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::format_]
+          end
+        end
       end
     end
   end

data/sig/openai/models/beta/beta_response_input_file.rbs

@@ -55,14 +55,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::Beta::BetaResponseInputFile::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::Beta::BetaResponseInputFile::PromptCacheBreakpoint
         ) -> OpenAI::Beta::BetaResponseInputFile::PromptCacheBreakpoint
@@ -82,9 +82,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/beta/beta_response_input_file_content.rbs

@@ -46,9 +46,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::Beta::BetaResponseInputFileContent::PromptCacheBreakpoint?
 
         # @param detail
@@ -66,9 +66,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/beta/beta_response_input_image.rbs

@@ -27,14 +27,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::Beta::BetaResponseInputImage::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::Beta::BetaResponseInputImage::PromptCacheBreakpoint
         ) -> OpenAI::Beta::BetaResponseInputImage::PromptCacheBreakpoint
@@ -48,9 +48,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/beta/beta_response_input_image_content.rbs

@@ -27,9 +27,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::Beta::BetaResponseInputImageContent::PromptCacheBreakpoint?
 
         # @param detail
@@ -41,9 +41,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/beta/beta_response_input_text.rbs

@@ -17,14 +17,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::Beta::BetaResponseInputText::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::Beta::BetaResponseInputText::PromptCacheBreakpoint
         ) -> OpenAI::Beta::BetaResponseInputText::PromptCacheBreakpoint
@@ -32,9 +32,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/beta/beta_response_input_text_content.rbs

@@ -17,17 +17,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::Beta::BetaResponseInputTextContent::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: (