openai 0.104.0 → 0.106.0

data/lib/openai.rb

@@ -973,6 +973,7 @@ require_relative "openai/models/decision_input_image"
 require_relative "openai/models/decision_input_message"
 require_relative "openai/models/decision_input_part"
 require_relative "openai/models/decision_input_text"
+require_relative "openai/models/decision_prompt_cache_breakpoint"
 require_relative "openai/models/deleted_skill"
 require_relative "openai/models/embedding"
 require_relative "openai/models/embedding_create_params"

data/rbi/openai/models/admin/organization/external_storage_configuration.rbi

@@ -128,6 +128,7 @@ module OpenAI
               :validated,
               OpenAI::Admin::Organization::ExternalStorageConfiguration::Status::TaggedSymbol
             )
+            DEGRADED = T.let(:degraded, OpenAI::Admin::Organization::ExternalStorageConfiguration::Status::TaggedSymbol)
             UNHEALTHY = T.let(
               :unhealthy,
               OpenAI::Admin::Organization::ExternalStorageConfiguration::Status::TaggedSymbol

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

@@ -208,6 +208,9 @@ module OpenAI
           # Uses the fast service tier.
           FAST = T.let(:fast, OpenAI::Beta::AgentCreateParams::ServiceTier::TaggedSymbol)
 
+          # Uses the ultrafast service tier.
+          ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::AgentCreateParams::ServiceTier::TaggedSymbol)
+
           sig { override.returns(T::Array[OpenAI::Beta::AgentCreateParams::ServiceTier::TaggedSymbol]) }
           def self.values
           end

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

@@ -219,6 +219,9 @@ module OpenAI
           # Uses the fast service tier.
           FAST = T.let(:fast, OpenAI::Beta::AgentUpdateParams::ServiceTier::TaggedSymbol)
 
+          # Uses the ultrafast service tier.
+          ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::AgentUpdateParams::ServiceTier::TaggedSymbol)
+
           sig { override.returns(T::Array[OpenAI::Beta::AgentUpdateParams::ServiceTier::TaggedSymbol]) }
           def self.values
           end

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

@@ -333,6 +333,9 @@ module OpenAI
               # Uses the fast service tier.
               FAST = T.let(:fast, OpenAI::Beta::Agents::SessionCreateParams::Agent::ServiceTier::TaggedSymbol)
 
+              # Uses the ultrafast service tier.
+              ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::Agents::SessionCreateParams::Agent::ServiceTier::TaggedSymbol)
+
               sig {
                 override.returns(T::Array[OpenAI::Beta::Agents::SessionCreateParams::Agent::ServiceTier::TaggedSymbol])
               }

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

@@ -251,6 +251,9 @@ module OpenAI
               # Uses the fast service tier.
               FAST = T.let(:fast, OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::TaggedSymbol)
 
+              # Uses the ultrafast service tier.
+              ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::TaggedSymbol)
+
               sig {
                 override.returns(T::Array[OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::TaggedSymbol])
               }

data/rbi/openai/models/decision_create_params.rbi

@@ -41,6 +41,22 @@ module OpenAI
       }
       attr_accessor :questions
 
+      # Partition prompt cache reuse by caller-provided key.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :prompt_cache_key
+
+      # 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.
+      sig { returns(T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::OrHash)) }
+      attr_accessor :prompt_cache_options
+
       # Opaque caller-provided end-user identifier, scoped by the verified org. Match
       # Responses' limit; this is never the authenticated user identity.
       sig { returns(T.nilable(String)) }
@@ -61,6 +77,10 @@ module OpenAI
             )
           ],
 
+          prompt_cache_key: T.nilable(String),
+
+          prompt_cache_options: T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::OrHash),
+
           safety_identifier: T.nilable(String),
 
           request_options: OpenAI::RequestOptions::OrHash
@@ -82,6 +102,20 @@ module OpenAI
         # or score. Answers come back in the same order.
         questions:,
 
+        # Partition prompt cache reuse by caller-provided key.
+        prompt_cache_key: nil,
+
+        # 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.
+        prompt_cache_options: nil,
+
         # Opaque caller-provided end-user identifier, scoped by the verified org. Match
         # Responses' limit; this is never the authenticated user identity.
         safety_identifier: nil,
