openai 0.110.0 → 0.112.0

data/lib/openai/resources/decisions.rb

@@ -8,17 +8,16 @@ module OpenAI
       #
       # @overload create(input:, model:, questions:, prompt_cache_key: nil, prompt_cache_options: nil, safety_identifier: nil, request_options: {})
       #
-      # @param input [String, Array<OpenAI::Models::DecisionInputMessage>]
-      #   The text or images to evaluate for every question. Provide a text string or user
-      #   messages containing text and images. Images can be base64 data URLs or publicly
-      #   accessible HTTP(S) URLs; at most 128 images are allowed across all messages in
-      #   one request. Files, audio, tools, and item references are not supported.
+      # @param input [String, Array<OpenAI::Models::decision_input_message, OpenAI::Models::DecisionCreateParams::Input::UnionMember1::DecisionInputDeveloperMessage, OpenAI::Models::DecisionCreateParams::Input::UnionMember1::DecisionInputSystemMessage, OpenAI::Models::DecisionCreateParams::Input::UnionMember1::DecisionInputAssistantMessage, OpenAI::Models::DecisionCreateParams::Input::UnionMember1::FunctionCall, OpenAI::Models::DecisionCreateParams::Input::UnionMember1::FunctionCallOutput, OpenAI::Models::DecisionCreateParams::Input::UnionMember1::CustomToolCall, OpenAI::Models::DecisionCreateParams::Input::UnionMember1::CustomToolCallOutput>]
+      #   The input to evaluate for every question. Provide a text string or an ordered
+      #   array of messages, function calls and outputs, or custom tool calls and outputs.
+      #   Each tool output must identify a matching call by call ID.
       #
       # @param model [String]
       #   The model to use. Only `gpt-6-luna` is supported.
       #
       # @param questions [Array<OpenAI::Models::DecisionCreateParams::Question::Predicate, OpenAI::Models::DecisionCreateParams::Question::Choice, OpenAI::Models::DecisionCreateParams::Question::Score>]
-      #   Ask 1–200 questions about the input. Each question can be a predicate, choice,
+      #   Ask 1–400 questions about the input. Each question can be a predicate, choice,
       #   or score. Answers come back in the same order.
       #
       # @param prompt_cache_key [String, nil]

data/lib/openai/resources/images.rb

@@ -120,12 +120,15 @@ module OpenAI
       #   content type.
       #
       # @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
-      #   The GPT image model to use for image editing (`gpt-image-1`, `gpt-image-1-mini`,
+      #   The GPT image model to use for image editing (`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`).
       #
+      #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+      #   `gpt-image-2.5-flare` instead.
+      #
       # @param n [Integer, nil]
       #   The number of images to generate. Must be between 1 and 10.
       #
@@ -265,12 +268,15 @@ module OpenAI
       #   content type.
       #
       # @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
-      #   The GPT image model to use for image editing (`gpt-image-1`, `gpt-image-1-mini`,
+      #   The GPT image model to use for image editing (`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`).
       #
+      #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+      #   `gpt-image-2.5-flare` instead.
+      #
       # @param n [Integer, nil]
       #   The number of images to generate. Must be between 1 and 10.
       #
@@ -383,11 +389,14 @@ module OpenAI
       #
       # @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
       #   The GPT image model to use for image generation. Specify a model explicitly.
-      #   Supported models include `gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-      #   `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+      #   Supported models include `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`, and `chatgpt-image-latest`.
       #
+      #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+      #   `gpt-image-2.5-flare` instead.
+      #
       # @param moderation [Symbol, OpenAI::Models::ImageGenerateParams::Moderation, nil]
       #   Control the content-moderation level for images generated by the GPT image
       #   models. Must be either `low` for less restrictive filtering or `auto` (default
@@ -502,11 +511,14 @@ module OpenAI
       #
       # @param model [String, Symbol, OpenAI::Models::ImageModel, nil]
       #   The GPT image model to use for image generation. Specify a model explicitly.
-      #   Supported models include `gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-      #   `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+      #   Supported models include `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`, and `chatgpt-image-latest`.
       #
+      #   `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+      #   `gpt-image-2.5-flare` instead.
+      #
       # @param moderation [Symbol, OpenAI::Models::ImageGenerateParams::Moderation, nil]
       #   Control the content-moderation level for images generated by the GPT image
       #   models. Must be either `low` for less restrictive filtering or `auto` (default

