openai 0.85.0 → 0.87.0

data/rbi/openai/resources/images.rbi

@@ -50,8 +50,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 (`gpt-image-1.5`, `gpt-image-1`,
-      # `gpt-image-1-mini`, and `chatgpt-image-latest`) and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models and `dall-e-2`.
       sig {
         params(
           image: OpenAI::ImageEditParams::Image::Variants,
@@ -77,9 +76,11 @@ module OpenAI
         # The image(s) to edit. Must be a supported image file or an array of images.
         #
         # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-        # `gpt-image-2`, `gpt-image-2-2026-04-21`, and `chatgpt-image-latest`), each image
-        # should be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to
-        # 16 images.
+        # `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`, and `chatgpt-image-latest`), each image should
+        # 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.
@@ -95,9 +96,11 @@ module OpenAI
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
         # the model will automatically determine the best background for the image.
         #
-        # Transparent backgrounds are available for supported GPT Image models. For
-        # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-        # using `transparent`, set the output format to `png` or `webp`.
+        # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+        # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+        # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+        # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+        # set the output format to `png` or `webp`.
         background: nil,
         # Control how much effort the model will exert to match the style and features,
         # especially facial features, of input images. This parameter is only supported
@@ -115,7 +118,9 @@ module OpenAI
         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`, or `chatgpt-image-latest`). Defaults to
+        # `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`.
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
@@ -135,25 +140,28 @@ module OpenAI
         # Note that the final image may be sent before the full number of partial images
         # are generated if the full image is generated more quickly.
         partial_images: nil,
-        # The quality of the image that will be generated for GPT image models. Defaults
-        # to `auto`.
+        # The quality of the image that will be generated for GPT image models. The GPT
+        # image models support `low`, `medium`, and `high`. `gpt-image-2.5-sunburst` and
+        # `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.
         response_format: nil,
-        # The size of the generated images. For `gpt-image-2` and
-        # `gpt-image-2-2026-04-21`, 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. 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`.
         size: nil,
         # A unique identifier representing your end-user, which can help OpenAI to monitor
         # and detect abuse.
@@ -169,8 +177,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 (`gpt-image-1.5`, `gpt-image-1`,
-      # `gpt-image-1-mini`, and `chatgpt-image-latest`) and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models and `dall-e-2`.
       sig {
         params(
           image: OpenAI::ImageEditParams::Image::Variants,
@@ -196,9 +203,11 @@ module OpenAI
         # The image(s) to edit. Must be a supported image file or an array of images.
         #
         # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-        # `gpt-image-2`, `gpt-image-2-2026-04-21`, and `chatgpt-image-latest`), each image
-        # should be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to
-        # 16 images.
+        # `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`, and `chatgpt-image-latest`), each image should
+        # 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.
@@ -214,9 +223,11 @@ module OpenAI
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
         # the model will automatically determine the best background for the image.
         #
-        # Transparent backgrounds are available for supported GPT Image models. For
-        # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-        # using `transparent`, set the output format to `png` or `webp`.
+        # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+        # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+        # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+        # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+        # set the output format to `png` or `webp`.
         background: nil,
         # Control how much effort the model will exert to match the style and features,
         # especially facial features, of input images. This parameter is only supported
@@ -234,7 +245,9 @@ module OpenAI
         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`, or `chatgpt-image-latest`). Defaults to
+        # `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`.
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
@@ -254,25 +267,28 @@ module OpenAI
         # Note that the final image may be sent before the full number of partial images
         # are generated if the full image is generated more quickly.
         partial_images: nil,
-        # The quality of the image that will be generated for GPT image models. Defaults
-        # to `auto`.
+        # The quality of the image that will be generated for GPT image models. The GPT
+        # image models support `low`, `medium`, and `high`. `gpt-image-2.5-sunburst` and
+        # `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.
         response_format: nil,
-        # The size of the generated images. For `gpt-image-2` and
-        # `gpt-image-2-2026-04-21`, 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. 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`.
         size: nil,
         # A unique identifier representing your end-user, which can help OpenAI to monitor
         # and detect abuse.
@@ -318,14 +334,18 @@ module OpenAI
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
         # the model will automatically determine the best background for the image.
         #
-        # Transparent backgrounds are available for supported GPT Image models. For
-        # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-        # using `transparent`, set the output format to `png` or `webp`.
+        # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+        # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+        # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+        # `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`,
-        # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
-        # to the GPT image models is used.
+        # `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.
         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
@@ -353,6 +373,8 @@ module OpenAI
         # - `auto` (default value) will automatically select the best quality for the
         #   given model.
         # - `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,
@@ -361,17 +383,18 @@ module OpenAI
         # after the image has been generated. This parameter isn't supported for the GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
-        # The size of the generated images. For `gpt-image-2` and
-        # `gpt-image-2-2026-04-21`, 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. 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`.
         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
@@ -422,14 +445,18 @@ module OpenAI
         # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
         # the model will automatically determine the best background for the image.
         #
-        # Transparent backgrounds are available for supported GPT Image models. For
-        # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-        # using `transparent`, set the output format to `png` or `webp`.
+        # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+        # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+        # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+        # `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`,
-        # or `gpt-image-2-2026-04-21`). Defaults to `dall-e-2` unless a parameter specific
-        # to the GPT image models is used.
+        # `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.
         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
@@ -457,6 +484,8 @@ module OpenAI
         # - `auto` (default value) will automatically select the best quality for the
         #   given model.
         # - `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,
@@ -465,17 +494,18 @@ module OpenAI
         # after the image has been generated. This parameter isn't supported for the GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
-        # The size of the generated images. For `gpt-image-2` and
-        # `gpt-image-2-2026-04-21`, 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. 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`.
         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

data/rbi/openai/resources/responses.rbi

@@ -241,6 +241,9 @@ module OpenAI
         # parameter.
         service_tier: nil,
         # Whether to store the generated model response for later retrieval via API.
+        # Defaults to true when omitted. If set to true, response data will be stored for
+        # at least 30 days, subject to the
+        # [data retention exceptions](/api/docs/guides/your-data#v1responses).
         store: nil,
         # Options for streaming responses. Only set this when you set `stream: true`.
         stream_options: nil,
@@ -546,6 +549,9 @@ module OpenAI
         # parameter.
         service_tier: nil,
         # Whether to store the generated model response for later retrieval via API.
+        # Defaults to true when omitted. If set to true, response data will be stored for
+        # at least 30 days, subject to the
+        # [data retention exceptions](/api/docs/guides/your-data#v1responses).
         store: nil,
         # Options for streaming responses. Only set this when you set `stream: true`.
         stream_options: nil,
@@ -651,10 +657,12 @@ module OpenAI
           prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
           prompt_cache_key: String,
           reasoning: T.nilable(OpenAI::Reasoning::OrHash),
+          response_id: T.nilable(String),
           safety_identifier: String,
           service_tier: T.nilable(
             OpenAI::Responses::ResponseCreateParams::ServiceTier::OrSymbol
           ),
+          starting_after: T.nilable(Integer),
           store: T.nilable(T::Boolean),
           temperature: T.nilable(Float),
           text: T.nilable(
@@ -772,6 +780,8 @@ module OpenAI
         # Configuration options for
         # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
         reasoning: nil,
+        # The ID of the response whose stream to resume.
+        response_id: nil,
         # A stable identifier used to help detect users of your application that may be
         # violating OpenAI's usage policies. The IDs should be a string that uniquely
         # identifies each user. We recommend hashing their username or email address, in
@@ -796,6 +806,9 @@ module OpenAI
         # request. This response value may be different from the value set in the
         # parameter.
         service_tier: nil,
+        # The sequence number of the event after which to resume streaming. Can only be
+        # used with `response_id`.
+        starting_after: nil,
         # Whether to store the generated model response for later retrieval via API.
         store: nil,
         # What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
@@ -872,6 +885,20 @@ module OpenAI
           include: T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol],
           include_obfuscation: T::Boolean,
           starting_after: Integer,
+          text: T.nilable(
+            T.any(
+              OpenAI::Responses::ResponseTextConfig::OrHash,
+              OpenAI::StructuredOutput::JsonSchemaConverter::Input
+            )
+          ),
+          tools: T.nilable(
+            T::Array[
+              T.any(
+                OpenAI::Responses::FunctionTool::OrHash,
+                OpenAI::StructuredOutput::JsonSchemaConverter::Input
+              )
+            ]
+          ),
           stream: T.noreturn,
           request_options: OpenAI::RequestOptions::OrHash
         )
@@ -892,6 +919,12 @@ module OpenAI
         include_obfuscation: nil,
         # The sequence number of the event after which to start streaming.
         starting_after: nil,
+        # The structured-output model used to parse retrieved text output. This is a
+        # local parsing hint and is not sent to the API.
+        text: nil,
+        # Structured-output models used to parse retrieved function tool calls. These
+        # are local parsing hints and are not sent to the API.
+        tools: nil,
         # There is no need to provide `stream:`. Instead, use `#retrieve_streaming` or
         # `#retrieve` for streaming and non-streaming use cases, respectively.
         stream: false,
@@ -1027,12 +1060,13 @@ module OpenAI
         # request will be processed with the Flex Processing service tier. - To opt-in to
         # [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
         # `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-        # Completions. The response will show `service_tier=priority` regardless of if you
-        # specify `service_tier=fast` or `priority` in your request. - When not set, the
-        # default behavior is 'auto'. When the `service_tier` parameter is set, the
-        # response body will include the `service_tier` value based on the processing mode
-        # actually used to serve the request. This response value may be different from
-        # the value set in the parameter.
+        # Completions. For models with a dedicated Fast tier, either value resolves to
+        # `service_tier=fast`; for other models, either value resolves to
+        # `service_tier=priority`. - When not set, the default behavior is 'auto'. When
+        # the `service_tier` parameter is set, the response body will include the
+        # `service_tier` value based on the processing mode actually used to serve the
+        # request. This response value may be different from the value set in the
+        # parameter.
         service_tier: nil,
         request_options: {}
       )
@@ -1046,3 +1080,121 @@ module OpenAI
 
   end
 end
+
+module OpenAI
+  module Models
+    module Responses
+      module ConnectionResources
+        class Response
+          sig do
+            params(
+              background: T.nilable(T::Boolean),
+              context_management: T.nilable(
+                T::Array[OpenAI::Responses::ResponsesClientEvent::ResponseCreate::ContextManagement::OrHash]
+              ),
+              conversation: T.nilable(T.any(String, OpenAI::Responses::ResponseConversationParam::OrHash)),
+              include: T.nilable(T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol]),
+              input: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::Input::Variants,
+              instructions: T.nilable(String),
+              max_output_tokens: T.nilable(Integer),
+              max_tool_calls: T.nilable(Integer),
+              metadata: T.nilable(T::Hash[Symbol, String]),
+              model: T.any(String, OpenAI::ChatModel::OrSymbol, OpenAI::ResponsesModel::ResponsesOnlyModel::OrSymbol),
+              moderation: T.nilable(OpenAI::Responses::ResponsesClientEvent::ResponseCreate::Moderation::OrHash),
+              parallel_tool_calls: T.nilable(T::Boolean),
+              previous_response_id: T.nilable(String),
+              prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
+              prompt_cache_key: T.nilable(String),
+              prompt_cache_options: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::OrHash,
+              prompt_cache_retention: T.nilable(
+                OpenAI::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheRetention::OrSymbol
+              ),
+              reasoning: T.nilable(OpenAI::Reasoning::OrHash),
+              safety_identifier: T.nilable(String),
+              service_tier: T.nilable(OpenAI::Responses::ResponsesClientEvent::ResponseCreate::ServiceTier::OrSymbol),
+              store: T.nilable(T::Boolean),
+              stream: T.nilable(T::Boolean),
+              stream_id: String,
+              stream_options: T.nilable(OpenAI::Responses::ResponsesClientEvent::ResponseCreate::StreamOptions::OrHash),
+              temperature: T.nilable(Float),
+              text: OpenAI::Responses::ResponseTextConfig::OrHash,
+              tool_choice: T.any(
+                OpenAI::Responses::ToolChoiceOptions::OrSymbol,
+                OpenAI::Responses::ToolChoiceAllowed::OrHash,
+                OpenAI::Responses::ToolChoiceTypes::OrHash,
+                OpenAI::Responses::ToolChoiceFunction::OrHash,
+                OpenAI::Responses::ToolChoiceMcp::OrHash,
+                OpenAI::Responses::ToolChoiceCustom::OrHash,
+                OpenAI::Responses::ResponsesClientEvent::ResponseCreate::ToolChoice::SpecificProgrammaticToolCallingParam::OrHash,
+                OpenAI::Responses::ToolChoiceApplyPatch::OrHash,
+                OpenAI::Responses::ToolChoiceShell::OrHash
+              ),
+              tools: T::Array[
+                T.any(
+                  OpenAI::Responses::FunctionTool::OrHash,
+                  OpenAI::Responses::FileSearchTool::OrHash,
+                  OpenAI::Responses::ComputerTool::OrHash,
+                  OpenAI::Responses::ComputerUsePreviewTool::OrHash,
+                  OpenAI::Responses::Tool::Mcp::OrHash,
+                  OpenAI::Responses::Tool::CodeInterpreter::OrHash,
+                  OpenAI::Responses::Tool::ProgrammaticToolCalling::OrHash,
+                  OpenAI::Responses::Tool::ImageGeneration::OrHash,
+                  OpenAI::Responses::Tool::LocalShell::OrHash,
+                  OpenAI::Responses::FunctionShellTool::OrHash,
+                  OpenAI::Responses::CustomTool::OrHash,
+                  OpenAI::Responses::NamespaceTool::OrHash,
+                  OpenAI::Responses::ToolSearchTool::OrHash,
+                  OpenAI::Responses::ApplyPatchTool::OrHash,
+                  OpenAI::Responses::WebSearchTool::OrHash,
+                  OpenAI::Responses::WebSearchPreviewTool::OrHash
+                )
+              ],
+              top_logprobs: T.nilable(Integer),
+              top_p: T.nilable(Float),
+              truncation: T.nilable(OpenAI::Responses::ResponsesClientEvent::ResponseCreate::Truncation::OrSymbol),
+              user: String,
+              params: T.anything
+            )
+              .void
+          end
+          def create(
+            background: nil,
+            context_management: nil,
+            conversation: nil,
+            include: nil,
+            input: nil,
+            instructions: nil,
+            max_output_tokens: nil,
+            max_tool_calls: nil,
+            metadata: nil,
+            model: nil,
+            moderation: nil,
+            parallel_tool_calls: nil,
+            previous_response_id: nil,
+            prompt: nil,
+            prompt_cache_key: nil,
+            prompt_cache_options: nil,
+            prompt_cache_retention: nil,
+            reasoning: nil,
+            safety_identifier: nil,
+            service_tier: nil,
+            store: nil,
+            stream: nil,
+            stream_id: nil,
+            stream_options: nil,
+            temperature: nil,
+            text: nil,
+            tool_choice: nil,
+            tools: nil,
+            top_logprobs: nil,
+            top_p: nil,
+            truncation: nil,
+            user: nil,
+            **params
+          )
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/skills/content.rbi

@@ -8,7 +8,11 @@ module OpenAI
       class Content
 
         # Download a skill zip bundle by its ID.
-        sig { params(skill_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(StringIO) }
+        sig {
+          params(skill_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+            T.all(StringIO, OpenAI::ResponseCarrier)
+          )
+        }
         def retrieve(
           # The identifier of the skill to download.
           skill_id,

data/rbi/openai/resources/skills/versions/content.rbi

@@ -11,7 +11,9 @@ module OpenAI
 
           # Download a skill version zip bundle.
           sig {
-            params(version: String, skill_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(StringIO)
+            params(version: String, skill_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+              T.all(StringIO, OpenAI::ResponseCarrier)
+            )
           }
           def retrieve(
             # The skill version number.

data/rbi/openai/resources/videos.rbi

@@ -109,7 +109,7 @@ module OpenAI
           variant: OpenAI::VideoDownloadContentParams::Variant::OrSymbol,
           request_options: OpenAI::RequestOptions::OrHash
         )
-          .returns(StringIO)
+          .returns(T.all(StringIO, OpenAI::ResponseCarrier))
       }
       def download_content(
         # The identifier of the video whose media to download.

data/rbi/openai/response_carrier.rbi

@@ -0,0 +1,25 @@
+# typed: strong
+
+module OpenAI
+  # Shared response metadata interface for SDK values that are not model
+  # objects, such as binary StringIO responses.
+  module ResponseCarrier
+    sig { returns(T.nilable(String)) }
+    def _request_id
+    end
+
+    sig { returns(T.nilable(OpenAI::ResponseMetadata)) }
+    def last_response
+    end
+
+    # @api private
+    sig { params(response: OpenAI::ResponseMetadata).returns(T.self_type) }
+    def _set_last_response(response)
+    end
+
+    # @api private
+    sig { params(coder: T.untyped).void }
+    def encode_with(coder)
+    end
+  end
+end