openai 0.111.0 → 0.112.0

data/rbi/openai/models/beta/beta_response_tool_search_output_item_param.rbi

@@ -1336,11 +1336,14 @@ module OpenAI
             }
             attr_writer :input_image_mask
 
-            # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-            # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
-            # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
-            # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
-            # `chatgpt-image-latest`. Default: `gpt-image-1`.
+            # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
+            # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+            # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+            # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
+            # `gpt-image-2`.
+            #
+            # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+            # `gpt-image-2.5-flare` instead.
             sig {
               returns(
                 T.nilable(
@@ -1532,11 +1535,14 @@ module OpenAI
               # `file_id` (string, optional).
               input_image_mask: nil,
 
-              # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-              # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
-              # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
-              # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
-              # `chatgpt-image-latest`. Default: `gpt-image-1`.
+              # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
+              # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+              # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+              # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
+              # `gpt-image-2`.
+              #
+              # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+              # `gpt-image-2.5-flare` instead.
               model: nil,
 
               # Moderation level for the generated image. Default: `auto`.
@@ -1766,11 +1772,14 @@ module OpenAI
 
             end
 
-            # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-            # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
-            # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
-            # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
-            # `chatgpt-image-latest`. Default: `gpt-image-1`.
+            # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
+            # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+            # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+            # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
+            # `gpt-image-2`.
+            #
+            # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+            # `gpt-image-2.5-flare` instead.
             module Model
               extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/beta/beta_tool.rbi

@@ -991,11 +991,14 @@ module OpenAI
           sig { params(input_image_mask: OpenAI::Beta::BetaTool::ImageGeneration::InputImageMask::OrHash).void }
           attr_writer :input_image_mask
 
-          # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
-          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
-          # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
-          # `chatgpt-image-latest`. Default: `gpt-image-1`.
+          # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
+          # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+          # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+          # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
+          # `gpt-image-2`.
+          #
+          # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+          # `gpt-image-2.5-flare` instead.
           sig { returns(T.nilable(T.any(String, OpenAI::Beta::BetaTool::ImageGeneration::Model::OrSymbol))) }
           attr_reader :model
 
@@ -1114,11 +1117,14 @@ module OpenAI
             # `file_id` (string, optional).
             input_image_mask: nil,
 
-            # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-            # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
-            # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
-            # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
-            # `chatgpt-image-latest`. Default: `gpt-image-1`.
+            # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
+            # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+            # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+            # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
+            # `gpt-image-2`.
+            #
+            # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+            # `gpt-image-2.5-flare` instead.
             model: nil,
 
             # Moderation level for the generated image. Default: `auto`.
@@ -1292,11 +1298,14 @@ module OpenAI
 
           end
 
-          # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
-          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
-          # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
-          # `chatgpt-image-latest`. Default: `gpt-image-1`.
+          # The image generation model to use. One of `gpt-image-1-mini`, `gpt-image-1.5`,
+          # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+          # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
+          # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`. Default:
+          # `gpt-image-2`.
+          #
+          # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
+          # `gpt-image-2.5-flare` instead.
           module Model
             extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/beta/persisted_agent_tool.rbi

@@ -16,7 +16,8 @@ module OpenAI
             OpenAI::Beta::PersistedAgentTool::ProgrammaticToolCalling,
             OpenAI::Beta::PersistedAgentTool::Mcp,
             OpenAI::Beta::PersistedAgentTool::WebSearch,
-            OpenAI::Beta::PersistedAgentTool::ComputerUse
+            OpenAI::Beta::PersistedAgentTool::ComputerUse,
+            OpenAI::Beta::PersistedAgentTool::Automations
           )
         end
 
@@ -543,6 +544,44 @@ module OpenAI
 
         end
 
+        class Automations < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::PersistedAgentTool::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::PersistedAgentTool::Variants]) }
         def self.variants
         end

data/rbi/openai/models/beta/persisted_agent_tool_param.rbi

@@ -16,7 +16,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
           )
         end
 
@@ -585,6 +586,44 @@ module OpenAI
 
         end
 
+        class Automations < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::PersistedAgentToolParam::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::PersistedAgentToolParam::Variants]) }
         def self.variants
         end

data/rbi/openai/models/chat/chat_completion_content_part.rbi

