openai 0.111.0 → 0.113.0

data/lib/openai/models/beta/beta_tool.rb

@@ -654,11 +654,14 @@ module OpenAI
           optional :input_image_mask, -> { OpenAI::Beta::BetaTool::ImageGeneration::InputImageMask }
 
           # @!attribute model
-          #   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.
           #
           #   @return [String, Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Model, nil]
           optional :model, union: -> { OpenAI::Beta::BetaTool::ImageGeneration::Model }
@@ -741,11 +744,14 @@ module OpenAI
           #     `file_id` (string, optional).
           #
           #   @param model [String, Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Model]
-          #     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.
           #
           #   @param moderation [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::Moderation]
           #     Moderation level for the generated image. Default: `auto`.
@@ -859,11 +865,14 @@ module OpenAI
             #     Base64-encoded mask image.
           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.
           #
           # @see OpenAI::Models::Beta::BetaTool::ImageGeneration#model
           module Model
@@ -904,6 +913,8 @@ module OpenAI
 
             # @!group
 
+            # @deprecated GPT Image 1 was shut down on October 23, 2026. Use gpt-image-2.5-sunburst or
+            # gpt-image-2.5-flare instead.
             GPT_IMAGE_1 = :"gpt-image-1"
             GPT_IMAGE_1_MINI = :"gpt-image-1-mini"
             GPT_IMAGE_2 = :"gpt-image-2"

data/lib/openai/models/beta/persisted_agent_tool.rb

@@ -27,6 +27,9 @@ module OpenAI
         # Browser use in an OpenAI-hosted session.
         variant :computer_use, -> { OpenAI::Beta::PersistedAgentTool::ComputerUse }
 
+        # Lets the agent manage its own scheduled wakeups.
+        variant :automations, -> { OpenAI::Beta::PersistedAgentTool::Automations }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute defer_loading
           #   Whether the function is deferred and discovered through tool search.
@@ -347,8 +350,22 @@ module OpenAI
           #     The type of the object. Always `computer_use`.
         end
 
+        class Automations < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `automations`.
+          #
+          #   @return [Symbol, :automations]
+          required :type, const: :automations
+
+          # @!method initialize(type: :automations)
+          #   Lets the agent manage its own scheduled wakeups.
+          #
+          #   @param type [Symbol, :automations]
+          #     The type of the object. Always `automations`.
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Beta::PersistedAgentTool::Function, OpenAI::Models::Beta::PersistedAgentTool::ToolSearch, OpenAI::Models::Beta::PersistedAgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentTool::Mcp, OpenAI::Models::Beta::PersistedAgentTool::WebSearch, OpenAI::Models::Beta::PersistedAgentTool::ComputerUse)]
+        #   @return [Array(OpenAI::Models::Beta::PersistedAgentTool::Function, OpenAI::Models::Beta::PersistedAgentTool::ToolSearch, OpenAI::Models::Beta::PersistedAgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentTool::Mcp, OpenAI::Models::Beta::PersistedAgentTool::WebSearch, OpenAI::Models::Beta::PersistedAgentTool::ComputerUse, OpenAI::Models::Beta::PersistedAgentTool::Automations)]
       end
     end
   end

data/lib/openai/models/beta/persisted_agent_tool_param.rb

@@ -27,6 +27,9 @@ module OpenAI
         # Browser use in an OpenAI-hosted session.
         variant :computer_use, -> { OpenAI::Beta::PersistedAgentToolParam::ComputerUse }
 
+        # Lets the agent manage its own scheduled wakeups.
+        variant :automations, -> { OpenAI::Beta::PersistedAgentToolParam::Automations }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute description
           #   A description of what the function does.
@@ -373,8 +376,22 @@ module OpenAI
           #     The type of the object. Always `computer_use`.
         end
 
+        class Automations < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `automations`.
+          #
+          #   @return [Symbol, :automations]
+          required :type, const: :automations
+
+          # @!method initialize(type: :automations)
+          #   Lets the agent manage its own scheduled wakeups.
+          #
+          #   @param type [Symbol, :automations]
+          #     The type of the object. Always `automations`.
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse)]
+        #   @return [Array(OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse, OpenAI::Models::Beta::PersistedAgentToolParam::Automations)]
       end
     end
   end

