openai 0.114.0 → 0.115.0

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

@@ -28,10 +28,15 @@ module OpenAI
         #   @return [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning, nil]
         optional :reasoning, -> { OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning }
 
-        # @!method initialize(id: nil, agent: nil, reasoning: nil, type: :configuration_update)
-        #   An update to the conversation's response configuration. The configuration
-        #   remains in effect for subsequent responses until it is replaced by another
-        #   configuration update.
+        # @!attribute text
+        #   The text output configuration for subsequent responses.
+        #
+        #   @return [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text, nil]
+        optional :text, -> { OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text }
+
+        # @!method initialize(id: nil, agent: nil, reasoning: nil, text: nil, type: :configuration_update)
+        #   An update to the conversation's response configuration. Supply reasoning, text,
+        #   or both. Each setting stays in effect until a later update replaces it.
         #
         #   @param id [String, nil]
         #     The unique ID of the configuration update item.
@@ -42,6 +47,9 @@ module OpenAI
         #   @param reasoning [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Reasoning]
         #     Updates to reasoning configuration. Only effort is supported.
         #
+        #   @param text [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text]
+        #     The text output configuration for subsequent responses.
+        #
         #   @param type [Symbol, :configuration_update]
         #     The item type. Always `configuration_update`.
 
@@ -99,6 +107,58 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
         end
+
+        # @see OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam#text
+        class Text < OpenAI::Internal::Type::BaseModel
+          # @!attribute format_
+          #   Use a JSON schema for structured output or text to return to plain text.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::Format::Text, OpenAI::Models::Beta::BetaResponseFormatTextJSONSchemaConfig]
+          required(
+            :format_,
+            union: -> { OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text::Format },
+            api_name: :format
+          )
+
+          # @!method initialize(format_:)
+          #   The text output configuration for subsequent responses.
+          #
+          #   @param format_ [OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::Format::Text, OpenAI::Models::Beta::BetaResponseFormatTextJSONSchemaConfig]
+          #     Use a JSON schema for structured output or text to return to plain text.
+
+          # Use a JSON schema for structured output or text to return to plain text.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text#format_
+          module Format
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            # Default response format. Used to generate text responses.
+            variant :text, -> { OpenAI::Beta::BetaResponseConfigurationUpdateItemParam::Text::Format::Text }
+
+            # JSON Schema response format. Used to generate structured JSON responses.
+            # Learn more about [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs).
+            variant :json_schema, -> { OpenAI::Beta::BetaResponseFormatTextJSONSchemaConfig }
+
+            class Text < OpenAI::Internal::Type::BaseModel
+              # @!attribute type
+              #   The type of response format being defined. Always `text`.
+              #
+              #   @return [Symbol, :text]
+              required :type, const: :text
+
+              # @!method initialize(type: :text)
+              #   Default response format. Used to generate text responses.
+              #
+              #   @param type [Symbol, :text]
+              #     The type of response format being defined. Always `text`.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::BetaResponseConfigurationUpdateItemParam::Text::Format::Text, OpenAI::Models::Beta::BetaResponseFormatTextJSONSchemaConfig)]
+          end
+        end
       end
     end
 

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

@@ -63,9 +63,8 @@ module OpenAI
 
         variant :additional_tools, -> { OpenAI::Beta::BetaResponseInputItem::AdditionalTools }
 
-        # An update to the conversation's response configuration. The configuration
-        # remains in effect for subsequent responses until it is replaced by another
-        # configuration update.
+        # An update to the conversation's response configuration. Supply reasoning,
+        # text, or both. Each setting stays in effect until a later update replaces it.
         variant :configuration_update, -> { OpenAI::Beta::BetaResponseConfigurationUpdateItemParam }
 
         # A description of the chain of thought used by a reasoning model while generating

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

@@ -46,8 +46,8 @@ module OpenAI
 
         variant :additional_tools, -> { OpenAI::Beta::BetaResponseItem::AdditionalTools }
 
