openai 0.104.0 → 0.106.0

data/sig/openai/models/beta/agents/session_create_params.rbs

@@ -177,7 +177,8 @@ module OpenAI
               ?tools: ::Array[OpenAI::Models::Beta::agent_tool_param]?
             }
 
-            type service_tier = :auto | :default | :flex | :priority | :fast
+            type service_tier =
+              :auto | :default | :flex | :priority | :fast | :ultrafast
 
             module ServiceTier
               extend OpenAI::Internal::Type::Enum
@@ -197,6 +198,9 @@ module OpenAI
               # Uses the fast service tier.
               FAST: :fast
 
+              # Uses the ultrafast service tier.
+              ULTRAFAST: :ultrafast
+
               def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::service_tier]
             end
           end

data/sig/openai/models/beta/agents/session_update_params.rbs

@@ -139,7 +139,8 @@ module OpenAI
               end
             end
 
-            type service_tier = :auto | :default | :flex | :priority | :fast
+            type service_tier =
+              :auto | :default | :flex | :priority | :fast | :ultrafast
 
             module ServiceTier
               extend OpenAI::Internal::Type::Enum
@@ -159,6 +160,9 @@ module OpenAI
               # Uses the fast service tier.
               FAST: :fast
 
+              # Uses the ultrafast service tier.
+              ULTRAFAST: :ultrafast
+
               def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent::service_tier]
             end
           end

data/sig/openai/models/decision_create_params.rbs

@@ -5,6 +5,9 @@ module OpenAI
         input: OpenAI::Models::DecisionCreateParams::input,
         model: String,
         questions: ::Array[OpenAI::Models::DecisionCreateParams::question],
+        ?prompt_cache_key: String?,
+        ?prompt_cache_options: (OpenAI::DecisionCreateParams::PromptCacheOptions
+        | OpenAI::Models::DecisionCreateParams::prompt_cache_options)?,
         ?safety_identifier: String?,
         ?request_options: OpenAI::request_opts
       }
@@ -26,6 +29,21 @@ module OpenAI
       # or score. Answers come back in the same order.
       attr_accessor questions: ::Array[OpenAI::Models::DecisionCreateParams::question]
 
+      # Partition prompt cache reuse by caller-provided key.
+      attr_accessor prompt_cache_key: String?
+
+      # Options for prompt caching. Supported for `gpt-5.6` and later models. By
+      # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+      # explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+      # request can write up to four breakpoints. For cache matching, OpenAI considers
+      # up to the latest 80 breakpoints in the conversation, without a content-block
+      # lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+      # `ttl` defaults to `30m`, which is currently the only supported value. See the
+      # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
+      # for current details.
+      attr_accessor prompt_cache_options: (OpenAI::DecisionCreateParams::PromptCacheOptions
+      | OpenAI::Models::DecisionCreateParams::prompt_cache_options)?
+
       # Opaque caller-provided end-user identifier, scoped by the verified org. Match
       # Responses' limit; this is never the authenticated user identity.
       attr_accessor safety_identifier: String?
@@ -40,6 +58,18 @@ module OpenAI
       # @param questions
       #   Ask 1–200 questions about the input. Each question can be a predicate, choice,
       #   or score. Answers come back in the same order.
+      # @param prompt_cache_key
+      #   Partition prompt cache reuse by caller-provided key.
+      # @param prompt_cache_options
+      #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
+      #   default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+      #   explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+      #   request can write up to four breakpoints. For cache matching, OpenAI considers
+      #   up to the latest 80 breakpoints in the conversation, without a content-block
+      #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+      #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+      #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
+      #   for current details.
       # @param safety_identifier
       #   Opaque caller-provided end-user identifier, scoped by the verified org. Match
       #   Responses' limit; this is never the authenticated user identity.
@@ -47,6 +77,9 @@ module OpenAI
         input: OpenAI::Models::DecisionCreateParams::input,
         model: String,
         questions: ::Array[OpenAI::Models::DecisionCreateParams::question],
+        ?prompt_cache_key: String?,
+        ?prompt_cache_options: (OpenAI::DecisionCreateParams::PromptCacheOptions
+        | OpenAI::Models::DecisionCreateParams::prompt_cache_options)?,
         ?safety_identifier: String?,
         ?request_options: OpenAI::request_opts
       ) -> void