data/lib/openai/models/beta/response_compact_params.rb

@@ -180,6 +180,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_6_1_SOL }
 
+          variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_6_1_TERRA }
+
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_6_SOL }
 
           variant const: -> { OpenAI::Models::Beta::ResponseCompactParams::Model::GPT_6_LUNA }
@@ -411,6 +413,7 @@ module OpenAI
 
           GPT_6_ASTRA = :"gpt-6-astra"
           GPT_6_1_SOL = :"gpt-6.1-sol"
+          GPT_6_1_TERRA = :"gpt-6.1-terra"
           GPT_6_SOL = :"gpt-6-sol"
           GPT_6_LUNA = :"gpt-6-luna"
           GPT_5_6_SOL = :"gpt-5.6-sol"

data/lib/openai/models/beta/response_create_params.rb

@@ -767,6 +767,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_6_1_SOL }
 
+          variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_6_1_TERRA }
+
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_6_SOL }
 
           variant const: -> { OpenAI::Models::Beta::ResponseCreateParams::Model::GPT_6_LUNA }
@@ -996,6 +998,7 @@ module OpenAI
 
           GPT_6_ASTRA = :"gpt-6-astra"
           GPT_6_1_SOL = :"gpt-6.1-sol"
+          GPT_6_1_TERRA = :"gpt-6.1-terra"
           GPT_6_SOL = :"gpt-6-sol"
           GPT_6_LUNA = :"gpt-6-luna"
           GPT_5_6_SOL = :"gpt-5.6-sol"

data/lib/openai/models/chat/chat_completion_content_part.rb

@@ -99,13 +99,35 @@ module OpenAI
             #   @return [Symbol, :explicit]
             required :mode, const: :explicit
 
-            # @!method initialize(mode: :explicit)
+            # @!attribute ttl
+            #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+            #
+            #   @return [Symbol, OpenAI::Models::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl, nil]
+            optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl }
+
+            # @!method initialize(ttl: nil, mode: :explicit)
             #   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.
             #
+            #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint::Ttl]
+            #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+            #
             #   @param mode [Symbol, :explicit]
             #     The breakpoint mode. Always `explicit`.
+
+            # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+            #
+            # @see OpenAI::Models::Chat::ChatCompletionContentPart::File::PromptCacheBreakpoint#ttl
+            module Ttl
+              extend OpenAI::Internal::Type::Enum
+
+              TTL_30M = :"30m"
+              TTL_12H = :"12h"
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
           end
         end
 

data/lib/openai/models/chat/chat_completion_content_part_image.rb

@@ -88,13 +88,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   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.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Chat::ChatCompletionContentPartImage::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/chat/chat_completion_content_part_input_audio.rb

@@ -86,13 +86,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   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.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Chat::ChatCompletionContentPartInputAudio::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/chat/chat_completion_content_part_text.rb

@@ -49,13 +49,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   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.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Chat::ChatCompletionContentPartText::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/chat_model.rb

@@ -7,6 +7,7 @@ module OpenAI
 
       GPT_6_ASTRA = :"gpt-6-astra"
       GPT_6_1_SOL = :"gpt-6.1-sol"
+      GPT_6_1_TERRA = :"gpt-6.1-terra"
       GPT_6_SOL = :"gpt-6-sol"
       GPT_6_LUNA = :"gpt-6-luna"
       GPT_5_6_SOL = :"gpt-5.6-sol"

data/lib/openai/models/conversations/computer_screenshot_content.rb

@@ -87,13 +87,35 @@ module OpenAI
           #   @return [Symbol, :explicit]
           required :mode, const: :explicit
 
-          # @!method initialize(mode: :explicit)
+          # @!attribute ttl
+          #   The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          #   @return [Symbol, OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl, nil]
+          optional :ttl, enum: -> { OpenAI::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl }
+
+          # @!method initialize(ttl: nil, mode: :explicit)
           #   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.
           #
+          #   @param ttl [Symbol, OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint::Ttl]
+          #     The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
           #   @param mode [Symbol, :explicit]
           #     The breakpoint mode. Always `explicit`.