@@ -102,6 +136,8 @@ module OpenAI
                 OpenAI::DecisionCreateParams::Question::Score
               )
             ],
+            prompt_cache_key: T.nilable(String),
+            prompt_cache_options: T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::OrHash),
             safety_identifier: T.nilable(String),
             request_options: OpenAI::RequestOptions
           }
@@ -440,6 +476,116 @@ module OpenAI
 
       end
 
+      class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::DecisionCreateParams::PromptCacheOptions,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # 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.
+        sig { returns(T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::OrSymbol)) }
+        attr_accessor :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.
+        sig { returns(T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::OrSymbol)) }
+        attr_reader :ttl
+
+        sig { params(ttl: OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::OrSymbol).void }
+        attr_writer :ttl
+
+        # 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.
+        sig do
+          params(
+
+            mode: T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::OrSymbol),
+
+            ttl: OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::OrSymbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # 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.
+          mode: nil,
+
+          # 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.
+
+          ttl: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              mode: T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::OrSymbol),
+              ttl: OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # 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.
+        module Mode
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::DecisionCreateParams::PromptCacheOptions::Mode) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          IMPLICIT = T.let(:implicit, OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::TaggedSymbol)
+          EXPLICIT = T.let(:explicit, OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::TaggedSymbol)
+
+          sig { override.returns(T::Array[OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::TaggedSymbol]) }
+          def self.values
+          end
+        end
+
+        # 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.
+        module Ttl
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          TTL_30M = T.let(:"30m", OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::TaggedSymbol)
+
+          sig { override.returns(T::Array[OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::TaggedSymbol]) }
+          def self.values
+          end
+        end
+      end
+
     end
 
   end

data/rbi/openai/models/decision_input_image.rbi

@@ -24,6 +24,15 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::DecisionInputImage::Detail::OrSymbol)) }
       attr_accessor :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.
+      sig { returns(T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash)) }
+      attr_reader :prompt_cache_breakpoint
+
+      sig { params(prompt_cache_breakpoint: T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash)).void }
+      attr_writer :prompt_cache_breakpoint
+
       # An image provided as a base64 data URL or a publicly accessible HTTP(S) URL.
       # File IDs are not supported.
       sig do
@@ -33,6 +42,8 @@ module OpenAI
 
           detail: T.nilable(OpenAI::DecisionInputImage::Detail::OrSymbol),
 
+          prompt_cache_breakpoint: T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash),
+
           type: Symbol
         )
           .returns(T.attached_class)
@@ -46,13 +57,23 @@ module OpenAI
         # auto.
         detail: nil,
 
+        # 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.
+        prompt_cache_breakpoint: nil,
+
         type: :input_image
       )
       end
 
       sig do
         override.returns(
-          {image_url: String, type: Symbol, detail: T.nilable(OpenAI::DecisionInputImage::Detail::OrSymbol)}
+          {
+            image_url: String,
+            type: Symbol,
+            detail: T.nilable(OpenAI::DecisionInputImage::Detail::OrSymbol),
+            prompt_cache_breakpoint: T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash)
+          }
         )
       end
       def to_hash

data/rbi/openai/models/decision_input_text.rbi

@@ -18,11 +18,22 @@ module OpenAI
       sig { returns(Symbol) }
       attr_accessor :type
 
+      # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+      # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+      # token block.
+      sig { returns(T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash)) }
+      attr_reader :prompt_cache_breakpoint
+
+      sig { params(prompt_cache_breakpoint: T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash)).void }
+      attr_writer :prompt_cache_breakpoint
+
       sig do
         params(
 
           text: String,
 
+          prompt_cache_breakpoint: T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash),
+
           type: Symbol
         )
           .returns(T.attached_class)
@@ -31,13 +42,22 @@ module OpenAI
 
         text:,
 
+        # 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.
+        prompt_cache_breakpoint: nil,
+
         type: :input_text
       )
       end
 
       sig do
         override.returns(
-          {text: String, type: Symbol}
+          {
+            text: String,
+            type: Symbol,
+            prompt_cache_breakpoint: T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash)
+          }
         )
       end
       def to_hash