@@ -55,6 +88,9 @@ module OpenAI
         input: OpenAI::Models::DecisionCreateParams::input,
         model: String,
         questions: ::Array[OpenAI::Models::DecisionCreateParams::question],
+        ?prompt_cache_key: String?,
+        ?prompt_cache_options: (OpenAI::DecisionCreateParams::PromptCacheOptions
+        | OpenAI::Models::DecisionCreateParams::prompt_cache_options)?,
         ?safety_identifier: String?,
         ?request_options: OpenAI::RequestOptions
       }
@@ -233,6 +269,76 @@ module OpenAI
 
         def self?.variants: -> ::Array[OpenAI::Models::DecisionCreateParams::question]
       end
+
+      type prompt_cache_options =
+        {
+          ?mode: OpenAI::Models::DecisionCreateParams::PromptCacheOptions::mode?,
+          ?ttl: OpenAI::Models::DecisionCreateParams::PromptCacheOptions::ttl
+        }
+
+      class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+        # Controls whether OpenAI automatically creates an implicit cache breakpoint.
+        # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
+        # and writes up to the latest three explicit breakpoints in the request. With
+        # `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+        # latest four explicit breakpoints. If there are no explicit breakpoints, the
+        # request does not use prompt caching.
+        attr_accessor mode: OpenAI::Models::DecisionCreateParams::PromptCacheOptions::mode?
+
+        # The minimum lifetime applied to every implicit and explicit cache breakpoint
+        # written by the request. Defaults to `30m`, which is currently the only supported
+        # value. The backend may retain cache entries for longer.
+        attr_reader ttl: OpenAI::Models::DecisionCreateParams::PromptCacheOptions::ttl?
+
+        # The minimum lifetime applied to every implicit and explicit cache breakpoint
+        # written by the request. Defaults to `30m`, which is currently the only supported
+        # value. The backend may retain cache entries for longer.
+        def ttl=: (
+          OpenAI::Models::DecisionCreateParams::PromptCacheOptions::ttl
+        ) -> OpenAI::Models::DecisionCreateParams::PromptCacheOptions::ttl
+
+        # @param mode
+        #   Controls whether OpenAI automatically creates an implicit cache breakpoint.
+        #   Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
+        #   and writes up to the latest three explicit breakpoints in the request. With
+        #   `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+        #   latest four explicit breakpoints. If there are no explicit breakpoints, the
+        #   request does not use prompt caching.
+        # @param ttl
+        #   The minimum lifetime applied to every implicit and explicit cache breakpoint
+        #   written by the request. Defaults to `30m`, which is currently the only supported
+        #   value. The backend may retain cache entries for longer.
+        def initialize: (
+          ?mode: OpenAI::Models::DecisionCreateParams::PromptCacheOptions::mode?,
+          ?ttl: OpenAI::Models::DecisionCreateParams::PromptCacheOptions::ttl
+        ) -> void
+
+        def to_hash: -> {
+          ?mode: OpenAI::Models::DecisionCreateParams::PromptCacheOptions::mode?,
+          ?ttl: OpenAI::Models::DecisionCreateParams::PromptCacheOptions::ttl
+        }
+
+        type mode = :implicit | :explicit
+
+        module Mode
+          extend OpenAI::Internal::Type::Enum
+
+          IMPLICIT: :implicit
+          EXPLICIT: :explicit
+
+          def self?.values: -> ::Array[OpenAI::Models::DecisionCreateParams::PromptCacheOptions::mode]
+        end
+
+        type ttl = :"30m"
+
+        module Ttl
+          extend OpenAI::Internal::Type::Enum
+
+          TTL_30M: :"30m"
+
+          def self?.values: -> ::Array[OpenAI::Models::DecisionCreateParams::PromptCacheOptions::ttl]
+        end
+      end
     end
   end
 end

data/sig/openai/models/decision_input_image.rbs

@@ -4,7 +4,9 @@ module OpenAI
       {
         image_url: String,
         ?type: :input_image,
-        ?detail: OpenAI::Models::DecisionInputImage::detail?
+        ?detail: OpenAI::Models::DecisionInputImage::detail?,
+        ?prompt_cache_breakpoint: (OpenAI::DecisionPromptCacheBreakpoint
+        | OpenAI::Models::decision_prompt_cache_breakpoint)?
       }
 
     class DecisionInputImage < OpenAI::Internal::Type::BaseModel
@@ -17,21 +19,35 @@ module OpenAI
       # auto.
       attr_accessor detail: OpenAI::Models::DecisionInputImage::detail?
 