+
+          # The minimum lifetime of this cache breakpoint. Defaults to the request TTL.
+          #
+          # @see OpenAI::Models::Conversations::ComputerScreenshotContent::PromptCacheBreakpoint#ttl
+          module Ttl
+            extend OpenAI::Internal::Type::Enum
+
+            TTL_30M = :"30m"
+            TTL_12H = :"12h"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/openai/models/decision_create_params.rb

@@ -606,10 +606,12 @@ module OpenAI
               module Part
                 extend OpenAI::Internal::Type::Union
 
-                variant -> { OpenAI::DecisionInputText }
+                discriminator :type
+
+                variant :input_text, -> { OpenAI::DecisionInputText }
 
                 # An image provided as a base64 data URL or a publicly accessible HTTP(S) URL. File IDs are not supported.
-                variant -> { OpenAI::DecisionInputImage }
+                variant :input_image, -> { OpenAI::DecisionInputImage }
 
                 # @!method self.variants
                 #   @return [Array(OpenAI::Models::DecisionInputText, OpenAI::Models::DecisionInputImage)]
@@ -768,10 +770,12 @@ module OpenAI
               module Part
                 extend OpenAI::Internal::Type::Union
 
-                variant -> { OpenAI::DecisionInputText }
+                discriminator :type
+
+                variant :input_text, -> { OpenAI::DecisionInputText }
 
                 # An image provided as a base64 data URL or a publicly accessible HTTP(S) URL. File IDs are not supported.
-                variant -> { OpenAI::DecisionInputImage }
+                variant :input_image, -> { OpenAI::DecisionInputImage }
 
                 # @!method self.variants
                 #   @return [Array(OpenAI::Models::DecisionInputText, OpenAI::Models::DecisionInputImage)]

data/lib/openai/models/image_edit_params.rb

@@ -70,12 +70,15 @@ module OpenAI
       optional :mask, OpenAI::Internal::Type::FileInput
 
       # @!attribute model
-      #   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.
+      #
       #   @return [String, Symbol, OpenAI::Models::ImageModel, nil]
       optional :model, union: -> { OpenAI::ImageEditParams::Model }, nil?: true
 
@@ -215,12 +218,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.
       #
@@ -337,17 +343,27 @@ module OpenAI
         #   @return [Array<Symbol>]
       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
 
         variant String
 
-        # The GPT image model to use for image editing (`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`).
+        # 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.
         variant enum: -> { OpenAI::ImageModel }
 
         # @!method self.variants

data/lib/openai/models/image_generate_params.rb

@@ -32,11 +32,14 @@ module OpenAI
 
       # @!attribute model
       #   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.
+      #
       #   @return [String, Symbol, OpenAI::Models::ImageModel, nil]
       optional :model, union: -> { OpenAI::ImageGenerateParams::Model }, nil?: true
 
@@ -165,11 +168,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
@@ -261,16 +267,26 @@ module OpenAI
       end
 
       # 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.
       module Model
         extend OpenAI::Internal::Type::Union
 
         variant String
 
-        # 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`, `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`.
+        # The GPT image model to use for image generation. Specify a model explicitly.
+        # 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.
         variant enum: -> { OpenAI::ImageModel }
 
         # @!method self.variants

data/lib/openai/models/image_model.rb

@@ -12,6 +12,8 @@ module OpenAI
       GPT_IMAGE_2_5_SUNBURST_2026_09_08 = :"gpt-image-2.5-sunburst-2026-09-08"
       GPT_IMAGE_2_5_FLARE = :"gpt-image-2.5-flare"
       GPT_IMAGE_2_5_FLARE_2026_09_08 = :"gpt-image-2.5-flare-2026-09-08"
+      # @deprecated GPT Image 1 was shut down on October 23, 2026. Use gpt-image-2.5-sunburst or
+      # gpt-image-2.5-flare instead.
       GPT_IMAGE_1 = :"gpt-image-1"
       GPT_IMAGE_1_MINI = :"gpt-image-1-mini"
       CHATGPT_IMAGE_LATEST = :"chatgpt-image-latest"

data/lib/openai/models/live/client_delegation.rb

@@ -10,10 +10,29 @@ module OpenAI
         #   @return [Symbol, :client]
         required :type, const: :client
 