data/rbi/openai/models/decision_prompt_cache_breakpoint.rbi

@@ -0,0 +1,48 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    class DecisionPromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
+
+      OrHash = T.type_alias do
+        T.any(
+          OpenAI::DecisionPromptCacheBreakpoint,
+          OpenAI::Internal::AnyHash
+        )
+      end
+
+      # The breakpoint mode. Always `explicit`.
+      sig { returns(Symbol) }
+      attr_accessor :mode
+
+      # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+      # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+      # token block.
+      sig do
+        params(
+
+          mode: Symbol
+        )
+          .returns(T.attached_class)
+      end
+      def self.new(
+
+        # The breakpoint mode. Always `explicit`.
+
+        mode: :explicit
+      )
+      end
+
+      sig do
+        override.returns(
+          {mode: Symbol}
+        )
+      end
+      def to_hash
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/image_edit_completed_event.rbi

@@ -48,6 +48,12 @@ module OpenAI
       sig { params(usage: OpenAI::ImageEditCompletedEvent::Usage::OrHash).void }
       attr_writer :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.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :safety_identifier
+
       # Emitted when image editing has completed and the final image is available.
       sig do
         params(
@@ -66,6 +72,8 @@ module OpenAI
 
           usage: OpenAI::ImageEditCompletedEvent::Usage::OrHash,
 
+          safety_identifier: T.nilable(String),
+
           type: Symbol
         )
           .returns(T.attached_class)
@@ -94,6 +102,11 @@ module OpenAI
         # generation.
         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.
+        safety_identifier: nil,
+
         # The type of the event. Always `image_edit.completed`.
 
         type: :"image_edit.completed"
@@ -110,7 +123,8 @@ module OpenAI
             quality: OpenAI::ImageEditCompletedEvent::Quality::TaggedSymbol,
             size: OpenAI::ImageEditCompletedEvent::Size::Variants,
             type: Symbol,
-            usage: OpenAI::ImageEditCompletedEvent::Usage
+            usage: OpenAI::ImageEditCompletedEvent::Usage,
+            safety_identifier: T.nilable(String)
           }
         )
       end

data/rbi/openai/models/image_edit_params.rbi

@@ -113,6 +113,15 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol)) }
       attr_accessor :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).
+      sig { returns(T.nilable(String)) }
+      attr_accessor :safety_identifier
+
       # 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
@@ -127,8 +136,9 @@ module OpenAI
       sig { returns(T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol))) }
       attr_accessor :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).
       sig { returns(T.nilable(String)) }
       attr_reader :user
@@ -163,6 +173,8 @@ module OpenAI
 
           response_format: T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
 
+          safety_identifier: T.nilable(String),
+
           size: T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol)),
 
           user: String,
@@ -256,6 +268,14 @@ module OpenAI
         # image models, which always return base64-encoded images.
         response_format: nil,
 
+        # 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).
+        safety_identifier: nil,
+
         # 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
@@ -269,8 +289,9 @@ module OpenAI
         # models that allow automatic sizing.
         size: nil,
 
-        # 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).
         user: nil,
 
@@ -293,6 +314,7 @@ module OpenAI
             partial_images: T.nilable(Integer),
             quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
             response_format: T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
+            safety_identifier: T.nilable(String),
             size: T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol)),
             user: String,
             request_options: OpenAI::RequestOptions

data/rbi/openai/models/image_gen_completed_event.rbi

@@ -48,6 +48,12 @@ module OpenAI
       sig { params(usage: OpenAI::ImageGenCompletedEvent::Usage::OrHash).void }
       attr_writer :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.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :safety_identifier
+
       # Emitted when image generation has completed and the final image is available.
       sig do
         params(
@@ -66,6 +72,8 @@ module OpenAI
 
           usage: OpenAI::ImageGenCompletedEvent::Usage::OrHash,
 
+          safety_identifier: T.nilable(String),
+
           type: Symbol
         )
           .returns(T.attached_class)