+      # 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.
+      attr_accessor prompt_cache_breakpoint: (OpenAI::DecisionPromptCacheBreakpoint
+      | OpenAI::Models::decision_prompt_cache_breakpoint)?
+
       # @param image_url
       #   A base64-encoded image in a data URL or a publicly accessible HTTP(S) image URL.
       # @param detail
       #   The image detail level, using the selected model's image profile. Defaults to
       #   auto.
+      # @param prompt_cache_breakpoint
+      #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+      #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+      #   token block.
       def initialize: (
         image_url: String,
         ?detail: OpenAI::Models::DecisionInputImage::detail?,
+        ?prompt_cache_breakpoint: (OpenAI::DecisionPromptCacheBreakpoint
+        | OpenAI::Models::decision_prompt_cache_breakpoint)?,
         ?type: :input_image
       ) -> void
 
       def to_hash: -> {
         image_url: String,
         ?type: :input_image,
-        ?detail: OpenAI::Models::DecisionInputImage::detail?
+        ?detail: OpenAI::Models::DecisionInputImage::detail?,
+        ?prompt_cache_breakpoint: (OpenAI::DecisionPromptCacheBreakpoint
+        | OpenAI::Models::decision_prompt_cache_breakpoint)?
       }
 
       type detail = :low | :high | :auto | :original

data/sig/openai/models/decision_input_text.rbs

@@ -1,15 +1,41 @@
 module OpenAI
   module Models
-    type decision_input_text = { text: String, ?type: :input_text }
+    type decision_input_text =
+      {
+        text: String,
+        ?type: :input_text,
+        ?prompt_cache_breakpoint: (OpenAI::DecisionPromptCacheBreakpoint
+        | OpenAI::Models::decision_prompt_cache_breakpoint)?
+      }
 
     class DecisionInputText < OpenAI::Internal::Type::BaseModel
       attr_accessor text: String
 
       attr_accessor type: :input_text
 
-      def initialize: (text: String, ?type: :input_text) -> void
+      # 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.
+      attr_accessor prompt_cache_breakpoint: (OpenAI::DecisionPromptCacheBreakpoint
+      | OpenAI::Models::decision_prompt_cache_breakpoint)?
 
-      def to_hash: -> { text: String, ?type: :input_text }
+      # @param prompt_cache_breakpoint
+      #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+      #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+      #   token block.
+      def initialize: (
+        text: String,
+        ?prompt_cache_breakpoint: (OpenAI::DecisionPromptCacheBreakpoint
+        | OpenAI::Models::decision_prompt_cache_breakpoint)?,
+        ?type: :input_text
+      ) -> void
+
+      def to_hash: -> {
+        text: String,
+        ?type: :input_text,
+        ?prompt_cache_breakpoint: (OpenAI::DecisionPromptCacheBreakpoint
+        | OpenAI::Models::decision_prompt_cache_breakpoint)?
+      }
     end
   end
 end

data/sig/openai/models/decision_prompt_cache_breakpoint.rbs

@@ -0,0 +1,16 @@
+module OpenAI
+  module Models
+    type decision_prompt_cache_breakpoint = { ?mode: :explicit }
+
+    class DecisionPromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
+      # The breakpoint mode. Always `explicit`.
+      attr_accessor mode: :explicit
+
+      # @param mode
+      #   The breakpoint mode. Always `explicit`.
+      def initialize: (?mode: :explicit) -> void
+
+      def to_hash: -> { ?mode: :explicit }
+    end
+  end
+end

data/sig/openai/models/image_edit_completed_event.rbs

@@ -9,7 +9,8 @@ module OpenAI
         quality: OpenAI::Models::ImageEditCompletedEvent::quality,
         size: OpenAI::Models::ImageEditCompletedEvent::size,
         ?type: :"image_edit.completed",
-        usage: OpenAI::ImageEditCompletedEvent::Usage
+        usage: OpenAI::ImageEditCompletedEvent::Usage,
+        ?safety_identifier: String?
       }
 
     class ImageEditCompletedEvent < OpenAI::Internal::Type::BaseModel
@@ -38,6 +39,11 @@ module OpenAI
       # generation.
       attr_accessor usage: OpenAI::ImageEditCompletedEvent::Usage
 