data/lib/openai/resources/live/forks.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-require_relative "../../helpers/websocket/resource"
+require_relative "../../helpers/websocket/typed_resource"
 
 module OpenAI
   module Resources
     class Live
       class Forks
-        include OpenAI::WebSocket::Resource
+        include OpenAI::WebSocket::TypedResource
 
         # @api private
         def __websocket_request(session_id, query: {})

data/lib/openai/resources/live/sideband.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-require_relative "../../helpers/websocket/resource"
+require_relative "../../helpers/websocket/typed_resource"
 
 module OpenAI
   module Resources
     class Live
       class Sideband
-        include OpenAI::WebSocket::Resource
+        include OpenAI::WebSocket::TypedResource
 
         # @api private
         def __websocket_request(session_id, query: {})

data/lib/openai/resources/live.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-require_relative "../helpers/websocket/resource"
+require_relative "../helpers/websocket/typed_resource"
 
 module OpenAI
   module Resources
     class Live
-      include OpenAI::WebSocket::Resource
+      include OpenAI::WebSocket::TypedResource
 
       # @api private
       def __websocket_request(query: {})

data/lib/openai/resources/realtime/translations.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-require_relative "../../helpers/websocket/resource"
+require_relative "../../helpers/websocket/typed_resource"
 
 module OpenAI
   module Resources
     class Realtime
       class Translations
-        include OpenAI::WebSocket::Resource
+        include OpenAI::WebSocket::TypedResource
 
         # @api private
         def __websocket_request(query: {})

data/lib/openai/resources/realtime.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-require_relative "../helpers/websocket/resource"
+require_relative "../helpers/websocket/typed_resource"
 
 module OpenAI
   module Resources
     class Realtime
-      include OpenAI::WebSocket::Resource
+      include OpenAI::WebSocket::TypedResource
 
       # @api private
       def __websocket_request(query: {})

data/lib/openai/resources/responses.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
 require_relative "../helpers/streaming/response_stream_resource"
-require_relative "../helpers/websocket/resource"
+require_relative "../helpers/websocket/typed_resource"
 require_relative "../helpers/structured_output/response_parser"
 
 module OpenAI
   module Resources
     # Create and manage model responses.
     class Responses
-      include OpenAI::WebSocket::Resource
+      include OpenAI::WebSocket::TypedResource
 
       # @api private
       def __websocket_request(query: {})

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.110.0"
+  VERSION = "0.112.0"
 end

data/lib/openai.rb

@@ -980,10 +980,14 @@ require_relative "openai/models/custom_tool_input_format"
 require_relative "openai/models/decision"
 require_relative "openai/models/decision_create_params"
 require_relative "openai/models/decision_input_image"
+require_relative "openai/models/decision_input_json"
 require_relative "openai/models/decision_input_message"
 require_relative "openai/models/decision_input_part"
 require_relative "openai/models/decision_input_text"
 require_relative "openai/models/decision_prompt_cache_breakpoint"
+require_relative "openai/models/decision_question_input_image"
+require_relative "openai/models/decision_question_input_part"
+require_relative "openai/models/decision_question_input_text"
 require_relative "openai/models/deleted_skill"
 require_relative "openai/models/embedding"
 require_relative "openai/models/embedding_create_params"
@@ -1089,15 +1093,27 @@ require_relative "openai/models/live/commentary_appended_event"
 require_relative "openai/models/live/commentary_append_event"
 require_relative "openai/models/live/custom_voice"
 require_relative "openai/models/live/data_channel_config"
+require_relative "openai/models/live/decision_assistant_message"
+require_relative "openai/models/live/decision_choice_option"
 require_relative "openai/models/live/decision_create_event"
+require_relative "openai/models/live/decision_developer_message"
 require_relative "openai/models/live/decision_event"
+require_relative "openai/models/live/decision_input_text"
 require_relative "openai/models/live/decision_item_created_event"
 require_relative "openai/models/live/decision_item_create_event"
 require_relative "openai/models/live/decision_item_deleted_event"
 require_relative "openai/models/live/decision_item_delete_event"
+require_relative "openai/models/live/decision_json_object"
+require_relative "openai/models/live/decision_question"
 require_relative "openai/models/live/decisions_delegation_config"
 require_relative "openai/models/live/decisions_delegation_update_config"
+require_relative "openai/models/live/decision_stored_assistant_message"
+require_relative "openai/models/live/decision_stored_developer_message"
+require_relative "openai/models/live/decision_stored_system_message"
+require_relative "openai/models/live/decision_stored_user_message"
+require_relative "openai/models/live/decision_system_message"
 require_relative "openai/models/live/decision_trigger"
