openai 0.85.0 → 0.87.0

data/rbi/openai/models/responses/tool.rbi

@@ -954,9 +954,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`.
           sig { returns(T.nilable(OpenAI::Responses::Tool::ImageGeneration::Background::OrSymbol)) }
           attr_reader :background
 
@@ -979,7 +981,9 @@ module OpenAI
           attr_writer :input_image_mask
 
           # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+          # `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`. Default: `gpt-image-1`.
           sig { returns(T.nilable(T.any(String, OpenAI::Responses::Tool::ImageGeneration::Model::OrSymbol))) }
           attr_reader :model
@@ -1017,25 +1021,28 @@ module OpenAI
           sig { params(partial_images: Integer).void }
           attr_writer :partial_images
 
-          # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-          # Default: `auto`.
+          # The quality of the generated image. 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`. Default:
+          # `auto`.
           sig { returns(T.nilable(OpenAI::Responses::Tool::ImageGeneration::Quality::OrSymbol)) }
           attr_reader :quality
 
           sig { params(quality: OpenAI::Responses::Tool::ImageGeneration::Quality::OrSymbol).void }
           attr_writer :quality
 
-          # 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`.
           sig { returns(T.nilable(T.any(String, OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol))) }
           attr_reader :size
 
@@ -1081,9 +1088,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,
@@ -1097,7 +1106,9 @@ module OpenAI
             input_image_mask: nil,
 
             # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-            # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+            # `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`. Default: `gpt-image-1`.
             model: nil,
 
@@ -1115,21 +1126,24 @@ module OpenAI
             # to 3.
             partial_images: nil,
 
-            # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-            # Default: `auto`.
+            # The quality of the generated image. 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`. Default:
+            # `auto`.
             quality: 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 type of the image generation tool. Always `image_generation`.
@@ -1179,9 +1193,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`.
           module Background
             extend OpenAI::Internal::Type::Enum
 
@@ -1270,7 +1286,9 @@ module OpenAI
           end
 
           # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+          # `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`. Default: `gpt-image-1`.
           module Model
             extend OpenAI::Internal::Type::Union
@@ -1294,6 +1312,22 @@ module OpenAI
               :"gpt-image-2-2026-04-21",
               OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
             )
+            GPT_IMAGE_2_5_SUNBURST = T.let(
+              :"gpt-image-2.5-sunburst",
+              OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+            )
+            GPT_IMAGE_2_5_SUNBURST_2026_09_08 = T.let(
+              :"gpt-image-2.5-sunburst-2026-09-08",
+              OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+            )
+            GPT_IMAGE_2_5_FLARE = T.let(
+              :"gpt-image-2.5-flare",
+              OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+            )
+            GPT_IMAGE_2_5_FLARE_2026_09_08 = T.let(
+              :"gpt-image-2.5-flare-2026-09-08",
+              OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+            )
             GPT_IMAGE_1_5 = T.let(:"gpt-image-1.5", OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol)
             CHATGPT_IMAGE_LATEST = T.let(
               :"chatgpt-image-latest",
@@ -1334,8 +1368,10 @@ module OpenAI
             end
           end
 
-          # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-          # Default: `auto`.
+          # The quality of the generated image. 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`. Default:
+          # `auto`.
           module Quality
             extend OpenAI::Internal::Type::Enum
 
