openai 0.104.0 → 0.106.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e16df42bfa691e5400644594e19849234985cf11213fd204361a9c7d8599205b
-  data.tar.gz: c6d3594da881c17292a1c4466604aa0af3cf2f92f369cbe640c9b2f2384f0d36
+  metadata.gz: c24e00e4168b6f3661b2eb29d8de97727d4bcd6a80e40f68512ab21c3c025b46
+  data.tar.gz: 16f33bff54375b5f3fb5174af63026f95e79ab2ca1cdfe6dd07cedfacac31568
 SHA512:
-  metadata.gz: 5127ae2d7c23c25e87b7ac3d10088b4cf8fd07a5f68a4dcf135956d1b72036e50af83f551991101f79b0c10d99ac2532a11e1e269ee8a9fed03fe2c2a6670c54
-  data.tar.gz: e09a526ec3a8eb15fef050fc5c15b6c4425022fd399ed982a8231170a18e390f140bef6ea29d04e15d9e241065bd05c8053060b81476e30cab849d0f61a38ca1
+  metadata.gz: 0fe9484b436e02d3b50981251596b57195cef1a604207b7b496049a2214b44eb3953447568b3dcfb3e1e0827279785587e66dfc1d2427c1fa858b7bcb87c54c1
+  data.tar.gz: 2cabbb26e7382803fbc4aa5ddcc47e3be1bad88c2d05510fb0a44f537653761a0c888157d407764ebeaab8de174cf5f8a44338ae868b16c016914b31cdd1978c

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## [0.106.0](https://github.com/openai/openai-ruby/compare/v0.105.0...v0.106.0) (2026-10-17)
+
+
+### Features
+
+* **api:** add Decisions prompt caching options ([#892](https://github.com/openai/openai-ruby/issues/892)) ([7b4dc7a](https://github.com/openai/openai-ruby/commit/7b4dc7adda7e1f7613aedd3efc29dba880e89dd2))
+* **api:** add degraded external storage status ([#901](https://github.com/openai/openai-ruby/issues/901)) ([e7207d2](https://github.com/openai/openai-ruby/commit/e7207d2b7b9de32649d98d6b6d2a24cdc1bd680b))
+* **api:** add typed Live sideband events and beta connections ([#903](https://github.com/openai/openai-ruby/issues/903)) ([90e6540](https://github.com/openai/openai-ruby/commit/90e654028d3c63146b7090040ed5c49961606c59))
+* **api:** add ultrafast service tier for Agents ([#904](https://github.com/openai/openai-ruby/issues/904)) ([65d8015](https://github.com/openai/openai-ruby/commit/65d80153f634243f62579bd21ca89d777b56b889))
+
+
+### Chores
+
+* **api:** add Assistants model shutdown notices ([#900](https://github.com/openai/openai-ruby/issues/900)) ([41a6400](https://github.com/openai/openai-ruby/commit/41a6400762bea831604d19200724a481c0f5ac94))
+* **api:** add shutdown notices for GPT-4 model aliases ([#898](https://github.com/openai/openai-ruby/issues/898)) ([2162219](https://github.com/openai/openai-ruby/commit/216221935f3d4a4d7e6649582556049a401dcc08))
+
+## [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.106.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/models/admin/organization/external_storage_configuration.rb

@@ -74,6 +74,7 @@ module OpenAI
 
             PENDING = :pending
             VALIDATED = :validated
+            DEGRADED = :degraded
             UNHEALTHY = :unhealthy
 
             # @!method self.values

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

@@ -125,6 +125,9 @@ module OpenAI
           # Uses the fast service tier.
           FAST = :fast
 
+          # Uses the ultrafast service tier.
+          ULTRAFAST = :ultrafast
+
           # @!method self.values
           #   @return [Array<Symbol>]
         end

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

@@ -132,6 +132,9 @@ module OpenAI
           # Uses the fast service tier.
           FAST = :fast
 
+          # Uses the ultrafast service tier.
+          ULTRAFAST = :ultrafast
+
           # @!method self.values
           #   @return [Array<Symbol>]
         end

data/lib/openai/models/beta/agents/session_create_params.rb

@@ -204,6 +204,9 @@ module OpenAI
               # Uses the fast service tier.
               FAST = :fast
 
+              # Uses the ultrafast service tier.
+              ULTRAFAST = :ultrafast
+
               # @!method self.values
               #   @return [Array<Symbol>]
             end

data/lib/openai/models/beta/agents/session_update_params.rb

@@ -151,6 +151,9 @@ module OpenAI
               # Uses the fast service tier.
               FAST = :fast
 
+              # Uses the ultrafast service tier.
+              ULTRAFAST = :ultrafast
+
               # @!method self.values
               #   @return [Array<Symbol>]
             end

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

@@ -316,7 +316,13 @@ module OpenAI
           GPT_5_2025_08_07 = :"gpt-5-2025-08-07"
           GPT_5_MINI_2025_08_07 = :"gpt-5-mini-2025-08-07"
           GPT_5_NANO_2025_08_07 = :"gpt-5-nano-2025-08-07"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1 = :"gpt-4.1"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1_MINI = :"gpt-4.1-mini"
           GPT_4_1_NANO = :"gpt-4.1-nano"
           GPT_4_1_2025_04_14 = :"gpt-4.1-2025-04-14"
@@ -326,10 +332,16 @@ module OpenAI
           O3_MINI_2025_01_31 = :"o3-mini-2025-01-31"
           O1 = :o1
           O1_2024_12_17 = :"o1-2024-12-17"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O = :"gpt-4o"
           GPT_4O_2024_11_20 = :"gpt-4o-2024-11-20"
           GPT_4O_2024_08_06 = :"gpt-4o-2024-08-06"
           GPT_4O_2024_05_13 = :"gpt-4o-2024-05-13"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_MINI = :"gpt-4o-mini"
           GPT_4O_MINI_2024_07_18 = :"gpt-4o-mini-2024-07-18"
           GPT_4_5_PREVIEW = :"gpt-4.5-preview"

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

@@ -995,7 +995,13 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_5_CHAT_LATEST = :"gpt-5-chat-latest"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1 = :"gpt-4.1"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1_MINI = :"gpt-4.1-mini"
           # @deprecated Announced shutdown date: 2026-10-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1061,6 +1067,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           O1_MINI_2024_09_12 = :"o1-mini-2024-09-12"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O = :"gpt-4o"
           # @deprecated Announced shutdown date: 2027-01-14. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1130,6 +1139,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           CODEX_MINI_LATEST = :"codex-mini-latest"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_MINI = :"gpt-4o-mini"
           # @deprecated Announced shutdown date: 2027-01-14. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -1382,7 +1382,13 @@ module OpenAI
             # https://developers.openai.com/api/docs/deprecations for details and recommended
             # replacements.
             GPT_5_CHAT_LATEST = :"gpt-5-chat-latest"
+            # @deprecated Announced shutdown date: 2027-01-14. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_4_1 = :"gpt-4.1"
+            # @deprecated Announced shutdown date: 2027-01-14. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_4_1_MINI = :"gpt-4.1-mini"
             # @deprecated Announced shutdown date: 2026-10-23. See
             # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1448,6 +1454,9 @@ module OpenAI
             # https://developers.openai.com/api/docs/deprecations for details and recommended
             # replacements.
             O1_MINI_2024_09_12 = :"o1-mini-2024-09-12"
+            # @deprecated Announced shutdown date: 2027-01-14. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_4O = :"gpt-4o"
             # @deprecated Announced shutdown date: 2027-01-14. See
             # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1517,6 +1526,9 @@ module OpenAI
             # https://developers.openai.com/api/docs/deprecations for details and recommended
             # replacements.
             CODEX_MINI_LATEST = :"codex-mini-latest"
+            # @deprecated Announced shutdown date: 2027-01-14. See
+            # https://developers.openai.com/api/docs/deprecations for details and recommended
+            # replacements.
             GPT_4O_MINI = :"gpt-4o-mini"
             # @deprecated Announced shutdown date: 2027-01-14. See
             # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -481,7 +481,13 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_5_CHAT_LATEST = :"gpt-5-chat-latest"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1 = :"gpt-4.1"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1_MINI = :"gpt-4.1-mini"
           # @deprecated Announced shutdown date: 2026-10-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -547,6 +553,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           O1_MINI_2024_09_12 = :"o1-mini-2024-09-12"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O = :"gpt-4o"
           # @deprecated Announced shutdown date: 2027-01-14. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -616,6 +625,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           CODEX_MINI_LATEST = :"codex-mini-latest"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_MINI = :"gpt-4o-mini"
           # @deprecated Announced shutdown date: 2027-01-14. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

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

@@ -1066,7 +1066,13 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_5_CHAT_LATEST = :"gpt-5-chat-latest"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1 = :"gpt-4.1"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1_MINI = :"gpt-4.1-mini"
           # @deprecated Announced shutdown date: 2026-10-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1132,6 +1138,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           O1_MINI_2024_09_12 = :"o1-mini-2024-09-12"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O = :"gpt-4o"
           # @deprecated Announced shutdown date: 2027-01-14. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -1201,6 +1210,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           CODEX_MINI_LATEST = :"codex-mini-latest"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_MINI = :"gpt-4o-mini"
           # @deprecated Announced shutdown date: 2027-01-14. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

data/lib/openai/models/chat_model.rb

@@ -77,7 +77,13 @@ module OpenAI
       # https://developers.openai.com/api/docs/deprecations for details and recommended
       # replacements.
       GPT_5_CHAT_LATEST = :"gpt-5-chat-latest"
+      # @deprecated Announced shutdown date: 2027-01-14. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4_1 = :"gpt-4.1"
+      # @deprecated Announced shutdown date: 2027-01-14. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4_1_MINI = :"gpt-4.1-mini"
       # @deprecated Announced shutdown date: 2026-10-23. See
       # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -143,6 +149,9 @@ module OpenAI
       # https://developers.openai.com/api/docs/deprecations for details and recommended
       # replacements.
       O1_MINI_2024_09_12 = :"o1-mini-2024-09-12"
+      # @deprecated Announced shutdown date: 2027-01-14. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4O = :"gpt-4o"
       # @deprecated Announced shutdown date: 2027-01-14. See
       # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -212,6 +221,9 @@ module OpenAI
       # https://developers.openai.com/api/docs/deprecations for details and recommended
       # replacements.
       CODEX_MINI_LATEST = :"codex-mini-latest"
+      # @deprecated Announced shutdown date: 2027-01-14. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4O_MINI = :"gpt-4o-mini"
       # @deprecated Announced shutdown date: 2027-01-14. See
       # https://developers.openai.com/api/docs/deprecations for details and recommended

data/lib/openai/models/decision_create_params.rb

@@ -29,6 +29,26 @@ module OpenAI
       #   @return [Array<OpenAI::Models::DecisionCreateParams::Question::Predicate, OpenAI::Models::DecisionCreateParams::Question::Choice, OpenAI::Models::DecisionCreateParams::Question::Score>]
       required :questions, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::DecisionCreateParams::Question] }
 
+      # @!attribute prompt_cache_key
+      #   Partition prompt cache reuse by caller-provided key.
+      #
+      #   @return [String, nil]
+      optional :prompt_cache_key, String, nil?: true
+
+      # @!attribute prompt_cache_options
+      #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
+      #   default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+      #   explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+      #   request can write up to four breakpoints. For cache matching, OpenAI considers
+      #   up to the latest 80 breakpoints in the conversation, without a content-block
+      #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+      #   `ttl` defaults to `30m`, which is currently the only supported value. See the
+      #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
+      #   for current details.
+      #
+      #   @return [OpenAI::Models::DecisionCreateParams::PromptCacheOptions, nil]
+      optional :prompt_cache_options, -> { OpenAI::DecisionCreateParams::PromptCacheOptions }, nil?: true
+
       # @!attribute safety_identifier
       #   Opaque caller-provided end-user identifier, scoped by the verified org. Match
       #   Responses' limit; this is never the authenticated user identity.
@@ -36,7 +56,7 @@ module OpenAI
       #   @return [String, nil]
       optional :safety_identifier, String, nil?: true
 
-      # @!method initialize(input:, model:, questions:, safety_identifier: nil, request_options: {})
+      # @!method initialize(input:, model:, questions:, prompt_cache_key: nil, prompt_cache_options: nil, safety_identifier: nil, request_options: {})
       #   @param input [String, Array<OpenAI::Models::DecisionInputMessage>]
       #     The text or images to evaluate for every question. Provide a text string or user
       #     messages containing text and images. Images can be base64 data URLs or publicly
@@ -50,6 +70,20 @@ module OpenAI
       #     Ask 1–200 questions about the input. Each question can be a predicate, choice,
       #     or score. Answers come back in the same order.
       #
+      #   @param prompt_cache_key [String, nil]
+      #     Partition prompt cache reuse by caller-provided key.
+      #
+      #   @param prompt_cache_options [OpenAI::Models::DecisionCreateParams::PromptCacheOptions, 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.
+      #
       #   @param safety_identifier [String, nil]
       #     Opaque caller-provided end-user identifier, scoped by the verified org. Match
       #     Responses' limit; this is never the authenticated user identity.
@@ -245,6 +279,83 @@ module OpenAI
         # @!method self.variants
         #   @return [Array(OpenAI::Models::DecisionCreateParams::Question::Predicate, OpenAI::Models::DecisionCreateParams::Question::Choice, OpenAI::Models::DecisionCreateParams::Question::Score)]
       end
+
+      class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+        # @!attribute mode
+        #   Controls whether OpenAI automatically creates an implicit cache breakpoint.
+        #   Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
+        #   and writes up to the latest three explicit breakpoints in the request. With
+        #   `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+        #   latest four explicit breakpoints. If there are no explicit breakpoints, the
+        #   request does not use prompt caching.
+        #
+        #   @return [Symbol, OpenAI::Models::DecisionCreateParams::PromptCacheOptions::Mode, nil]
+        optional :mode, enum: -> { OpenAI::DecisionCreateParams::PromptCacheOptions::Mode }, nil?: true
+
+        # @!attribute ttl
+        #   The minimum lifetime applied to every implicit and explicit cache breakpoint
+        #   written by the request. Defaults to `30m`, which is currently the only supported
+        #   value. The backend may retain cache entries for longer.
+        #
+        #   @return [Symbol, OpenAI::Models::DecisionCreateParams::PromptCacheOptions::Ttl, nil]
+        optional :ttl, enum: -> { OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl }
+
+        # @!method initialize(mode: nil, ttl: 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.
+        #
+        #   @param mode [Symbol, OpenAI::Models::DecisionCreateParams::PromptCacheOptions::Mode, nil]
+        #     Controls whether OpenAI automatically creates an implicit cache breakpoint.
+        #     Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
+        #     and writes up to the latest three explicit breakpoints in the request. With
+        #     `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+        #     latest four explicit breakpoints. If there are no explicit breakpoints, the
+        #     request does not use prompt caching.
+        #
+        #   @param ttl [Symbol, OpenAI::Models::DecisionCreateParams::PromptCacheOptions::Ttl]
+        #     The minimum lifetime applied to every implicit and explicit cache breakpoint
+        #     written by the request. Defaults to `30m`, which is currently the only supported
+        #     value. The backend may retain cache entries for longer.
+
+        # 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.
+        #
+        # @see OpenAI::Models::DecisionCreateParams::PromptCacheOptions#mode
+        module Mode
+          extend OpenAI::Internal::Type::Enum
+
+          IMPLICIT = :implicit
+          EXPLICIT = :explicit
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        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.
+        #
+        # @see OpenAI::Models::DecisionCreateParams::PromptCacheOptions#ttl
+        module Ttl
+          extend OpenAI::Internal::Type::Enum
+
+          TTL_30M = :"30m"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
     end
   end
 end

data/lib/openai/models/decision_input_image.rb

@@ -21,7 +21,15 @@ module OpenAI
       #   @return [Symbol, OpenAI::Models::DecisionInputImage::Detail, nil]
       optional :detail, enum: -> { OpenAI::DecisionInputImage::Detail }, nil?: true
 
-      # @!method initialize(image_url:, detail: nil, type: :input_image)
+      # @!attribute prompt_cache_breakpoint
+      #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+      #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+      #   token block.
+      #
+      #   @return [OpenAI::Models::DecisionPromptCacheBreakpoint, nil]
+      optional :prompt_cache_breakpoint, -> { OpenAI::DecisionPromptCacheBreakpoint }, nil?: true
+
+      # @!method initialize(image_url:, detail: nil, prompt_cache_breakpoint: nil, type: :input_image)
       #   An image provided as a base64 data URL or a publicly accessible HTTP(S) URL.
       #   File IDs are not supported.
       #
@@ -32,6 +40,11 @@ module OpenAI
       #     The image detail level, using the selected model's image profile. Defaults to
       #     auto.
       #
+      #   @param prompt_cache_breakpoint [OpenAI::Models::DecisionPromptCacheBreakpoint, 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.
+      #
       #   @param type [Symbol, :input_image]
 
       # The image detail level, using the selected model's image profile. Defaults to

data/lib/openai/models/decision_input_text.rb

@@ -13,8 +13,22 @@ module OpenAI
       #   @return [Symbol, :input_text]
       required :type, const: :input_text
 
-      # @!method initialize(text:, type: :input_text)
+      # @!attribute prompt_cache_breakpoint
+      #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+      #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+      #   token block.
+      #
+      #   @return [OpenAI::Models::DecisionPromptCacheBreakpoint, nil]
+      optional :prompt_cache_breakpoint, -> { OpenAI::DecisionPromptCacheBreakpoint }, nil?: true
+
+      # @!method initialize(text:, prompt_cache_breakpoint: nil, type: :input_text)
       #   @param text [String]
+      #
+      #   @param prompt_cache_breakpoint [OpenAI::Models::DecisionPromptCacheBreakpoint, 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.
+      #
       #   @param type [Symbol, :input_text]
     end
   end

data/lib/openai/models/decision_prompt_cache_breakpoint.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    class DecisionPromptCacheBreakpoint < OpenAI::Internal::Type::BaseModel
+      # @!attribute mode
+      #   The breakpoint mode. Always `explicit`.
+      #
+      #   @return [Symbol, :explicit]
+      required :mode, const: :explicit
+
+      # @!method initialize(mode: :explicit)
+      #   Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+      #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+      #   token block.
+      #
+      #   @param mode [Symbol, :explicit]
+      #     The breakpoint mode. Always `explicit`.
+    end
+  end
+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}]