+require_relative "openai/models/live/decision_user_message"
 require_relative "openai/models/live/delegation_created_event"
 require_relative "openai/models/live/error"
 require_relative "openai/models/live/error_event"

data/rbi/openai/models/beta/agent.rbi

@@ -107,7 +107,8 @@ module OpenAI
                 OpenAI::Beta::PersistedAgentTool::ProgrammaticToolCalling::OrHash,
                 OpenAI::Beta::PersistedAgentTool::Mcp::OrHash,
                 OpenAI::Beta::PersistedAgentTool::WebSearch::OrHash,
-                OpenAI::Beta::PersistedAgentTool::ComputerUse::OrHash
+                OpenAI::Beta::PersistedAgentTool::ComputerUse::OrHash,
+                OpenAI::Beta::PersistedAgentTool::Automations::OrHash
               )
             ],
 

data/rbi/openai/models/beta/agent_create_params.rbi

@@ -74,7 +74,8 @@ module OpenAI
                   OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling,
                   OpenAI::Beta::PersistedAgentToolParam::Mcp,
                   OpenAI::Beta::PersistedAgentToolParam::WebSearch,
-                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse
+                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse,
+                  OpenAI::Beta::PersistedAgentToolParam::Automations
                 )
               ]
             )
@@ -109,7 +110,8 @@ module OpenAI
                   OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling::OrHash,
                   OpenAI::Beta::PersistedAgentToolParam::Mcp::OrHash,
                   OpenAI::Beta::PersistedAgentToolParam::WebSearch::OrHash,
-                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse::OrHash
+                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::Automations::OrHash
                 )
               ]
             ),
@@ -175,7 +177,8 @@ module OpenAI
                     OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling,
                     OpenAI::Beta::PersistedAgentToolParam::Mcp,
                     OpenAI::Beta::PersistedAgentToolParam::WebSearch,
-                    OpenAI::Beta::PersistedAgentToolParam::ComputerUse
+                    OpenAI::Beta::PersistedAgentToolParam::ComputerUse,
+                    OpenAI::Beta::PersistedAgentToolParam::Automations
                   )
                 ]
               ),

data/rbi/openai/models/beta/agent_session.rbi

@@ -267,7 +267,8 @@ module OpenAI
                   OpenAI::Beta::AgentTool::ProgrammaticToolCalling::OrHash,
                   OpenAI::Beta::AgentTool::Mcp::OrHash,
                   OpenAI::Beta::AgentTool::WebSearch::OrHash,
-                  OpenAI::Beta::AgentTool::ComputerUse::OrHash
+                  OpenAI::Beta::AgentTool::ComputerUse::OrHash,
+                  OpenAI::Beta::AgentTool::Automations::OrHash
                 )
               ]
             )

data/rbi/openai/models/beta/agent_tool.rbi

@@ -15,7 +15,8 @@ module OpenAI
             OpenAI::Beta::AgentTool::ProgrammaticToolCalling,
             OpenAI::Beta::AgentTool::Mcp,
             OpenAI::Beta::AgentTool::WebSearch,
-            OpenAI::Beta::AgentTool::ComputerUse
+            OpenAI::Beta::AgentTool::ComputerUse,
+            OpenAI::Beta::AgentTool::Automations
           )
         end
 
@@ -503,6 +504,44 @@ module OpenAI
 
         end
 
+        class Automations < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::AgentTool::Automations,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # The type of the object. Always `automations`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          # Lets the agent manage its own scheduled wakeups.
+          sig do
+            params(
+
+              type: Symbol
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # The type of the object. Always `automations`.
+
+            type: :automations
+          )
+          end
+
+          sig do
+            override.returns(
+              {type: Symbol}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
         sig { override.returns(T::Array[OpenAI::Beta::AgentTool::Variants]) }
         def self.variants
         end

data/rbi/openai/models/beta/agent_tool_param.rbi

@@ -16,7 +16,8 @@ module OpenAI
             OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling,
             OpenAI::Beta::AgentToolParam::Mcp,
             OpenAI::Beta::AgentToolParam::WebSearch,
-            OpenAI::Beta::AgentToolParam::ComputerUse
+            OpenAI::Beta::AgentToolParam::ComputerUse,
+            OpenAI::Beta::AgentToolParam::Automations
           )
         end
 
@@ -575,6 +576,44 @@ module OpenAI
 
         end
 