@@ -1345,6 +1381,8 @@ module OpenAI
             LOW = T.let(:low, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
             MEDIUM = T.let(:medium, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
             HIGH = T.let(:high, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
+            XHIGH = T.let(:xhigh, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
+            MAX = T.let(:max, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
             AUTO = T.let(:auto, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
 
             sig { override.returns(T::Array[OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol]) }
@@ -1352,17 +1390,18 @@ module OpenAI
             end
           end
 
-          # 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`.
           module Size
             extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/webhooks/live_call_incoming_webhook_event.rbi

@@ -100,8 +100,8 @@ module OpenAI
             )
           end
 
-          # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-          # as `call_id` in `realtime.call.incoming`.
+          # The `live_...` ID of the pending SIP session. Forward this value unchanged when
+          # accepting or rejecting the call through the Live API.
           sig { returns(String) }
           attr_accessor :session_id
 
@@ -121,8 +121,8 @@ module OpenAI
           end
           def self.new(
 
-            # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-            # as `call_id` in `realtime.call.incoming`.
+            # The `live_...` ID of the pending SIP session. Forward this value unchanged when
+            # accepting or rejecting the call through the Live API.
             session_id:,
 
             # Headers from the SIP Invite.

data/rbi/openai/models/webhooks/realtime_call_incoming_webhook_event.rbi

@@ -100,8 +100,10 @@ module OpenAI
             )
           end
 
-          # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-          # as `session_id` in `live.call.incoming`.
+          # The Transceiver `rtc_...` ID of the pending SIP session. The paired
+          # `live.call.incoming` event derives its `session_id` by replacing the `rtc_`
+          # prefix with `live_`. Use the ID returned by the event with the corresponding
+          # Realtime or Live API.
           sig { returns(String) }
           attr_accessor :call_id
 
@@ -121,8 +123,10 @@ module OpenAI
           end
           def self.new(
 
-            # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-            # as `session_id` in `live.call.incoming`.
+            # The Transceiver `rtc_...` ID of the pending SIP session. The paired
+            # `live.call.incoming` event derives its `session_id` by replacing the `rtc_`
+            # prefix with `live_`. Use the ID returned by the event with the corresponding
+            # Realtime or Live API.
             call_id:,
 
             # Headers from the SIP Invite.

data/rbi/openai/resources/admin/organization/projects/service_accounts/api_keys.rbi

@@ -18,6 +18,7 @@ module OpenAI
                 params(
                   service_account_id: String,
                   project_id: String,
+                  expires_in_seconds: T.nilable(Integer),
                   name: String,
                   scopes: T::Array[String],
                   request_options: OpenAI::RequestOptions::OrHash
@@ -29,6 +30,8 @@ module OpenAI
                 service_account_id,
                 # Path param: The ID of the project.
                 project_id:,
+                # Body param: Number of seconds until the API key expires.
+                expires_in_seconds: nil,
                 # Body param: API key name.
                 name: nil,
                 # Body param: API key scopes.

data/rbi/openai/resources/audio/speech.rbi

@@ -26,7 +26,7 @@ module OpenAI
             stream_format: OpenAI::Audio::SpeechCreateParams::StreamFormat::OrSymbol,
             request_options: OpenAI::RequestOptions::OrHash
           )
-            .returns(StringIO)
+            .returns(T.all(StringIO, OpenAI::ResponseCarrier))
         }
         def create(
           # The text to generate audio for. The maximum length is 4096 characters.

data/rbi/openai/resources/beta/responses.rbi

@@ -247,7 +247,9 @@ module OpenAI
           # parameter.
           service_tier: nil,
           # Body param: Whether to store the generated model response for later retrieval
-          # via API.
+          # 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,
           # Body param: Options for streaming responses. Only set this when you set
           # `stream: true`.
@@ -561,7 +563,9 @@ module OpenAI
           # parameter.
           service_tier: nil,
           # Body param: Whether to store the generated model response for later retrieval
-          # via API.
+          # 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,
           # Body param: Options for streaming responses. Only set this when you set
           # `stream: true`.
@@ -825,12 +829,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,
           # Header param: Optional beta features to enable for this request.
           betas: nil,

data/rbi/openai/resources/containers/files/content.rbi

@@ -12,7 +12,7 @@ module OpenAI
           # Retrieve Container File Content
           sig {
             params(file_id: String, container_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
-              StringIO
+              T.all(StringIO, OpenAI::ResponseCarrier)
             )
           }
           def retrieve(file_id, container_id:, request_options: {})

data/rbi/openai/resources/files.rbi

@@ -114,7 +114,11 @@ module OpenAI
       end
 
       # Returns a response containing the contents of the specified file.
-      sig { params(file_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(StringIO) }
+      sig {
+        params(file_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+          T.all(StringIO, OpenAI::ResponseCarrier)
+        )
+      }
       def content(
         # The ID of the file to use for this request.
         file_id,