-        # A configuration update that applies to subsequent responses until it is
-        # replaced by another configuration update.
+        # A configuration update for subsequent responses. Each setting stays in effect
+        # until a later update replaces that setting.
         variant :configuration_update, -> { OpenAI::Beta::BetaResponseConfigurationUpdateItem }
 
         # A description of the chain of thought used by a reasoning model while generating

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

@@ -758,8 +758,8 @@ module OpenAI
             # @!attribute input_fidelity
             #   Control how much effort the model will exert to match the style and features,
             #   especially facial features, of input images. Supports `high` and `low` on
-            #   `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            #   `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            #   this parameter. Defaults to `low` on supported models.
             #
             #   @return [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity, nil]
             optional(
@@ -878,8 +878,8 @@ module OpenAI
             #   @param input_fidelity [Symbol, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity, nil]
             #     Control how much effort the model will exert to match the style and features,
             #     especially facial features, of input images. Supports `high` and `low` on
-            #     `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            #     `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            #     `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            #     this parameter. Defaults to `low` on supported models.
             #
             #   @param input_image_mask [OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputImageMask]
             #     Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -968,8 +968,8 @@ module OpenAI
 
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. Supports `high` and `low` on
-            # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            # this parameter. Defaults to `low` on supported models.
             #
             # @see OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam::Tool::ImageGeneration#input_fidelity
             module InputFidelity

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

@@ -99,6 +99,14 @@ module OpenAI
             nil?: true
           )
 
+          # @!attribute generate
+          #   Whether to generate output for this response. Defaults to true when omitted. Set
+          #   to false to prepare request state without model output; the response ID can be
+          #   used as previous_response_id on a later turn.
+          #
+          #   @return [Boolean, nil]
+          optional :generate, OpenAI::Internal::Type::Boolean
+
           # @!attribute include
           #   Specify additional output data to include in the model response. Currently
           #   supported values are:
@@ -482,7 +490,7 @@ module OpenAI
           #   @return [String, nil]
           optional :user, String
 
-          # @!method initialize(access_programs: nil, background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
+          # @!method initialize(access_programs: nil, background: nil, context_management: nil, conversation: nil, generate: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
           #   Client event for creating a response over a persistent WebSocket connection.
           #   This payload uses the same top-level fields as `POST /v1/responses`, plus
           #   WebSocket-only envelope metadata.
@@ -509,6 +517,11 @@ module OpenAI
           #     items from this response are automatically added to this conversation after this
           #     response completes.
           #
+          #   @param generate [Boolean]
+          #     Whether to generate output for this response. Defaults to true when omitted. Set
+          #     to false to prepare request state without model output; the response ID can be
+          #     used as previous_response_id on a later turn.
+          #
           #   @param include [Array<Symbol, OpenAI::Models::Beta::BetaResponseIncludable>, nil]
           #     Specify additional output data to include in the model response. Currently
           #     supported values are:
@@ -1329,6 +1342,9 @@ module OpenAI
             # replacements.
             GPT_5_4_NANO = :"gpt-5.4-nano"
             GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+            # @deprecated Announced shutdown date: 2027-04-01. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
             # @deprecated Announced shutdown date: 2026-08-10. See
             # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1346,6 +1362,9 @@ module OpenAI
             # https://developers.openai.com/api/docs/deprecations for details and recommended
             # replacements.
             GPT_5_1 = :"gpt-5.1"
+            # @deprecated Announced shutdown date: 2027-04-01. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
             # @deprecated Announced shutdown date: 2026-07-23. See
             # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -634,8 +634,8 @@ module OpenAI
           # @!attribute input_fidelity
           #   Control how much effort the model will exert to match the style and features,
           #   especially facial features, of input images. Supports `high` and `low` on