+      # The effective safety identifier used for safety monitoring and abuse detection.
+      # This is the non-empty `safety_identifier` from the request, or the deprecated
+      # `user` value when `safety_identifier` is omitted, null, or empty.
+      attr_accessor safety_identifier: String?
+
       # @param b64_json
       #   Base64-encoded final edited image data, suitable for rendering as an image.
       # @param background
@@ -53,6 +59,10 @@ module OpenAI
       # @param usage
       #   For the GPT image models only, the token usage information for the image
       #   generation.
+      # @param safety_identifier
+      #   The effective safety identifier used for safety monitoring and abuse detection.
+      #   This is the non-empty `safety_identifier` from the request, or the deprecated
+      #   `user` value when `safety_identifier` is omitted, null, or empty.
       # @param type
       #   The type of the event. Always `image_edit.completed`.
       def initialize: (
@@ -63,6 +73,7 @@ module OpenAI
         quality: OpenAI::Models::ImageEditCompletedEvent::quality,
         size: OpenAI::Models::ImageEditCompletedEvent::size,
         usage: OpenAI::ImageEditCompletedEvent::Usage,
+        ?safety_identifier: String?,
         ?type: :"image_edit.completed"
       ) -> void
 
@@ -74,7 +85,8 @@ module OpenAI
         quality: OpenAI::Models::ImageEditCompletedEvent::quality,
         size: OpenAI::Models::ImageEditCompletedEvent::size,
         ?type: :"image_edit.completed",
-        usage: OpenAI::ImageEditCompletedEvent::Usage
+        usage: OpenAI::ImageEditCompletedEvent::Usage,
+        ?safety_identifier: String?
       }
 
       type background = :transparent | :opaque | :auto

data/sig/openai/models/image_edit_params.rbs

@@ -14,6 +14,7 @@ module OpenAI
         ?partial_images: Integer?,
         ?quality: OpenAI::Models::ImageEditParams::quality?,
         ?response_format: OpenAI::Models::ImageEditParams::response_format?,
+        ?safety_identifier: String?,
         ?size: OpenAI::Models::ImageEditParams::size?,
         ?user: String,
         ?request_options: OpenAI::request_opts
@@ -116,6 +117,14 @@ module OpenAI
       # image models, which always return base64-encoded images.
       attr_accessor response_format: OpenAI::Models::ImageEditParams::response_format?
 
+      # A stable identifier for an end user in your organization, used for safety
+      # monitoring and abuse detection. Hash a username or email address to avoid
+      # sending identifying information. A non-empty value takes precedence over the
+      # deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+      # when available.
+      # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+      attr_accessor safety_identifier: String?
+
       # The size of the generated images. Defaults to `auto`. For `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
@@ -129,13 +138,15 @@ module OpenAI
       # models that allow automatic sizing.
       attr_accessor size: OpenAI::Models::ImageEditParams::size?
 
-      # A unique identifier representing your end-user, which can help OpenAI to monitor
-      # and detect abuse.
+      # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+      # backward compatibility and is used when `safety_identifier` is omitted, null, or
+      # empty.
       # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       attr_reader user: String?
 
-      # A unique identifier representing your end-user, which can help OpenAI to monitor
-      # and detect abuse.
+      # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+      # backward compatibility and is used when `safety_identifier` is omitted, null, or
+      # empty.
       # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       def user=: (String) -> String
 
@@ -210,6 +221,13 @@ module OpenAI
       # @param response_format
       #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
+      # @param safety_identifier
+      #   A stable identifier for an end user in your organization, used for safety
+      #   monitoring and abuse detection. Hash a username or email address to avoid
+      #   sending identifying information. A non-empty value takes precedence over the
+      #   deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+      #   when available.
+      #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       # @param size
       #   The size of the generated images. Defaults to `auto`. For `gpt-image-2`,
       #   `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
@@ -223,8 +241,9 @@ module OpenAI
       #   `1024x1536` are supported by the GPT image models; `auto` is supported for
       #   models that allow automatic sizing.
       # @param user
-      #   A unique identifier representing your end-user, which can help OpenAI to monitor
-      #   and detect abuse.
+      #   Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+      #   backward compatibility and is used when `safety_identifier` is omitted, null, or
+      #   empty.
       #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       def initialize: (
         image: OpenAI::Models::ImageEditParams::image,
@@ -239,6 +258,7 @@ module OpenAI
         ?partial_images: Integer?,
         ?quality: OpenAI::Models::ImageEditParams::quality?,
         ?response_format: OpenAI::Models::ImageEditParams::response_format?,