+        class Automations < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::AgentToolParam::Automations,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # The type of the object. Always `automations`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          # Lets the agent manage its own scheduled wakeups.
+          sig do
+            params(
+
+              type: Symbol
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # The type of the object. Always `automations`.
+
+            type: :automations
+          )
+          end
+
+          sig do
+            override.returns(
+              {type: Symbol}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
         sig { override.returns(T::Array[OpenAI::Beta::AgentToolParam::Variants]) }
         def self.variants
         end

data/rbi/openai/models/beta/agent_update_params.rbi

@@ -80,7 +80,8 @@ module OpenAI
                   OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling,
                   OpenAI::Beta::PersistedAgentToolParam::Mcp,
                   OpenAI::Beta::PersistedAgentToolParam::WebSearch,
-                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse
+                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse,
+                  OpenAI::Beta::PersistedAgentToolParam::Automations
                 )
               ]
             )
@@ -117,7 +118,8 @@ module OpenAI
                   OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling::OrHash,
                   OpenAI::Beta::PersistedAgentToolParam::Mcp::OrHash,
                   OpenAI::Beta::PersistedAgentToolParam::WebSearch::OrHash,
-                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse::OrHash
+                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::Automations::OrHash
                 )
               ]
             ),
@@ -186,7 +188,8 @@ module OpenAI
                     OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling,
                     OpenAI::Beta::PersistedAgentToolParam::Mcp,
                     OpenAI::Beta::PersistedAgentToolParam::WebSearch,
-                    OpenAI::Beta::PersistedAgentToolParam::ComputerUse
+                    OpenAI::Beta::PersistedAgentToolParam::ComputerUse,
+                    OpenAI::Beta::PersistedAgentToolParam::Automations
                   )
                 ]
               ),

data/rbi/openai/models/beta/agents/session_create_params.rbi

@@ -212,7 +212,8 @@ module OpenAI
                       OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling,
                       OpenAI::Beta::AgentToolParam::Mcp,
                       OpenAI::Beta::AgentToolParam::WebSearch,
-                      OpenAI::Beta::AgentToolParam::ComputerUse
+                      OpenAI::Beta::AgentToolParam::ComputerUse,
+                      OpenAI::Beta::AgentToolParam::Automations
                     )
                   ]
                 )
@@ -245,7 +246,8 @@ module OpenAI
                       OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling::OrHash,
                       OpenAI::Beta::AgentToolParam::Mcp::OrHash,
                       OpenAI::Beta::AgentToolParam::WebSearch::OrHash,
-                      OpenAI::Beta::AgentToolParam::ComputerUse::OrHash
+                      OpenAI::Beta::AgentToolParam::ComputerUse::OrHash,
+                      OpenAI::Beta::AgentToolParam::Automations::OrHash
                     )
                   ]
                 )
@@ -299,7 +301,8 @@ module OpenAI
                         OpenAI::Beta::AgentToolParam::ProgrammaticToolCalling,
                         OpenAI::Beta::AgentToolParam::Mcp,
                         OpenAI::Beta::AgentToolParam::WebSearch,
-                        OpenAI::Beta::AgentToolParam::ComputerUse
+                        OpenAI::Beta::AgentToolParam::ComputerUse,
+                        OpenAI::Beta::AgentToolParam::Automations
                       )
                     ]
                   )

data/rbi/openai/models/beta/beta_response_input_file.rbi

