openai 0.98.0 → 0.99.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 490515bf12013414fe683641c2357dc16e15a26354bbc9436fef0dc7b901589f
-  data.tar.gz: db7eeb1fb9efa3745ac7d8bc37789450aac6212eee254d5a25d6d63c1f59fcfa
+  metadata.gz: 7888217212b961954d41ed4bb25d807a08d7155598eac1c384819b35723ab529
+  data.tar.gz: ff4e8f985ffcd57f1aa276cead8dba172a1c686228afd15dd90f0dfa3f440078
 SHA512:
-  metadata.gz: b09e97bdd9d0589478bb3d68a31212e431e0ff1b691de4c54849fd993222ed14b9116417ddf31c1e7b9050478422305c86e314b2f28b8b587ddc81be13481250
-  data.tar.gz: 78664445a99113c083afbc48295d7e6a11bfcbdef798b69eb97e9283c8f77fc4477367895bf583a9c390af53925dd1fcb323c860e79c127b12edcc13b442c323
+  metadata.gz: 4d54994a5e2f72c57ffc898b6bf8ed1ba30745296900d4d6c0c41cde5d88c182f55d8295619140eed845e1741283b0d68704bf92fd4684c2b7a070b91d2c3ae8
+  data.tar.gz: c277185aabed1723fa217caa826ba9df358d40a3ab5018a8ed7a70ff7f13b9c1855543144a9ba8404c3ed95bbb4bdea095802a898878b8bfab6e49dd682939d7

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.99.0](https://github.com/openai/openai-ruby/compare/v0.98.0...v0.99.0) (2026-10-02)
+
+
+### Features
+
+* **api:** add custom voices and agent session webhook events ([#800](https://github.com/openai/openai-ruby/issues/800)) ([baaec48](https://github.com/openai/openai-ruby/commit/baaec487ca85117d6ee149cabdfe0cb8837d883c))
+
 ## [0.98.0](https://github.com/openai/openai-ruby/compare/v0.97.0...v0.98.0) (2026-10-01)
 
 

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.98.0"
+gem "openai", "~> 0.99.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -213,8 +213,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -310,7 +318,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -337,8 +345,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

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

@@ -215,8 +215,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -312,7 +320,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -339,8 +347,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

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

@@ -215,8 +215,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -312,7 +320,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -339,8 +347,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

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

@@ -211,8 +211,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -308,7 +316,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -335,8 +343,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

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

@@ -209,8 +209,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -306,7 +314,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -333,8 +341,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

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

@@ -211,8 +211,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -308,7 +316,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -335,8 +343,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

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

@@ -213,8 +213,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -310,7 +318,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -337,8 +345,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

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

@@ -209,8 +209,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -306,7 +314,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -333,8 +341,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

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

@@ -211,8 +211,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -308,7 +316,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -335,8 +343,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

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

@@ -213,8 +213,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -310,7 +318,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -337,8 +345,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

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

@@ -213,8 +213,16 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_audio_tokens, Integer
 
+                # @!attribute input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_12h_tokens, Integer
+
                 # @!attribute input_cache_write_tokens
-                #   The aggregated number of input tokens written to the cache.
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period.
                 #
                 #   @return [Integer, nil]
                 optional :input_cache_write_tokens, Integer
@@ -310,7 +318,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -337,8 +345,13 @@ module OpenAI
                 #   @param input_audio_tokens [Integer]
                 #     The aggregated number of uncached audio input tokens used.
                 #
+                #   @param input_cache_write_12h_tokens [Integer]
+                #     The aggregated number of input tokens written to the cache with a 12-hour
+                #     retention period.
+                #
                 #   @param input_cache_write_tokens [Integer]
-                #     The aggregated number of input tokens written to the cache.
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period.
                 #
                 #   @param input_cached_audio_tokens [Integer]
                 #     The aggregated number of cached audio input tokens used.

data/lib/openai/models/all_models.rb

@@ -14,21 +14,63 @@ module OpenAI
       module ResponsesOnlyModel
         extend OpenAI::Internal::Type::Enum
 
+        # @deprecated Announced shutdown date: 2026-10-23. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         O1_PRO = :"o1-pro"
+        # @deprecated Announced shutdown date: 2026-10-23. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         O1_PRO_2025_03_19 = :"o1-pro-2025-03-19"
+        # @deprecated Announced shutdown date: 2026-12-11. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         O3_PRO = :"o3-pro"
+        # @deprecated Announced shutdown date: 2026-12-11. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         O3_PRO_2025_06_10 = :"o3-pro-2025-06-10"
+        # @deprecated Announced shutdown date: 2026-07-23. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         O3_DEEP_RESEARCH = :"o3-deep-research"
+        # @deprecated Announced shutdown date: 2026-07-23. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         O3_DEEP_RESEARCH_2025_06_26 = :"o3-deep-research-2025-06-26"
+        # @deprecated Announced shutdown date: 2026-07-23. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         O4_MINI_DEEP_RESEARCH = :"o4-mini-deep-research"
+        # @deprecated Announced shutdown date: 2026-07-23. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         O4_MINI_DEEP_RESEARCH_2025_06_26 = :"o4-mini-deep-research-2025-06-26"
+        # @deprecated Announced shutdown date: 2026-07-23. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         COMPUTER_USE_PREVIEW = :"computer-use-preview"
+        # @deprecated Announced shutdown date: 2026-07-23. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         COMPUTER_USE_PREVIEW_2025_03_11 = :"computer-use-preview-2025-03-11"
         GPT_5_5_PRO = :"gpt-5.5-pro"
         GPT_5_5_PRO_2026_04_23 = :"gpt-5.5-pro-2026-04-23"
+        # @deprecated Announced shutdown date: 2026-07-23. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         GPT_5_CODEX = :"gpt-5-codex"
+        # @deprecated Announced shutdown date: 2026-12-11. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         GPT_5_PRO = :"gpt-5-pro"
+        # @deprecated Announced shutdown date: 2026-12-11. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         GPT_5_PRO_2025_10_06 = :"gpt-5-pro-2025-10-06"
+        # @deprecated Announced shutdown date: 2026-07-23. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         GPT_5_1_CODEX_MAX = :"gpt-5.1-codex-max"
         GPT_DAYBREAK_BLUE_LATEST = :"gpt-daybreak-blue-latest"
         GPT_DAYBREAK_RED_LATEST = :"gpt-daybreak-red-latest"

data/lib/openai/models/audio/speech_create_params.rb

@@ -29,6 +29,8 @@ module OpenAI
         #   object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         #   voices are available in the
         #   [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
+        #   Custom voices must be created from audio samples. Voices created from text
+        #   prompts are supported only in Live.
         #
         #   @return [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice::ID, OpenAI::Models::Audio::SpeechCreateParams::Voice]
         required :voice, union: -> { OpenAI::Audio::SpeechCreateParams::Voice }
@@ -77,6 +79,8 @@ module OpenAI
         #     object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         #     voices are available in the
         #     [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
+        #     Custom voices must be created from audio samples. Voices created from text
+        #     prompts are supported only in Live.
         #
         #   @param instructions [String]
         #     Control the voice of your generated audio with additional instructions. Does not
@@ -117,6 +121,8 @@ module OpenAI
         # object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         # voices are available in the
         # [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
+        # Custom voices must be created from audio samples. Voices created from text
+        # prompts are supported only in Live.
         module Voice
           extend OpenAI::Internal::Type::Union