-          #   `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          #   `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          #   this parameter. Defaults to `low` on supported models.
           #
           #   @return [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::InputFidelity, nil]
           optional(
@@ -736,8 +736,8 @@ module OpenAI
           #   @param input_fidelity [Symbol, OpenAI::Models::Beta::BetaTool::ImageGeneration::InputFidelity, nil]
           #     Control how much effort the model will exert to match the style and features,
           #     especially facial features, of input images. Supports `high` and `low` on
-          #     `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          #     `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          #     `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          #     this parameter. Defaults to `low` on supported models.
           #
           #   @param input_image_mask [OpenAI::Models::Beta::BetaTool::ImageGeneration::InputImageMask]
           #     Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -826,8 +826,8 @@ module OpenAI
 
           # Control how much effort the model will exert to match the style and features,
           # especially facial features, of input images. Supports `high` and `low` on
-          # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          # this parameter. Defaults to `low` on supported models.
           #
           # @see OpenAI::Models::Beta::BetaTool::ImageGeneration#input_fidelity
           module InputFidelity

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

@@ -428,6 +428,9 @@ module OpenAI
           # replacements.
           GPT_5_4_NANO = :"gpt-5.4-nano"
           GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
           # @deprecated Announced shutdown date: 2026-08-10. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -445,6 +448,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_5_1 = :"gpt-5.1"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           # @deprecated Announced shutdown date: 2026-07-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -1013,6 +1013,9 @@ module OpenAI
           # replacements.
           GPT_5_4_NANO = :"gpt-5.4-nano"
           GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
           # @deprecated Announced shutdown date: 2026-08-10. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1030,6 +1033,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_5_1 = :"gpt-5.1"
+          # @deprecated Announced shutdown date: 2027-04-01. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           # @deprecated Announced shutdown date: 2026-07-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

data/lib/openai/models/chat_model.rb

@@ -22,6 +22,9 @@ module OpenAI
       # replacements.
       GPT_5_4_NANO = :"gpt-5.4-nano"
       GPT_5_4_MINI_2026_03_17 = :"gpt-5.4-mini-2026-03-17"
+      # @deprecated Announced shutdown date: 2027-04-01. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_5_4_NANO_2026_03_17 = :"gpt-5.4-nano-2026-03-17"
       # @deprecated Announced shutdown date: 2026-08-10. See
       # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -39,6 +42,9 @@ module OpenAI
       # https://developers.openai.com/api/docs/deprecations for details and recommended
       # replacements.
       GPT_5_1 = :"gpt-5.1"
+      # @deprecated Announced shutdown date: 2027-04-01. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
       # @deprecated Announced shutdown date: 2026-07-23. See
       # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -45,8 +45,8 @@ module OpenAI
 
         variant :additional_tools, -> { OpenAI::Conversations::ConversationItem::AdditionalTools }
 
-        # A configuration update that applies to subsequent responses until it is
-        # replaced by another configuration update.
+        # A configuration update for subsequent responses. Each setting stays in effect
+        # until a later update replaces that setting.
         variant :configuration_update, -> { OpenAI::Responses::ResponseConfigurationUpdateItem }
 
         # A description of the chain of thought used by a reasoning model while generating

data/lib/openai/models/image_edit_params.rb

@@ -12,12 +12,12 @@ module OpenAI
       # @!attribute image
       #   The image(s) to edit. Must be a supported image file or an array of images.
       #
-      #   For the GPT image models (`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`), each image should
-      #   be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
-      #   images.
+      #   For the GPT image models (`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`, and
+      #   `gpt-image-2.5-flare-2026-09-08`), each image should be a `png`, `webp`, or
+      #   `jpg` file less than 50MB. You can provide up to 16 images.
+      #   `chatgpt-image-latest` follows the same input constraints as GPT image models.
       #
       #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -50,12 +50,24 @@ module OpenAI
       # @!attribute input_fidelity
       #   Control how much effort the model will exert to match the style and features,
       #   especially facial features, of input images. Supports `high` and `low` on
-      #   `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-      #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+      #   `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+      #   this parameter. Defaults to `low` on supported models.
       #
       #   @return [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
       optional :input_fidelity, enum: -> { OpenAI::ImageEditParams::InputFidelity }, nil?: true
 
+      # @!attribute markup
+      #   A transparent PNG overlaid on the first image to guide the edit. Must match that
+      #   image's dimensions after orientation and contain transparent pixels. Supports
+      #   GPT Image 2.5 and 2.6. Cannot be combined with mask.
+      #
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
+      #
+      #   @return [Pathname, StringIO, IO, String, OpenAI::FilePart, nil]
+      optional :markup, OpenAI::Internal::Type::FileInput
+
       # @!attribute mask
       #   An additional image whose fully transparent areas (e.g. where alpha is zero)
       #   indicate where `image` should be edited. If there are multiple images provided,
@@ -171,16 +183,16 @@ module OpenAI
       #   @return [String, nil]
       optional :user, String
 
-      # @!method initialize(image:, prompt:, background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, user: nil, request_options: {})
+      # @!method initialize(image:, prompt:, background: nil, input_fidelity: nil, markup: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, user: nil, request_options: {})
       #   @param image [Pathname, StringIO, IO, String, OpenAI::FilePart, Array<Pathname, StringIO, IO, String, OpenAI::FilePart>]
       #     The image(s) to edit. Must be a supported image file or an array of images.
       #
-      #     For the GPT image models (`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`), each image should
-      #     be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
-      #     images.
+      #     For the GPT image models (`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`, and
+      #     `gpt-image-2.5-flare-2026-09-08`), each image should be a `png`, `webp`, or
+      #     `jpg` file less than 50MB. You can provide up to 16 images.
+      #     `chatgpt-image-latest` follows the same input constraints as GPT image models.
       #
       #     `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       #     metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -204,8 +216,17 @@ module OpenAI
       #   @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, nil]
       #     Control how much effort the model will exert to match the style and features,
       #     especially facial features, of input images. Supports `high` and `low` on
-      #     `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-      #     `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+      #     `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+      #     this parameter. Defaults to `low` on supported models.
+      #
+      #   @param markup [Pathname, StringIO, IO, String, OpenAI::FilePart]
+      #     A transparent PNG overlaid on the first image to guide the edit. Must match that
+      #     image's dimensions after orientation and contain transparent pixels. Supports
+      #     GPT Image 2.5 and 2.6. Cannot be combined with mask.
+      #
+      #     `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #     metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #     content type.
       #
       #   @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #     An additional image whose fully transparent areas (e.g. where alpha is zero)
@@ -289,12 +310,12 @@ module OpenAI
 
       # The image(s) to edit. Must be a supported image file or an array of images.
       #
-      # For the GPT image models (`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`), each image should
-      # be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
-      # images.
+      # For the GPT image models (`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`, and
+      # `gpt-image-2.5-flare-2026-09-08`), each image should be a `png`, `webp`, or
+      # `jpg` file less than 50MB. You can provide up to 16 images.
+      # `chatgpt-image-latest` follows the same input constraints as GPT image models.
       module Image
         extend OpenAI::Internal::Type::Union
 
@@ -331,8 +352,8 @@ module OpenAI
 
       # Control how much effort the model will exert to match the style and features,
       # especially facial features, of input images. Supports `high` and `low` on
-      # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-      # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+      # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+      # this parameter. Defaults to `low` on supported models.
       module InputFidelity
         extend OpenAI::Internal::Type::Enum
 

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

@@ -82,9 +82,12 @@ module OpenAI
         # A SIP DTMF keypress received from the caller. Delivered only to sideband observers.
         variant :"transport.dtmf.received", -> { OpenAI::Live::ForkServerEvent::TransportDtmfReceived }
 
-        # A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to sideband observers; this is not a client command.
+        # Legacy SIP DTMF delivery notification retained for SDK compatibility and saved events. Current servers confirm delivery with transport.dtmf.sent; transport.dtmf.send is now the client command.
         variant :"transport.dtmf.send", -> { OpenAI::Live::ForkServerEvent::TransportDtmfSend }
 
+        # A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to sideband observers; this is not a client command.
+        variant :"transport.dtmf.sent", -> { OpenAI::Live::ForkServerEvent::TransportDtmfSent }
+
         # The outbound SIP provider leg is ringing or providing early media. Delivered only to sideband observers.
         variant :"transport.ringing", -> { OpenAI::Live::ForkServerEvent::TransportRinging }
 
@@ -170,6 +173,43 @@ module OpenAI
           optional :client_event_id, String
 
           # @!method initialize(event:, event_id:, client_event_id: nil, type: :"transport.dtmf.send")
+          #   Legacy SIP DTMF delivery notification retained for SDK compatibility and saved
+          #   events. Current servers confirm delivery with transport.dtmf.sent;
+          #   transport.dtmf.send is now the client command.
+          #
+          #   @param event [String]
+          #
+          #   @param event_id [String]
+          #
+          #   @param client_event_id [String]
+          #     The event_id of the client command, when supplied.
+          #
+          #   @param type [Symbol, :"transport.dtmf.send"]
+        end
+
+        class TransportDtmfSent < OpenAI::Internal::Type::BaseModel
+          # @!attribute event
+          #
+          #   @return [String]
+          required :event, String
+
+          # @!attribute event_id
+          #
+          #   @return [String]
+          required :event_id, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :"transport.dtmf.sent"]
+          required :type, const: :"transport.dtmf.sent"
+
+          # @!attribute client_event_id
+          #   The event_id of the client command, when supplied.
+          #
+          #   @return [String, nil]
+          optional :client_event_id, String
+
+          # @!method initialize(event:, event_id:, client_event_id: nil, type: :"transport.dtmf.sent")
           #   A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to
           #   sideband observers; this is not a client command.
           #