+        ?safety_identifier: String?,
         ?size: OpenAI::Models::ImageEditParams::size?,
         ?user: String,
         ?request_options: OpenAI::request_opts
@@ -257,6 +277,7 @@ module OpenAI
         ?partial_images: Integer?,
         ?quality: OpenAI::Models::ImageEditParams::quality?,
         ?response_format: OpenAI::Models::ImageEditParams::response_format?,
+        ?safety_identifier: String?,
         ?size: OpenAI::Models::ImageEditParams::size?,
         ?user: String,
         ?request_options: OpenAI::RequestOptions

data/sig/openai/models/image_gen_completed_event.rbs

@@ -9,7 +9,8 @@ module OpenAI
         quality: OpenAI::Models::ImageGenCompletedEvent::quality,
         size: OpenAI::Models::ImageGenCompletedEvent::size,
         ?type: :"image_generation.completed",
-        usage: OpenAI::ImageGenCompletedEvent::Usage
+        usage: OpenAI::ImageGenCompletedEvent::Usage,
+        ?safety_identifier: String?
       }
 
     class ImageGenCompletedEvent < OpenAI::Internal::Type::BaseModel
@@ -38,6 +39,11 @@ module OpenAI
       # generation.
       attr_accessor usage: OpenAI::ImageGenCompletedEvent::Usage
 
+      # The effective safety identifier used for safety monitoring and abuse detection.
+      # This is the non-empty `safety_identifier` from the request, or the deprecated
+      # `user` value when `safety_identifier` is omitted, null, or empty.
+      attr_accessor safety_identifier: String?
+
       # @param b64_json
       #   Base64-encoded image data, suitable for rendering as an image.
       # @param background
@@ -53,6 +59,10 @@ module OpenAI
       # @param usage
       #   For the GPT image models only, the token usage information for the image
       #   generation.
+      # @param safety_identifier
+      #   The effective safety identifier used for safety monitoring and abuse detection.
+      #   This is the non-empty `safety_identifier` from the request, or the deprecated
+      #   `user` value when `safety_identifier` is omitted, null, or empty.
       # @param type
       #   The type of the event. Always `image_generation.completed`.
       def initialize: (
@@ -63,6 +73,7 @@ module OpenAI
         quality: OpenAI::Models::ImageGenCompletedEvent::quality,
         size: OpenAI::Models::ImageGenCompletedEvent::size,
         usage: OpenAI::ImageGenCompletedEvent::Usage,
+        ?safety_identifier: String?,
         ?type: :"image_generation.completed"
       ) -> void
 
@@ -74,7 +85,8 @@ module OpenAI
         quality: OpenAI::Models::ImageGenCompletedEvent::quality,
         size: OpenAI::Models::ImageGenCompletedEvent::size,
         ?type: :"image_generation.completed",
-        usage: OpenAI::ImageGenCompletedEvent::Usage
+        usage: OpenAI::ImageGenCompletedEvent::Usage,
+        ?safety_identifier: String?
       }
 
       type background = :transparent | :opaque | :auto

data/sig/openai/models/image_generate_params.rbs

@@ -12,6 +12,7 @@ module OpenAI
         ?partial_images: Integer?,
         ?quality: OpenAI::Models::ImageGenerateParams::quality?,
         ?response_format: OpenAI::Models::ImageGenerateParams::response_format?,
+        ?safety_identifier: String?,
         ?size: OpenAI::Models::ImageGenerateParams::size?,
         ?style: OpenAI::Models::ImageGenerateParams::style?,
         ?user: String,
@@ -82,6 +83,14 @@ module OpenAI
       # image models, which always return base64-encoded images.
       attr_accessor response_format: OpenAI::Models::ImageGenerateParams::response_format?
 
+      # A stable identifier for an end user in your organization, used for safety
+      # monitoring and abuse detection. Hash a username or email address to avoid
+      # sending identifying information. A non-empty value takes precedence over the
+      # deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+      # when available.
+      # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+      attr_accessor safety_identifier: String?
+
       # The size of the generated images. For `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`, arbitrary
@@ -98,13 +107,15 @@ module OpenAI
       # models; describe the desired style in the prompt instead.
       attr_accessor style: OpenAI::Models::ImageGenerateParams::style?
 