@@ -94,6 +102,11 @@ module OpenAI
         # generation.
         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.
+        safety_identifier: nil,
+
         # The type of the event. Always `image_generation.completed`.
 
         type: :"image_generation.completed"
@@ -110,7 +123,8 @@ module OpenAI
             quality: OpenAI::ImageGenCompletedEvent::Quality::TaggedSymbol,
             size: OpenAI::ImageGenCompletedEvent::Size::Variants,
             type: Symbol,
-            usage: OpenAI::ImageGenCompletedEvent::Usage
+            usage: OpenAI::ImageGenCompletedEvent::Usage,
+            safety_identifier: T.nilable(String)
           }
         )
       end

data/rbi/openai/models/image_generate_params.rbi

@@ -85,6 +85,15 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageGenerateParams::ResponseFormat::OrSymbol)) }
       attr_accessor :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).
+      sig { returns(T.nilable(String)) }
+      attr_accessor :safety_identifier
+
       # 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
@@ -103,8 +112,9 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageGenerateParams::Style::OrSymbol)) }
       attr_accessor :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).
       sig { returns(T.nilable(String)) }
       attr_reader :user
@@ -135,6 +145,8 @@ module OpenAI
 
           response_format: T.nilable(OpenAI::ImageGenerateParams::ResponseFormat::OrSymbol),
 
+          safety_identifier: T.nilable(String),
+
           size: T.nilable(T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol)),
 
           style: T.nilable(OpenAI::ImageGenerateParams::Style::OrSymbol),
@@ -207,6 +219,14 @@ module OpenAI
         # image models, which always return base64-encoded images.
         response_format: nil,
 
+        # 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).
+        safety_identifier: nil,
+
         # 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
@@ -223,8 +243,9 @@ module OpenAI
         # models; describe the desired style in the prompt instead.
         style: nil,
 
-        # 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).
         user: nil,
 
@@ -245,6 +266,7 @@ module OpenAI
             partial_images: T.nilable(Integer),
             quality: T.nilable(OpenAI::ImageGenerateParams::Quality::OrSymbol),
             response_format: T.nilable(OpenAI::ImageGenerateParams::ResponseFormat::OrSymbol),
+            safety_identifier: T.nilable(String),
             size: T.nilable(T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol)),
             style: T.nilable(OpenAI::ImageGenerateParams::Style::OrSymbol),
             user: String,

data/rbi/openai/models/images_response.rbi

@@ -46,6 +46,12 @@ module OpenAI
       sig { params(quality: OpenAI::ImagesResponse::Quality::OrSymbol).void }
       attr_writer :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.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :safety_identifier
+
       # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       sig { returns(T.nilable(OpenAI::ImagesResponse::Size::Variants)) }
       attr_reader :size
@@ -74,6 +80,8 @@ module OpenAI
 
           quality: OpenAI::ImagesResponse::Quality::OrSymbol,
 
+          safety_identifier: T.nilable(String),
+
           size: T.any(String, OpenAI::ImagesResponse::Size::OrSymbol),
 
           usage: OpenAI::ImagesResponse::Usage::OrHash
@@ -99,6 +107,11 @@ module OpenAI
         # `max`.
         quality: nil,
 
+        # 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.
+        safety_identifier: nil,
+
         # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
         size: nil,
 
@@ -116,6 +129,7 @@ module OpenAI
             data: T::Array[OpenAI::Image],
             output_format: OpenAI::ImagesResponse::OutputFormat::TaggedSymbol,
             quality: OpenAI::ImagesResponse::Quality::TaggedSymbol,
+            safety_identifier: T.nilable(String),
             size: OpenAI::ImagesResponse::Size::Variants,
             usage: OpenAI::ImagesResponse::Usage
           }

data/rbi/openai/models/live/output_audio_delta_event.rbi

@@ -79,7 +79,7 @@ module OpenAI
 
         sig do
           override.returns(
-            {delta: String, type: Symbol, end_ms: Integer, start_ms: Integer}
+            {delta: String, type: Symbol, end_ms: T.nilable(Integer), start_ms: T.nilable(Integer)}
           )
         end
         def to_hash