@@ -180,7 +220,7 @@ module OpenAI
           #   @param client_event_id [String]
           #     The event_id of the client command, when supplied.
           #
-          #   @param type [Symbol, :"transport.dtmf.send"]
+          #   @param type [Symbol, :"transport.dtmf.sent"]
         end
 
         class TransportRinging < OpenAI::Internal::Type::BaseModel
@@ -314,7 +354,7 @@ module OpenAI
         end
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Live::SessionStartedEvent, OpenAI::Models::Live::SessionUpdatedEvent, OpenAI::Models::Live::InputAudioMutedEvent, OpenAI::Models::Live::InputAudioUnmutedEvent, OpenAI::Models::Live::OutputAudioFixturePlayingEvent, OpenAI::Models::Live::OutputAudioFixturePlayedEvent, OpenAI::Models::Live::InstructionsAppendedEvent, OpenAI::Models::Live::ThinkingAppendedEvent, OpenAI::Models::Live::CommentaryAppendedEvent, OpenAI::Models::Live::ForkServerEvent::SessionInputAudioAppend, OpenAI::Models::Live::OutputAudioDeltaEvent, OpenAI::Models::Live::InputTranscriptDeltaEvent, OpenAI::Models::Live::OutputTranscriptDeltaEvent, OpenAI::Models::Live::DelegationCreatedEvent, OpenAI::Models::Live::DecisionEvent, OpenAI::Models::Live::DecisionItemCreatedEvent, OpenAI::Models::Live::DecisionItemDeletedEvent, OpenAI::Models::Live::ResponseEvent, OpenAI::Models::Live::SessionUsageUpdatedEvent, OpenAI::Models::Live::SessionClosedEvent, OpenAI::Models::Live::ErrorEvent, OpenAI::Models::Live::InfoEvent, OpenAI::Models::Live::ForkServerEvent::TransportDtmfReceived, OpenAI::Models::Live::ForkServerEvent::TransportDtmfSend, OpenAI::Models::Live::ForkServerEvent::TransportRinging, OpenAI::Models::Live::ForkServerEvent::TransportAnswered, OpenAI::Models::Live::ForkServerEvent::TransportFailed)]
+        #   @return [Array(OpenAI::Models::Live::SessionStartedEvent, OpenAI::Models::Live::SessionUpdatedEvent, OpenAI::Models::Live::InputAudioMutedEvent, OpenAI::Models::Live::InputAudioUnmutedEvent, OpenAI::Models::Live::OutputAudioFixturePlayingEvent, OpenAI::Models::Live::OutputAudioFixturePlayedEvent, OpenAI::Models::Live::InstructionsAppendedEvent, OpenAI::Models::Live::ThinkingAppendedEvent, OpenAI::Models::Live::CommentaryAppendedEvent, OpenAI::Models::Live::ForkServerEvent::SessionInputAudioAppend, OpenAI::Models::Live::OutputAudioDeltaEvent, OpenAI::Models::Live::InputTranscriptDeltaEvent, OpenAI::Models::Live::OutputTranscriptDeltaEvent, OpenAI::Models::Live::DelegationCreatedEvent, OpenAI::Models::Live::DecisionEvent, OpenAI::Models::Live::DecisionItemCreatedEvent, OpenAI::Models::Live::DecisionItemDeletedEvent, OpenAI::Models::Live::ResponseEvent, OpenAI::Models::Live::SessionUsageUpdatedEvent, OpenAI::Models::Live::SessionClosedEvent, OpenAI::Models::Live::ErrorEvent, OpenAI::Models::Live::InfoEvent, OpenAI::Models::Live::ForkServerEvent::TransportDtmfReceived, OpenAI::Models::Live::ForkServerEvent::TransportDtmfSend, OpenAI::Models::Live::ForkServerEvent::TransportDtmfSent, OpenAI::Models::Live::ForkServerEvent::TransportRinging, OpenAI::Models::Live::ForkServerEvent::TransportAnswered, OpenAI::Models::Live::ForkServerEvent::TransportFailed)]
       end
     end
   end

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