-      # A unique identifier representing your end-user, which can help OpenAI to monitor
-      # and detect abuse.
+      # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+      # backward compatibility and is used when `safety_identifier` is omitted, null, or
+      # empty.
       # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       attr_reader user: String?
 
-      # A unique identifier representing your end-user, which can help OpenAI to monitor
-      # and detect abuse.
+      # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+      # backward compatibility and is used when `safety_identifier` is omitted, null, or
+      # empty.
       # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       def user=: (String) -> String
 
@@ -158,6 +169,13 @@ module OpenAI
       # @param response_format
       #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
+      # @param safety_identifier
+      #   A stable identifier for an end user in your organization, used for safety
+      #   monitoring and abuse detection. Hash a username or email address to avoid
+      #   sending identifying information. A non-empty value takes precedence over the
+      #   deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+      #   when available.
+      #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       # @param size
       #   The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
       #   `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
@@ -173,8 +191,9 @@ module OpenAI
       #   Legacy style parameter for retired image models. Unsupported for GPT image
       #   models; describe the desired style in the prompt instead.
       # @param user
-      #   A unique identifier representing your end-user, which can help OpenAI to monitor
-      #   and detect abuse.
+      #   Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+      #   backward compatibility and is used when `safety_identifier` is omitted, null, or
+      #   empty.
       #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       def initialize: (
         prompt: String,
@@ -187,6 +206,7 @@ module OpenAI
         ?partial_images: Integer?,
         ?quality: OpenAI::Models::ImageGenerateParams::quality?,
         ?response_format: OpenAI::Models::ImageGenerateParams::response_format?,
+        ?safety_identifier: String?,
         ?size: OpenAI::Models::ImageGenerateParams::size?,
         ?style: OpenAI::Models::ImageGenerateParams::style?,
         ?user: String,
@@ -204,6 +224,7 @@ module OpenAI
         ?partial_images: Integer?,
         ?quality: OpenAI::Models::ImageGenerateParams::quality?,
         ?response_format: OpenAI::Models::ImageGenerateParams::response_format?,
+        ?safety_identifier: String?,
         ?size: OpenAI::Models::ImageGenerateParams::size?,
         ?style: OpenAI::Models::ImageGenerateParams::style?,
         ?user: String,

data/sig/openai/models/images_response.rbs

@@ -7,6 +7,7 @@ module OpenAI
         ?data: ::Array[OpenAI::Image],
         ?output_format: OpenAI::Models::ImagesResponse::output_format,
         ?quality: OpenAI::Models::ImagesResponse::quality,
+        ?safety_identifier: String?,
         ?size: OpenAI::Models::ImagesResponse::size,
         ?usage: OpenAI::ImagesResponse::Usage
       }
@@ -49,6 +50,11 @@ module OpenAI
         OpenAI::Models::ImagesResponse::quality
       ) -> OpenAI::Models::ImagesResponse::quality
 
+      # The effective safety identifier used for safety monitoring and abuse detection.
+      # This is the non-empty `safety_identifier` from the request, or the deprecated
+      # `user` value when `safety_identifier` is omitted, null, or empty.
+      attr_accessor safety_identifier: String?
+
       # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       attr_reader size: OpenAI::Models::ImagesResponse::size?
 
@@ -77,6 +83,10 @@ module OpenAI
       # @param quality
       #   The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
       #   `max`.
+      # @param safety_identifier
+      #   The effective safety identifier used for safety monitoring and abuse detection.
+      #   This is the non-empty `safety_identifier` from the request, or the deprecated
+      #   `user` value when `safety_identifier` is omitted, null, or empty.
       # @param size
       #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       # @param usage
@@ -87,6 +97,7 @@ module OpenAI
         ?data: ::Array[OpenAI::Image],
         ?output_format: OpenAI::Models::ImagesResponse::output_format,
         ?quality: OpenAI::Models::ImagesResponse::quality,
+        ?safety_identifier: String?,
         ?size: OpenAI::Models::ImagesResponse::size,
         ?usage: OpenAI::ImagesResponse::Usage
       ) -> void
@@ -97,6 +108,7 @@ module OpenAI
         ?data: ::Array[OpenAI::Image],
         ?output_format: OpenAI::Models::ImagesResponse::output_format,
         ?quality: OpenAI::Models::ImagesResponse::quality,
+        ?safety_identifier: String?,
         ?size: OpenAI::Models::ImagesResponse::size,
         ?usage: OpenAI::ImagesResponse::Usage
       }