@@ -167,18 +167,30 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :mode
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          sig { returns(T.nilable(OpenAI::Beta::BetaResponseInputFile::PromptCacheBreakpoint::Ttl::OrSymbol)) }
+          attr_reader :ttl
+
+          sig { params(ttl: OpenAI::Beta::BetaResponseInputFile::PromptCacheBreakpoint::Ttl::OrSymbol).void }
+          attr_writer :ttl
+
           # 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.
           sig do
             params(
 
+              ttl: OpenAI::Beta::BetaResponseInputFile::PromptCacheBreakpoint::Ttl::OrSymbol,
+
               mode: Symbol
             )
               .returns(T.attached_class)
           end
           def self.new(
 
+            # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+            ttl: nil,
+
             # The breakpoint mode. Always `explicit`.
 
             mode: :explicit
@@ -187,12 +199,30 @@ module OpenAI
 
           sig do
             override.returns(
-              {mode: Symbol}
+              {mode: Symbol, ttl: OpenAI::Beta::BetaResponseInputFile::PromptCacheBreakpoint::Ttl::OrSymbol}
             )
           end
           def to_hash
           end
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias {
+              T.all(Symbol, OpenAI::Beta::BetaResponseInputFile::PromptCacheBreakpoint::Ttl)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TTL_30M = T.let(:"30m", OpenAI::Beta::BetaResponseInputFile::PromptCacheBreakpoint::Ttl::TaggedSymbol)
+            TTL_12H = T.let(:"12h", OpenAI::Beta::BetaResponseInputFile::PromptCacheBreakpoint::Ttl::TaggedSymbol)
+
+            sig {
+              override.returns(T::Array[OpenAI::Beta::BetaResponseInputFile::PromptCacheBreakpoint::Ttl::TaggedSymbol])
+            }
+            def self.values
+            end
+          end
         end
 
       end

data/rbi/openai/models/beta/beta_response_input_file_content.rbi

@@ -165,18 +165,30 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :mode
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          sig { returns(T.nilable(OpenAI::Beta::BetaResponseInputFileContent::PromptCacheBreakpoint::Ttl::OrSymbol)) }
+          attr_reader :ttl
+
+          sig { params(ttl: OpenAI::Beta::BetaResponseInputFileContent::PromptCacheBreakpoint::Ttl::OrSymbol).void }
+          attr_writer :ttl
+
           # 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.
           sig do
             params(
 
+              ttl: OpenAI::Beta::BetaResponseInputFileContent::PromptCacheBreakpoint::Ttl::OrSymbol,
+
               mode: Symbol
             )
               .returns(T.attached_class)
           end
           def self.new(
 
+            # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+            ttl: nil,
+
             # The breakpoint mode. Always `explicit`.
 
             mode: :explicit
@@ -185,12 +197,38 @@ module OpenAI
 
           sig do
             override.returns(
-              {mode: Symbol}
+              {mode: Symbol, ttl: OpenAI::Beta::BetaResponseInputFileContent::PromptCacheBreakpoint::Ttl::OrSymbol}
             )
           end
           def to_hash
           end
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias {
+              T.all(Symbol, OpenAI::Beta::BetaResponseInputFileContent::PromptCacheBreakpoint::Ttl)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TTL_30M = T.let(
+              :"30m",
+              OpenAI::Beta::BetaResponseInputFileContent::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+            TTL_12H = T.let(
+              :"12h",
+              OpenAI::Beta::BetaResponseInputFileContent::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+
+            sig {
+              override.returns(
+                T::Array[OpenAI::Beta::BetaResponseInputFileContent::PromptCacheBreakpoint::Ttl::TaggedSymbol]
+              )
+            }
+            def self.values
+            end
+          end
         end
 
       end

data/rbi/openai/models/beta/beta_response_input_image.rbi

@@ -130,18 +130,30 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :mode
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          sig { returns(T.nilable(OpenAI::Beta::BetaResponseInputImage::PromptCacheBreakpoint::Ttl::OrSymbol)) }
+          attr_reader :ttl
+
+          sig { params(ttl: OpenAI::Beta::BetaResponseInputImage::PromptCacheBreakpoint::Ttl::OrSymbol).void }
+          attr_writer :ttl
+
           # 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.
           sig do
             params(
 
+              ttl: OpenAI::Beta::BetaResponseInputImage::PromptCacheBreakpoint::Ttl::OrSymbol,
+
               mode: Symbol
             )
               .returns(T.attached_class)
           end
           def self.new(
 
+            # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+            ttl: nil,
+
             # The breakpoint mode. Always `explicit`.
 
             mode: :explicit
@@ -150,12 +162,30 @@ module OpenAI
 
           sig do
             override.returns(
-              {mode: Symbol}
+              {mode: Symbol, ttl: OpenAI::Beta::BetaResponseInputImage::PromptCacheBreakpoint::Ttl::OrSymbol}
             )
           end
           def to_hash
           end
 
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias {
+              T.all(Symbol, OpenAI::Beta::BetaResponseInputImage::PromptCacheBreakpoint::Ttl)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TTL_30M = T.let(:"30m", OpenAI::Beta::BetaResponseInputImage::PromptCacheBreakpoint::Ttl::TaggedSymbol)
+            TTL_12H = T.let(:"12h", OpenAI::Beta::BetaResponseInputImage::PromptCacheBreakpoint::Ttl::TaggedSymbol)
+
+            sig {
+              override.returns(T::Array[OpenAI::Beta::BetaResponseInputImage::PromptCacheBreakpoint::Ttl::TaggedSymbol])
+            }
+            def self.values
+            end
+          end
         end
 
       end