openai 0.98.0 → 0.99.0

data/rbi/openai/resources/images.rbi

@@ -6,7 +6,9 @@ module OpenAI
     # Given a prompt and/or an input image, the model will generate a new image.
     class Images
 
-      # Creates a variation of a given image. This endpoint only supports `dall-e-2`.
+      # This endpoint is retired and no longer available. Use the image edits endpoint
+      # with a GPT Image model and a prompt to create a variation of an image. The
+      # request and response schemas below describe the legacy contract.
       sig {
         params(
           image: OpenAI::Internal::FileInput,
@@ -27,8 +29,8 @@ module OpenAI
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.
         image:,
-        # The model to use for image generation. Only `dall-e-2` is supported at this
-        # time.
+        # The legacy model used by the retired image variations endpoint. This endpoint no
+        # longer accepts requests.
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
         n: nil,
@@ -50,7 +52,7 @@ module OpenAI
       # See {OpenAI::Resources::Images#edit_stream_raw} for streaming counterpart.
       #
       # Creates an edited or extended image given one or more source images and a
-      # prompt. This endpoint supports GPT Image models and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models.
       sig {
         params(
           image: OpenAI::ImageEditParams::Image::Variants,
@@ -82,15 +84,12 @@ module OpenAI
         # be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
         # images.
         #
-        # For `dall-e-2`, you can only provide one image, and it should be a square `png`
-        # file less than 4MB.
-        #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.
         image:,
-        # A text description of the desired image(s). The maximum length is 1000
-        # characters for `dall-e-2`, and 32000 characters for the GPT image models.
+        # A text description of the desired image(s). The maximum length is 32000
+        # characters for the GPT image models.
         prompt:,
         # Allows to set transparency for the background of the generated image(s). Must be
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
@@ -115,12 +114,11 @@ module OpenAI
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.
         mask: nil,
-        # The model to use for image generation. One of `dall-e-2` or a GPT image model
-        # (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `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`,
-        # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`). Defaults to
-        # `gpt-image-1.5`.
+        # The GPT image model to use for image editing (`gpt-image-1`, `gpt-image-1-mini`,
+        # `gpt-image-1.5`, `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`, `gpt-image-2.5-flare-2026-09-08`, or
+        # `chatgpt-image-latest`).
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
         n: nil,
@@ -144,23 +142,20 @@ module OpenAI
         # `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, also support
         # `xhigh` and `max`. Defaults to `auto`.
         quality: nil,
-        # The format in which the generated images are returned. Must be one of `url` or
-        # `b64_json`. URLs are only valid for 60 minutes after the image has been
-        # generated. This parameter is only supported for `dall-e-2` (default is `url` for
-        # `dall-e-2`), as GPT image models always return base64-encoded images.
+        # Legacy response format parameter for retired image models. Unsupported for GPT
+        # image models, which always return base64-encoded images.
         response_format: 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
-        # resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
-        # Width and height must both be divisible by 16 and the requested aspect ratio
-        # must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
-        # the maximum supported resolution is `3840x2160`. The requested size must also
-        # satisfy the model's current pixel and edge limits. The standard sizes
-        # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-        # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-        # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-        # `1024x1024`, `1792x1024`, or `1024x1792`.
+        # 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
+        # `gpt-image-2.5-flare-2026-09-08`, arbitrary resolutions are supported as
+        # `WIDTHxHEIGHT` strings, for example `1536x864`. Width and height must both be
+        # divisible by 16 and the requested aspect ratio must be between 1:3 and 3:1.
+        # Resolutions above `2560x1440` are experimental, and the maximum supported
+        # resolution is `3840x2160`. The requested size must also satisfy the model's
+        # current pixel and edge limits. The standard sizes `1024x1024`, `1536x1024`, and
+        # `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.
@@ -176,7 +171,7 @@ module OpenAI
       # See {OpenAI::Resources::Images#edit} for non-streaming counterpart.
       #
       # Creates an edited or extended image given one or more source images and a
-      # prompt. This endpoint supports GPT Image models and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models.
       sig {
         params(
           image: OpenAI::ImageEditParams::Image::Variants,
@@ -208,15 +203,12 @@ module OpenAI
         # be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
         # images.
         #
-        # For `dall-e-2`, you can only provide one image, and it should be a square `png`
-        # file less than 4MB.
-        #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.
         image:,
-        # A text description of the desired image(s). The maximum length is 1000
-        # characters for `dall-e-2`, and 32000 characters for the GPT image models.
+        # A text description of the desired image(s). The maximum length is 32000
+        # characters for the GPT image models.
         prompt:,
         # Allows to set transparency for the background of the generated image(s). Must be
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
@@ -241,12 +233,11 @@ module OpenAI
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.
         mask: nil,
-        # The model to use for image generation. One of `dall-e-2` or a GPT image model
-        # (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `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`,
-        # `gpt-image-2.5-flare-2026-09-08`, or `chatgpt-image-latest`). Defaults to
-        # `gpt-image-1.5`.
+        # The GPT image model to use for image editing (`gpt-image-1`, `gpt-image-1-mini`,
+        # `gpt-image-1.5`, `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`, `gpt-image-2.5-flare-2026-09-08`, or
+        # `chatgpt-image-latest`).
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
         n: nil,
@@ -270,23 +261,20 @@ module OpenAI
         # `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, also support
         # `xhigh` and `max`. Defaults to `auto`.
         quality: nil,
-        # The format in which the generated images are returned. Must be one of `url` or
-        # `b64_json`. URLs are only valid for 60 minutes after the image has been
-        # generated. This parameter is only supported for `dall-e-2` (default is `url` for
-        # `dall-e-2`), as GPT image models always return base64-encoded images.
+        # Legacy response format parameter for retired image models. Unsupported for GPT
+        # image models, which always return base64-encoded images.
         response_format: 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
-        # resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
-        # Width and height must both be divisible by 16 and the requested aspect ratio
-        # must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
-        # the maximum supported resolution is `3840x2160`. The requested size must also
-        # satisfy the model's current pixel and edge limits. The standard sizes
-        # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-        # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-        # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-        # `1024x1024`, `1792x1024`, or `1024x1792`.
+        # 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
+        # `gpt-image-2.5-flare-2026-09-08`, arbitrary resolutions are supported as
+        # `WIDTHxHEIGHT` strings, for example `1536x864`. Width and height must both be
+        # divisible by 16 and the requested aspect ratio must be between 1:3 and 3:1.
+        # Resolutions above `2560x1440` are experimental, and the maximum supported
+        # resolution is `3840x2160`. The requested size must also satisfy the model's
+        # current pixel and edge limits. The standard sizes `1024x1024`, `1536x1024`, and
+        # `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.
@@ -301,7 +289,7 @@ module OpenAI
 
       # See {OpenAI::Resources::Images#generate_stream_raw} for streaming counterpart.
       #
-      # Creates an image given a prompt.
+      # Creates an image given a prompt using a GPT Image model.
       # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       sig {
         params(
@@ -325,8 +313,7 @@ module OpenAI
       }
       def generate(
         # A text description of the desired image(s). The maximum length is 32000
-        # characters for the GPT image models, 1000 characters for `dall-e-2` and 4000
-        # characters for `dall-e-3`.
+        # characters.
         prompt:,
         # Allows to set transparency for the background of the generated image(s). Must be
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
@@ -338,19 +325,17 @@ module OpenAI
         # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
         # set the output format to `png` or `webp`.
         background: nil,
-        # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
-        # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
-        # `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+        # The GPT image model to use for image generation. Specify a model explicitly.
+        # Supported models include `gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
+        # `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`,
-        # `gpt-image-2.5-flare-2026-09-08`). Defaults to `dall-e-2` unless a parameter
-        # specific to the GPT image models is used.
+        # `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`.
         model: nil,
         # Control the content-moderation level for images generated by the GPT image
         # models. Must be either `low` for less restrictive filtering or `auto` (default
         # value).
         moderation: nil,
-        # The number of images to generate. Must be between 1 and 10. For `dall-e-3`, only
-        # `n=1` is supported.
+        # The number of images to generate. Must be between 1 and 10.
         n: nil,
         # The compression level (0-100%) for the generated images. This parameter is only
         # supported for the GPT image models with the `webp` or `jpeg` output formats, and
@@ -373,12 +358,8 @@ module OpenAI
         # - `high`, `medium` and `low` are supported for the GPT image models.
         # - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
         #   `2026-09-08` snapshots, also support `xhigh` and `max`.
-        # - `hd` and `standard` are supported for `dall-e-3`.
-        # - `standard` is the only option for `dall-e-2`.
         quality: nil,
-        # The format in which generated images with `dall-e-2` and `dall-e-3` are
-        # returned. Must be one of `url` or `b64_json`. URLs are only valid for 60 minutes
-        # after the image has been generated. This parameter isn't supported for the GPT
+        # Legacy response format parameter for retired image models. Unsupported for GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
         # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
@@ -390,14 +371,10 @@ module OpenAI
         # the maximum supported resolution is `3840x2160`. The requested size must also
         # satisfy the model's current pixel and edge limits. The standard sizes
         # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-        # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-        # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-        # `1024x1024`, `1792x1024`, or `1024x1792`.
+        # `auto` is supported for models that allow automatic sizing.
         size: nil,
-        # The style of the generated images. This parameter is only supported for
-        # `dall-e-3`. Must be one of `vivid` or `natural`. Vivid causes the model to lean
-        # towards generating hyper-real and dramatic images. Natural causes the model to
-        # produce more natural, less hyper-real looking images.
+        # 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.
@@ -412,7 +389,7 @@ module OpenAI
 
       # See {OpenAI::Resources::Images#generate} for non-streaming counterpart.
       #
-      # Creates an image given a prompt.
+      # Creates an image given a prompt using a GPT Image model.
       # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       sig {
         params(
@@ -436,8 +413,7 @@ module OpenAI
       }
       def generate_stream_raw(
         # A text description of the desired image(s). The maximum length is 32000
-        # characters for the GPT image models, 1000 characters for `dall-e-2` and 4000
-        # characters for `dall-e-3`.
+        # characters.
         prompt:,
         # Allows to set transparency for the background of the generated image(s). Must be
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
@@ -449,19 +425,17 @@ module OpenAI
         # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
         # set the output format to `png` or `webp`.
         background: nil,
-        # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
-        # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
-        # `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+        # The GPT image model to use for image generation. Specify a model explicitly.
+        # Supported models include `gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
+        # `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`,
-        # `gpt-image-2.5-flare-2026-09-08`). Defaults to `dall-e-2` unless a parameter
-        # specific to the GPT image models is used.
+        # `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`.
         model: nil,
         # Control the content-moderation level for images generated by the GPT image
         # models. Must be either `low` for less restrictive filtering or `auto` (default
         # value).
         moderation: nil,
-        # The number of images to generate. Must be between 1 and 10. For `dall-e-3`, only
-        # `n=1` is supported.
+        # The number of images to generate. Must be between 1 and 10.
         n: nil,
         # The compression level (0-100%) for the generated images. This parameter is only
         # supported for the GPT image models with the `webp` or `jpeg` output formats, and
@@ -484,12 +458,8 @@ module OpenAI
         # - `high`, `medium` and `low` are supported for the GPT image models.
         # - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
         #   `2026-09-08` snapshots, also support `xhigh` and `max`.
-        # - `hd` and `standard` are supported for `dall-e-3`.
-        # - `standard` is the only option for `dall-e-2`.
         quality: nil,
-        # The format in which generated images with `dall-e-2` and `dall-e-3` are
-        # returned. Must be one of `url` or `b64_json`. URLs are only valid for 60 minutes
-        # after the image has been generated. This parameter isn't supported for the GPT
+        # Legacy response format parameter for retired image models. Unsupported for GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
         # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
@@ -501,14 +471,10 @@ module OpenAI
         # the maximum supported resolution is `3840x2160`. The requested size must also
         # satisfy the model's current pixel and edge limits. The standard sizes
         # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-        # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-        # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-        # `1024x1024`, `1792x1024`, or `1024x1792`.
+        # `auto` is supported for models that allow automatic sizing.
         size: nil,
-        # The style of the generated images. This parameter is only supported for
-        # `dall-e-3`. Must be one of `vivid` or `natural`. Vivid causes the model to lean
-        # towards generating hyper-real and dramatic images. Natural causes the model to
-        # produce more natural, less hyper-real looking images.
+        # 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.

data/rbi/openai/resources/webhooks.rbi

@@ -140,6 +140,11 @@ module OpenAI
         )
           .returns(
             T.any(
+              OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent,
+              OpenAI::Webhooks::AgentSessionCreatedWebhookEvent,
+              OpenAI::Webhooks::AgentSessionFailedWebhookEvent,
+              OpenAI::Webhooks::AgentSessionIdleWebhookEvent,
+              OpenAI::Webhooks::AgentSessionInProgressWebhookEvent,
               OpenAI::Webhooks::BatchCancelledWebhookEvent,
               OpenAI::Webhooks::BatchCompletedWebhookEvent,
               OpenAI::Webhooks::BatchExpiredWebhookEvent,

data/sig/openai/models/admin/organization/usage_audio_speeches_response.rbs

@@ -89,6 +89,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?:input_cache_write_12h_tokens => Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,
@@ -136,10 +137,20 @@ module OpenAI
                 # The aggregated number of uncached audio input tokens used.
                 def input_audio_tokens=: (Integer) -> Integer
 
-                # The aggregated number of input tokens written to the cache.
+                # The aggregated number of input tokens written to the cache with a 12-hour
+                # retention period.
+                attr_reader input_cache_write_12h_tokens: Integer?
+
+                # The aggregated number of input tokens written to the cache with a 12-hour
+                # retention period.
+                def input_cache_write_12h_tokens=: (Integer) -> Integer
+
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period.
                 attr_reader 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.
                 def input_cache_write_tokens=: (Integer) -> Integer
 
                 # The aggregated number of cached audio input tokens used.
@@ -242,8 +253,12 @@ module OpenAI
                 #   batch or not.
                 # @param input_audio_tokens
                 #   The aggregated number of uncached audio input tokens used.
+                # @param input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
                 # @param 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.
                 # @param input_cached_audio_tokens
                 #   The aggregated number of cached audio input tokens used.
                 # @param input_cached_image_tokens
@@ -286,6 +301,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?input_cache_write_12h_tokens: Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,
@@ -312,6 +328,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?:input_cache_write_12h_tokens => Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,

data/sig/openai/models/admin/organization/usage_audio_transcriptions_response.rbs

@@ -89,6 +89,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?:input_cache_write_12h_tokens => Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,
@@ -136,10 +137,20 @@ module OpenAI
                 # The aggregated number of uncached audio input tokens used.
                 def input_audio_tokens=: (Integer) -> Integer
 
-                # The aggregated number of input tokens written to the cache.
+                # The aggregated number of input tokens written to the cache with a 12-hour
+                # retention period.
+                attr_reader input_cache_write_12h_tokens: Integer?
+
+                # The aggregated number of input tokens written to the cache with a 12-hour
+                # retention period.
+                def input_cache_write_12h_tokens=: (Integer) -> Integer
+
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period.
                 attr_reader 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.
                 def input_cache_write_tokens=: (Integer) -> Integer
 
                 # The aggregated number of cached audio input tokens used.
@@ -242,8 +253,12 @@ module OpenAI
                 #   batch or not.
                 # @param input_audio_tokens
                 #   The aggregated number of uncached audio input tokens used.
+                # @param input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
                 # @param 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.
                 # @param input_cached_audio_tokens
                 #   The aggregated number of cached audio input tokens used.
                 # @param input_cached_image_tokens
@@ -286,6 +301,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?input_cache_write_12h_tokens: Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,
@@ -312,6 +328,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?:input_cache_write_12h_tokens => Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,

data/sig/openai/models/admin/organization/usage_code_interpreter_sessions_response.rbs

@@ -89,6 +89,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?:input_cache_write_12h_tokens => Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,
@@ -136,10 +137,20 @@ module OpenAI
                 # The aggregated number of uncached audio input tokens used.
                 def input_audio_tokens=: (Integer) -> Integer
 
-                # The aggregated number of input tokens written to the cache.
+                # The aggregated number of input tokens written to the cache with a 12-hour
+                # retention period.
+                attr_reader input_cache_write_12h_tokens: Integer?
+
+                # The aggregated number of input tokens written to the cache with a 12-hour
+                # retention period.
+                def input_cache_write_12h_tokens=: (Integer) -> Integer
+
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period.
                 attr_reader 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.
                 def input_cache_write_tokens=: (Integer) -> Integer
 
                 # The aggregated number of cached audio input tokens used.
@@ -242,8 +253,12 @@ module OpenAI
                 #   batch or not.
                 # @param input_audio_tokens
                 #   The aggregated number of uncached audio input tokens used.
+                # @param input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
                 # @param 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.
                 # @param input_cached_audio_tokens
                 #   The aggregated number of cached audio input tokens used.
                 # @param input_cached_image_tokens
@@ -286,6 +301,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?input_cache_write_12h_tokens: Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,
@@ -312,6 +328,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?:input_cache_write_12h_tokens => Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,

data/sig/openai/models/admin/organization/usage_completions_response.rbs

@@ -89,6 +89,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?:input_cache_write_12h_tokens => Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,
@@ -136,10 +137,20 @@ module OpenAI
                 # The aggregated number of uncached audio input tokens used.
                 def input_audio_tokens=: (Integer) -> Integer
 
-                # The aggregated number of input tokens written to the cache.
+                # The aggregated number of input tokens written to the cache with a 12-hour
+                # retention period.
+                attr_reader input_cache_write_12h_tokens: Integer?
+
+                # The aggregated number of input tokens written to the cache with a 12-hour
+                # retention period.
+                def input_cache_write_12h_tokens=: (Integer) -> Integer
+
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period.
                 attr_reader 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.
                 def input_cache_write_tokens=: (Integer) -> Integer
 
                 # The aggregated number of cached audio input tokens used.
@@ -242,8 +253,12 @@ module OpenAI
                 #   batch or not.
                 # @param input_audio_tokens
                 #   The aggregated number of uncached audio input tokens used.
+                # @param input_cache_write_12h_tokens
+                #   The aggregated number of input tokens written to the cache with a 12-hour
+                #   retention period.
                 # @param 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.
                 # @param input_cached_audio_tokens
                 #   The aggregated number of cached audio input tokens used.
                 # @param input_cached_image_tokens
@@ -286,6 +301,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?input_cache_write_12h_tokens: Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,
@@ -312,6 +328,7 @@ module OpenAI
                   ?api_key_id: String?,
                   ?batch: bool?,
                   ?input_audio_tokens: Integer,
+                  ?:input_cache_write_12h_tokens => Integer,
                   ?input_cache_write_tokens: Integer,
                   ?input_cached_audio_tokens: Integer,
                   ?input_cached_image_tokens: Integer,