-        # @!method initialize(type: :client)
+        # @!attribute acknowledgement_delay_ms
+        #   Milliseconds to wait before requesting an automatic spoken acknowledgement for a
+        #   delegation. The model may still speak before this delay. Any commentary or
+        #   thinking appended to the session cancels all pending acknowledgements, including
+        #   those for other delegations. Defaults to 400 for Decisions sessions and 0
+        #   (request immediately) for other sessions. Omission in a session update preserves
+        #   the current value. Updates apply to subsequent delegations.
+        #
+        #   @return [Integer, nil]
+        optional :acknowledgement_delay_ms, Integer
+
+        # @!method initialize(acknowledgement_delay_ms: nil, type: :client)
         #   Delegate tasks to your application. The Live session emits delegation events
         #   that your backend handles.
         #
+        #   @param acknowledgement_delay_ms [Integer]
+        #     Milliseconds to wait before requesting an automatic spoken acknowledgement for a
+        #     delegation. The model may still speak before this delay. Any commentary or
+        #     thinking appended to the session cancels all pending acknowledgements, including
+        #     those for other delegations. Defaults to 400 for Decisions sessions and 0
+        #     (request immediately) for other sessions. Omission in a session update preserves
+        #     the current value. Updates apply to subsequent delegations.
+        #
         #   @param type [Symbol, :client]
         #     The delegation owner. Always `client` for tasks handled by your application.
       end

data/lib/openai/models/live/client_event.rb

@@ -25,19 +25,19 @@ module OpenAI
         # Mute audio input to the Live model without closing the session. The server acknowledges with `session.input_audio.muted`.
         variant :"session.input_audio.mute", -> { OpenAI::Live::InputAudioMuteEvent }
 
-        # Resume audio input to a Live model after muting it. The server acknowledges with `session.input_audio.unmuted`.
+        # Resume audio input to a Live model after muting it. The server acknowledges with `session.input_audio.unmuted`. An active audio fixture still pauses inference until playback finishes.
         variant :"session.input_audio.unmute", -> { OpenAI::Live::InputAudioUnmuteEvent }
 
         # Play one complete audio fixture through the session output. Send this event over the primary WebSocket or a server sideband. Audio must be raw mono PCM16 little-endian at 24 kHz, regardless of the session audio format, and at most 30 seconds. The entire payload is validated before model speech is interrupted and input is muted. Only one fixture can be active. fixture.playing acknowledges acceptance and fixture.played reports server mixer drain. These notifications are not exact transport-media boundaries. Input arriving during playback is dropped and not replayed.
         variant :"session.output_audio.fixture.play", -> { OpenAI::Live::OutputAudioFixturePlayEvent }
 
-        # Append instructions to the Live conversation while it is running, optionally associating them with an existing client delegation.
+        # Append developer instructions to the Live conversation while it is running, optionally associating them with an existing client delegation. Rejected while an audio fixture is active. These instructions remain in conversation history through compaction and are included in future backend delegations. For external audio, describe content already delivered so the assistant does not repeat it.
         variant :"session.instructions.append", -> { OpenAI::Live::InstructionsAppendEvent }
 
-        # Provide silent reasoning or progress context to the Live model, optionally for an existing client delegation.
+        # Provide silent reasoning or progress context to the Live model, optionally for an existing client delegation. Rejected while an audio fixture is active.
         variant :"session.thinking.append", -> { OpenAI::Live::ThinkingAppendEvent }
 
-        # Provide context the Live model can communicate to the user, optionally for an existing client delegation.
+        # Provide context the Live model can communicate to the user, optionally for an existing client delegation. Rejected while an audio fixture is active.
         variant :"session.commentary.append", -> { OpenAI::Live::CommentaryAppendEvent }
 
         # Evaluate the configured questions using the current conversation and Decision inputs. Reusing an event_id is rejected for the lifetime of the session.

data/lib/openai/models/live/commentary_append_event.rb

@@ -35,7 +35,7 @@ module OpenAI
 
         # @!method initialize(content:, delegation_id:, event_id: nil, type: :"session.commentary.append")
         #   Provide context the Live model can communicate to the user, optionally for an
-        #   existing client delegation.
+        #   existing client delegation. Rejected while an audio fixture is active.
         #
         #   @param content [String]
         #     Speakable context for the Live model, limited to 500 tokens. Use this for a