openai 0.104.0 → 0.105.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e16df42bfa691e5400644594e19849234985cf11213fd204361a9c7d8599205b
-  data.tar.gz: c6d3594da881c17292a1c4466604aa0af3cf2f92f369cbe640c9b2f2384f0d36
+  metadata.gz: 3cf6a76c197d61e6798bc42692ee2d650c264346d4f94845644bb44930769970
+  data.tar.gz: 3bc493a3d8be33ce44a76f98662641f835523703fec8cd9932e6de926403583d
 SHA512:
-  metadata.gz: 5127ae2d7c23c25e87b7ac3d10088b4cf8fd07a5f68a4dcf135956d1b72036e50af83f551991101f79b0c10d99ac2532a11e1e269ee8a9fed03fe2c2a6670c54
-  data.tar.gz: e09a526ec3a8eb15fef050fc5c15b6c4425022fd399ed982a8231170a18e390f140bef6ea29d04e15d9e241065bd05c8053060b81476e30cab849d0f61a38ca1
+  metadata.gz: a37404e98840aa8015d0d882e7e88ae0470611198d8327b691e061be71c08a456c3c9878c70ac2734ba30f74ec3ee9e122ab1633e627895ef05e0a5771001e6f
+  data.tar.gz: df0f1aef627413e41101cc122aa6bc6b8f0dbac8933f92fea715fc79cf11ca15e45e1a6dfb77f789fcbe16a3fea63e177e9970bc72058206846239e90a4f75cd

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.105.0](https://github.com/openai/openai-ruby/compare/v0.104.0...v0.105.0) (2026-10-16)
+
+
+### Features
+
+* **api:** add safety identifiers to image requests and responses ([#894](https://github.com/openai/openai-ruby/issues/894)) ([d74e0d5](https://github.com/openai/openai-ruby/commit/d74e0d5737c34a2201780ceb961ac0f7302621cc))
+
+
+### Bug Fixes
+
+* **api:** omit nil safety identifiers from image edits ([#896](https://github.com/openai/openai-ruby/issues/896)) ([a4dbd91](https://github.com/openai/openai-ruby/commit/a4dbd91cbc38ae66a641353c9cc042956cd46bdf))
+
+
+### Chores
+
+* **api:** maintain webhook verification compatibility ([#893](https://github.com/openai/openai-ruby/issues/893)) ([adbde58](https://github.com/openai/openai-ruby/commit/adbde58c45c1241a49a89c03bdb1e350c0ea0ddb))
+
 ## [0.104.0](https://github.com/openai/openai-ruby/compare/v0.103.0...v0.104.0) (2026-10-16)
 
 

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.104.0"
+gem "openai", "~> 0.105.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/models/image_edit_completed_event.rb

@@ -52,7 +52,15 @@ module OpenAI
       #   @return [OpenAI::Models::ImageEditCompletedEvent::Usage]
       required :usage, -> { OpenAI::ImageEditCompletedEvent::Usage }
 
-      # @!method initialize(b64_json:, background:, created_at:, output_format:, quality:, size:, usage:, type: :"image_edit.completed")
+      # @!attribute 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.
+      #
+      #   @return [String, nil]
+      optional :safety_identifier, String, nil?: true
+
+      # @!method initialize(b64_json:, background:, created_at:, output_format:, quality:, size:, usage:, safety_identifier: nil, type: :"image_edit.completed")
       #   Emitted when image editing has completed and the final image is available.
       #
       #   @param b64_json [String]
@@ -77,6 +85,11 @@ module OpenAI
       #     For the GPT image models only, the token usage information for the image
       #     generation.
       #
+      #   @param safety_identifier [String, 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.
+      #
       #   @param type [Symbol, :"image_edit.completed"]
       #     The type of the event. Always `image_edit.completed`.
 

data/lib/openai/models/image_edit_params.rb

@@ -130,6 +130,17 @@ module OpenAI
       #   @return [Symbol, OpenAI::Models::ImageEditParams::ResponseFormat, nil]
       optional :response_format, enum: -> { OpenAI::ImageEditParams::ResponseFormat }, nil?: true
 
+      # @!attribute 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).
+      #
+      #   @return [String, nil]
+      optional :safety_identifier, String, nil?: true
+
       # @!attribute 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`,
@@ -147,14 +158,17 @@ module OpenAI
       optional :size, union: -> { OpenAI::ImageEditParams::Size }, nil?: true
 
       # @!attribute user
-      #   A unique identifier representing your end-user, which can help OpenAI to monitor
-      #   and detect abuse.
+      #   @deprecated
+      #
+      #   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).
       #
       #   @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, size: nil, user: nil, request_options: {})
+      # @!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: {})
       #   @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.
       #
@@ -238,6 +252,14 @@ module OpenAI
       #     Legacy response format parameter for retired image models. Unsupported for GPT
       #     image models, which always return base64-encoded images.
       #
+      #   @param safety_identifier [String, 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).
+      #
       #   @param size [String, Symbol, OpenAI::Models::ImageEditParams::Size, 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`,
@@ -252,8 +274,9 @@ module OpenAI
       #     models that allow automatic sizing.
       #
       #   @param 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).
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/image_gen_completed_event.rb

@@ -52,7 +52,15 @@ module OpenAI
       #   @return [OpenAI::Models::ImageGenCompletedEvent::Usage]
       required :usage, -> { OpenAI::ImageGenCompletedEvent::Usage }
 
-      # @!method initialize(b64_json:, background:, created_at:, output_format:, quality:, size:, usage:, type: :"image_generation.completed")
+      # @!attribute 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.
+      #
+      #   @return [String, nil]
+      optional :safety_identifier, String, nil?: true
+
+      # @!method initialize(b64_json:, background:, created_at:, output_format:, quality:, size:, usage:, safety_identifier: nil, type: :"image_generation.completed")
       #   Emitted when image generation has completed and the final image is available.
       #
       #   @param b64_json [String]
@@ -77,6 +85,11 @@ module OpenAI
       #     For the GPT image models only, the token usage information for the image
       #     generation.
       #
+      #   @param safety_identifier [String, 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.
+      #
       #   @param type [Symbol, :"image_generation.completed"]
       #     The type of the event. Always `image_generation.completed`.
 

data/lib/openai/models/image_generate_params.rb

@@ -101,6 +101,17 @@ module OpenAI
       #   @return [Symbol, OpenAI::Models::ImageGenerateParams::ResponseFormat, nil]
       optional :response_format, enum: -> { OpenAI::ImageGenerateParams::ResponseFormat }, nil?: true
 
+      # @!attribute 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).
+      #
+      #   @return [String, nil]
+      optional :safety_identifier, String, nil?: true
+
       # @!attribute 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`,
@@ -126,14 +137,17 @@ module OpenAI
       optional :style, enum: -> { OpenAI::ImageGenerateParams::Style }, nil?: true
 
       # @!attribute user
-      #   A unique identifier representing your end-user, which can help OpenAI to monitor
-      #   and detect abuse.
+      #   @deprecated
+      #
+      #   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).
       #
       #   @return [String, nil]
       optional :user, String
 
-      # @!method initialize(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, style: nil, user: nil, request_options: {})
+      # @!method initialize(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, style: nil, user: nil, request_options: {})
       #   @param prompt [String]
       #     A text description of the desired image(s). The maximum length is 32000
       #     characters.
@@ -194,6 +208,14 @@ module OpenAI
       #     Legacy response format parameter for retired image models. Unsupported for GPT
       #     image models, which always return base64-encoded images.
       #
+      #   @param safety_identifier [String, 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).
+      #
       #   @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, 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`,
@@ -211,8 +233,9 @@ module OpenAI
       #     models; describe the desired style in the prompt instead.
       #
       #   @param 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).
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/images_response.rb

@@ -36,6 +36,14 @@ module OpenAI
       #   @return [Symbol, OpenAI::Models::ImagesResponse::Quality, nil]
       optional :quality, enum: -> { OpenAI::ImagesResponse::Quality }
 
+      # @!attribute 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.
+      #
+      #   @return [String, nil]
+      optional :safety_identifier, String, nil?: true
+
       # @!attribute size
       #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #
@@ -48,7 +56,7 @@ module OpenAI
       #   @return [OpenAI::Models::ImagesResponse::Usage, nil]
       optional :usage, -> { OpenAI::ImagesResponse::Usage }
 
-      # @!method initialize(created:, background: nil, data: nil, output_format: nil, quality: nil, size: nil, usage: nil)
+      # @!method initialize(created:, background: nil, data: nil, output_format: nil, quality: nil, safety_identifier: nil, size: nil, usage: nil)
       #   The response from the image generation endpoint.
       #
       #   @param created [Integer]
@@ -68,6 +76,11 @@ module OpenAI
       #     The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
       #     `max`.
       #
+      #   @param safety_identifier [String, 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.
+      #
       #   @param size [String, Symbol, OpenAI::Models::ImagesResponse::Size]
       #     The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       #

data/lib/openai/resources/images.rb

@@ -72,7 +72,7 @@ module OpenAI
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
       # content type.
       #
-      # @overload edit(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, size: nil, user: nil, request_options: {})
+      # @overload edit(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: {})
       #
       # @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.
@@ -157,6 +157,14 @@ module OpenAI
       #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
+      # @param safety_identifier [String, 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).
+      #
       # @param size [String, Symbol, OpenAI::Models::ImageEditParams::Size, 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`,
@@ -171,8 +179,9 @@ module OpenAI
       #   models that allow automatic sizing.
       #
       # @param 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).
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -187,6 +196,7 @@ module OpenAI
           raise ArgumentError.new(message)
         end
 
+        parsed.delete(:safety_identifier) if parsed[:safety_identifier].nil?
         @client.request(
           method: :post,
           path: "images/edits",
@@ -207,7 +217,7 @@ module OpenAI
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
       # content type.
       #
-      # @overload edit_stream_raw(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, size: nil, user: nil, request_options: {})
+      # @overload edit_stream_raw(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: {})
       #
       # @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.
@@ -292,6 +302,14 @@ module OpenAI
       #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
+      # @param safety_identifier [String, 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).
+      #
       # @param size [String, Symbol, OpenAI::Models::ImageEditParams::Size, 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`,
@@ -306,8 +324,9 @@ module OpenAI
       #   models that allow automatic sizing.
       #
       # @param 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).
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -323,6 +342,7 @@ module OpenAI
         end
 
         parsed.store(:stream, true)
+        parsed.delete(:safety_identifier) if parsed[:safety_identifier].nil?
         @client.request(
           method: :post,
           path: "images/edits",
@@ -344,7 +364,7 @@ module OpenAI
       # Creates an image given a prompt using a GPT Image model.
       # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       #
-      # @overload generate(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, style: nil, user: nil, request_options: {})
+      # @overload generate(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, style: nil, user: nil, request_options: {})
       #
       # @param prompt [String]
       #   A text description of the desired image(s). The maximum length is 32000
@@ -406,6 +426,14 @@ module OpenAI
       #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
+      # @param safety_identifier [String, 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).
+      #
       # @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, 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`,
@@ -423,8 +451,9 @@ module OpenAI
       #   models; describe the desired style in the prompt instead.
       #
       # @param 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).
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -454,7 +483,7 @@ module OpenAI
       # Creates an image given a prompt using a GPT Image model.
       # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       #
-      # @overload generate_stream_raw(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, style: nil, user: nil, request_options: {})
+      # @overload generate_stream_raw(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, style: nil, user: nil, request_options: {})
       #
       # @param prompt [String]
       #   A text description of the desired image(s). The maximum length is 32000
@@ -516,6 +545,14 @@ module OpenAI
       #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
+      # @param safety_identifier [String, 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).
+      #
       # @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, 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`,
@@ -533,8 +570,9 @@ module OpenAI
       #   models; describe the desired style in the prompt instead.
       #
       # @param 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).
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.104.0"
+  VERSION = "0.105.0"
 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/resources/images.rbi

@@ -67,6 +67,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,
           stream: T.noreturn,
@@ -146,6 +147,13 @@ module OpenAI
         # Legacy response format parameter for retired image models. Unsupported for GPT
         # 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
@@ -158,8 +166,9 @@ module OpenAI
         # `1024x1536` are supported by the GPT image models; `auto` is supported for
         # 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,
         # There is no need to provide `stream:`. Instead, use `#edit_stream_raw` or
@@ -187,6 +196,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,
           stream: T.noreturn,
@@ -266,6 +276,13 @@ module OpenAI
         # Legacy response format parameter for retired image models. Unsupported for GPT
         # 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
@@ -278,8 +295,9 @@ module OpenAI
         # `1024x1536` are supported by the GPT image models; `auto` is supported for
         # 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,
         # There is no need to provide `stream:`. Instead, use `#edit_stream_raw` or
@@ -305,6 +323,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,
@@ -364,6 +383,13 @@ module OpenAI
         # Legacy response format parameter for retired image models. Unsupported for GPT
         # 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
@@ -378,8 +404,9 @@ module OpenAI
         # Legacy style parameter for retired image models. Unsupported for GPT image
         # 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,
         # There is no need to provide `stream:`. Instead, use `#generate_stream_raw` or
@@ -405,6 +432,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,
@@ -464,6 +492,13 @@ module OpenAI
         # Legacy response format parameter for retired image models. Unsupported for GPT
         # 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
@@ -478,8 +513,9 @@ module OpenAI
         # Legacy style parameter for retired image models. Unsupported for GPT image
         # 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,
         # There is no need to provide `stream:`. Instead, use `#generate_stream_raw` or

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
       }

data/sig/openai/resources/images.rbs

@@ -24,6 +24,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
@@ -42,6 +43,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
@@ -58,6 +60,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,
@@ -75,6 +78,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,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openai
 version: !ruby/object:Gem::Version
-  version: 0.104.0
+  version: 0.105.0
 platform: ruby
 authors:
 - OpenAI