@@ -82,9 +82,12 @@ module OpenAI
         # A SIP DTMF keypress received from the caller. Delivered only to sideband observers.
         variant :"transport.dtmf.received", -> { OpenAI::Live::ServerEvent::TransportDtmfReceived }
 
-        # A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to sideband observers; this is not a client command.
+        # Legacy SIP DTMF delivery notification retained for SDK compatibility and saved events. Current servers confirm delivery with transport.dtmf.sent; transport.dtmf.send is now the client command.
         variant :"transport.dtmf.send", -> { OpenAI::Live::ServerEvent::TransportDtmfSend }
 
+        # A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to sideband observers; this is not a client command.
+        variant :"transport.dtmf.sent", -> { OpenAI::Live::ServerEvent::TransportDtmfSent }
+
         # The outbound SIP provider leg is ringing or providing early media. Delivered only to sideband observers.
         variant :"transport.ringing", -> { OpenAI::Live::ServerEvent::TransportRinging }
 
@@ -170,6 +173,43 @@ module OpenAI
           optional :client_event_id, String
 
           # @!method initialize(event:, event_id:, client_event_id: nil, type: :"transport.dtmf.send")
+          #   Legacy SIP DTMF delivery notification retained for SDK compatibility and saved
+          #   events. Current servers confirm delivery with transport.dtmf.sent;
+          #   transport.dtmf.send is now the client command.
+          #
+          #   @param event [String]
+          #
+          #   @param event_id [String]
+          #
+          #   @param client_event_id [String]
+          #     The event_id of the client command, when supplied.
+          #
+          #   @param type [Symbol, :"transport.dtmf.send"]
+        end
+
+        class TransportDtmfSent < OpenAI::Internal::Type::BaseModel
+          # @!attribute event
+          #
+          #   @return [String]
+          required :event, String
+
+          # @!attribute event_id
+          #
+          #   @return [String]
+          required :event_id, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :"transport.dtmf.sent"]
+          required :type, const: :"transport.dtmf.sent"
+
+          # @!attribute client_event_id
+          #   The event_id of the client command, when supplied.
+          #
+          #   @return [String, nil]
+          optional :client_event_id, String
+
+          # @!method initialize(event:, event_id:, client_event_id: nil, type: :"transport.dtmf.sent")
           #   A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to
           #   sideband observers; this is not a client command.
           #