@@ -170,18 +170,34 @@ 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::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl::OrSymbol))
+            }
+            attr_reader :ttl
+
+            sig {
+              params(ttl: OpenAI::Chat::ChatCompletionContentPart::File::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::Chat::ChatCompletionContentPart::File::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
@@ -190,12 +206,38 @@ module OpenAI
 
             sig do
               override.returns(
-                {mode: Symbol}
+                {mode: Symbol, ttl: OpenAI::Chat::ChatCompletionContentPart::File::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::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl)
+              }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              TTL_30M = T.let(
+                :"30m",
+                OpenAI::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl::TaggedSymbol
+              )
+              TTL_12H = T.let(
+                :"12h",
+                OpenAI::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl::TaggedSymbol
+              )
+
+              sig {
+                override.returns(
+                  T::Array[OpenAI::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl::TaggedSymbol]
+                )
+              }
+              def self.values
+              end
+            end
           end
         end
 

data/rbi/openai/models/chat/chat_completion_content_part_image.rbi

@@ -162,18 +162,32 @@ 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::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl::OrSymbol))
+          }
+          attr_reader :ttl
+
+          sig { params(ttl: OpenAI::Chat::ChatCompletionContentPartImage::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::Chat::ChatCompletionContentPartImage::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
@@ -182,12 +196,38 @@ module OpenAI
 
           sig do
             override.returns(
-              {mode: Symbol}
+              {mode: Symbol, ttl: OpenAI::Chat::ChatCompletionContentPartImage::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::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TTL_30M = T.let(
+              :"30m",
+              OpenAI::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+            TTL_12H = T.let(
+              :"12h",
+              OpenAI::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+
+            sig {
+              override.returns(
+                T::Array[OpenAI::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl::TaggedSymbol]
+              )
+            }
+            def self.values
+            end
+          end
         end
 
       end

data/rbi/openai/models/chat/chat_completion_content_part_input_audio.rbi

@@ -157,18 +157,34 @@ 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::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl::OrSymbol))
+          }
+          attr_reader :ttl
+
+          sig {
+            params(ttl: OpenAI::Chat::ChatCompletionContentPartInputAudio::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::Chat::ChatCompletionContentPartInputAudio::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
@@ -177,12 +193,41 @@ module OpenAI
 
           sig do
             override.returns(
-              {mode: Symbol}
+              {
+                mode: Symbol,
+                ttl: OpenAI::Chat::ChatCompletionContentPartInputAudio::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::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TTL_30M = T.let(
+              :"30m",
+              OpenAI::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+            TTL_12H = T.let(
+              :"12h",
+              OpenAI::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+
+            sig {
+              override.returns(
+                T::Array[OpenAI::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl::TaggedSymbol]
+              )
+            }
+            def self.values
+            end
+          end
         end
 
       end

data/rbi/openai/models/chat/chat_completion_content_part_text.rbi

@@ -88,18 +88,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::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl::OrSymbol)) }
+          attr_reader :ttl
+
+          sig { params(ttl: OpenAI::Chat::ChatCompletionContentPartText::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::Chat::ChatCompletionContentPartText::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
@@ -108,12 +120,38 @@ module OpenAI
 
           sig do
             override.returns(
-              {mode: Symbol}
+              {mode: Symbol, ttl: OpenAI::Chat::ChatCompletionContentPartText::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::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TTL_30M = T.let(
+              :"30m",
+              OpenAI::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+            TTL_12H = T.let(
+              :"12h",
+              OpenAI::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+
+            sig {
+              override.returns(
+                T::Array[OpenAI::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl::TaggedSymbol]
+              )
+            }
+            def self.values
+            end
+          end
         end
 
       end

data/rbi/openai/models/conversations/computer_screenshot_content.rbi

@@ -130,18 +130,36 @@ 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::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::TaggedSymbol)
+            )
+          }
+          attr_reader :ttl
+
+          sig {
+            params(ttl: OpenAI::Conversations::ComputerScreenshotContent::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::Conversations::ComputerScreenshotContent::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 +168,41 @@ module OpenAI
 
           sig do
             override.returns(
-              {mode: Symbol}
+              {
+                mode: Symbol,
+                ttl: OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::TaggedSymbol
+              }
             )
           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::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl)
+            }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TTL_30M = T.let(
+              :"30m",
+              OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+            TTL_12H = T.let(
+              :"12h",
+              OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::TaggedSymbol
+            )
+
+            sig {
+              override.returns(
+                T::Array[OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl::TaggedSymbol]
+              )
+            }
+            def self.values
+            end
+          end
         end
 
       end

data/rbi/openai/models/image_edit_params.rbi

@@ -68,11 +68,14 @@ module OpenAI
       sig { params(mask: OpenAI::Internal::FileInput).void }
       attr_writer :mask
 
-      # 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.
       sig { returns(T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol))) }
       attr_accessor :model
 
@@ -230,11 +233,14 @@ module OpenAI
         # content type.
         mask: 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.
         model: nil,
 
         # The number of images to generate. Must be between 1 and 10.
@@ -390,11 +396,14 @@ module OpenAI
         end
       end
 
-      # 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.
       module Model
         extend OpenAI::Internal::Type::Union