@@ -180,7 +220,7 @@ module OpenAI
           #   @param client_event_id [String]
           #     The event_id of the client command, when supplied.
           #
-          #   @param type [Symbol, :"transport.dtmf.send"]
+          #   @param type [Symbol, :"transport.dtmf.sent"]
         end
 
         class TransportRinging < OpenAI::Internal::Type::BaseModel
@@ -314,7 +354,7 @@ module OpenAI
         end
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Live::SessionStartedEvent, OpenAI::Models::Live::SessionUpdatedEvent, OpenAI::Models::Live::InputAudioMutedEvent, OpenAI::Models::Live::InputAudioUnmutedEvent, OpenAI::Models::Live::OutputAudioFixturePlayingEvent, OpenAI::Models::Live::OutputAudioFixturePlayedEvent, OpenAI::Models::Live::InstructionsAppendedEvent, OpenAI::Models::Live::ThinkingAppendedEvent, OpenAI::Models::Live::CommentaryAppendedEvent, OpenAI::Models::Live::ServerEvent::SessionInputAudioAppend, OpenAI::Models::Live::OutputAudioDeltaEvent, OpenAI::Models::Live::InputTranscriptDeltaEvent, OpenAI::Models::Live::OutputTranscriptDeltaEvent, OpenAI::Models::Live::DelegationCreatedEvent, OpenAI::Models::Live::DecisionEvent, OpenAI::Models::Live::DecisionItemCreatedEvent, OpenAI::Models::Live::DecisionItemDeletedEvent, OpenAI::Models::Live::ResponseEvent, OpenAI::Models::Live::SessionUsageUpdatedEvent, OpenAI::Models::Live::SessionClosedEvent, OpenAI::Models::Live::ErrorEvent, OpenAI::Models::Live::InfoEvent, OpenAI::Models::Live::ServerEvent::TransportDtmfReceived, OpenAI::Models::Live::ServerEvent::TransportDtmfSend, OpenAI::Models::Live::ServerEvent::TransportRinging, OpenAI::Models::Live::ServerEvent::TransportAnswered, OpenAI::Models::Live::ServerEvent::TransportFailed)]
+        #   @return [Array(OpenAI::Models::Live::SessionStartedEvent, OpenAI::Models::Live::SessionUpdatedEvent, OpenAI::Models::Live::InputAudioMutedEvent, OpenAI::Models::Live::InputAudioUnmutedEvent, OpenAI::Models::Live::OutputAudioFixturePlayingEvent, OpenAI::Models::Live::OutputAudioFixturePlayedEvent, OpenAI::Models::Live::InstructionsAppendedEvent, OpenAI::Models::Live::ThinkingAppendedEvent, OpenAI::Models::Live::CommentaryAppendedEvent, OpenAI::Models::Live::ServerEvent::SessionInputAudioAppend, OpenAI::Models::Live::OutputAudioDeltaEvent, OpenAI::Models::Live::InputTranscriptDeltaEvent, OpenAI::Models::Live::OutputTranscriptDeltaEvent, OpenAI::Models::Live::DelegationCreatedEvent, OpenAI::Models::Live::DecisionEvent, OpenAI::Models::Live::DecisionItemCreatedEvent, OpenAI::Models::Live::DecisionItemDeletedEvent, OpenAI::Models::Live::ResponseEvent, OpenAI::Models::Live::SessionUsageUpdatedEvent, OpenAI::Models::Live::SessionClosedEvent, OpenAI::Models::Live::ErrorEvent, OpenAI::Models::Live::InfoEvent, OpenAI::Models::Live::ServerEvent::TransportDtmfReceived, OpenAI::Models::Live::ServerEvent::TransportDtmfSend, OpenAI::Models::Live::ServerEvent::TransportDtmfSent, OpenAI::Models::Live::ServerEvent::TransportRinging, OpenAI::Models::Live::ServerEvent::TransportAnswered, OpenAI::Models::Live::ServerEvent::TransportFailed)]
       end
     end
   end