openai 0.85.0 → 0.86.0

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

@@ -965,6 +965,13 @@ module OpenAI
         end
 
         class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+          # @!attribute comparison_response_id
+          #   The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+          #   this field requests prompt cache diagnostics when the feature is enabled.
+          #
+          #   @return [String, nil]
+          optional :comparison_response_id, String, nil?: true
+
           # @!attribute mode
           #   Controls whether OpenAI automatically creates an implicit cache breakpoint.
           #   Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -984,7 +991,7 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Ttl, nil]
           optional :ttl, enum: -> { OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl }
 
-          # @!method initialize(mode: nil, ttl: nil)
+          # @!method initialize(comparison_response_id: nil, mode: nil, ttl: nil)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions} for more
           #   details.
@@ -999,6 +1006,8 @@ module OpenAI
           #   [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
           #   for current details.
           #
+          #   @param comparison_response_id [String, nil] The ID of a response to compare when diagnosing prompt cache reuse. Supplying th
+          #
           #   @param mode [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Mode] Controls whether OpenAI automatically creates an implicit cache breakpoint. Defa
           #
           #   @param ttl [Symbol, OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions::Ttl] The minimum lifetime applied to every implicit and explicit cache breakpoint wri

data/lib/openai/models/responses/response.rb

@@ -198,6 +198,12 @@ module OpenAI
         #   @return [OpenAI::Models::Responses::ResponsePrompt, nil]
         optional :prompt, -> { OpenAI::Responses::ResponsePrompt }, nil?: true
 
+        # @!attribute prompt_cache_diagnostics
+        #   Prompt cache diagnostics requested for this response.
+        #
+        #   @return [OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheHit, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::ComparisonResponseNotFound, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::Unavailable, nil]
+        optional :prompt_cache_diagnostics, union: -> { OpenAI::Responses::Response::PromptCacheDiagnostics }
+
         # @!attribute prompt_cache_key
         #   Used by OpenAI to cache responses for similar requests to optimize your cache
         #   hit rates. Replaces the `user` field.
@@ -353,18 +359,19 @@ module OpenAI
           texts = []
 
           output.each do |item|
-            next unless item.type == :message
+            next unless item.is_a?(OpenAI::Models::Responses::ResponseOutputMessage)
+
             item.content.each do |content|
-              if content.type == :output_text
-                texts << content.text
-              end
+              next unless content.is_a?(OpenAI::Models::Responses::ResponseOutputText)
+
+              texts << content.text
             end
           end
 
           texts.join
         end
 
-        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, completed_at: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, moderation: 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, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
+        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, completed_at: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, moderation: nil, previous_response_id: nil, prompt: nil, prompt_cache_diagnostics: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::Response} for more details.
         #
@@ -410,6 +417,8 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
         #
+        #   @param prompt_cache_diagnostics [OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheHit, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::ComparisonResponseNotFound, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::Unavailable] Prompt cache diagnostics requested for this response.
+        #
         #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Responses::Response::PromptCacheOptions] The prompt-caching options that were applied to the response. Supported for `gpt
@@ -842,6 +851,118 @@ module OpenAI
           end
         end
 
+        # Prompt cache diagnostics requested for this response.
+        #
+        # @see OpenAI::Models::Responses::Response#prompt_cache_diagnostics
+        module PromptCacheDiagnostics
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          variant :cache_miss, -> { OpenAI::Responses::Response::PromptCacheDiagnostics::CacheMiss }
+
+          variant :cache_hit, -> { OpenAI::Responses::Response::PromptCacheDiagnostics::CacheHit }
+
+          variant(
+            :comparison_response_not_found,
+            -> { OpenAI::Responses::Response::PromptCacheDiagnostics::ComparisonResponseNotFound }
+          )
+
+          variant :unavailable, -> { OpenAI::Responses::Response::PromptCacheDiagnostics::Unavailable }
+
+          class CacheMiss < OpenAI::Internal::Type::BaseModel
+            # @!attribute cache_missed_tokens
+            #   The estimated number of input tokens affected after the first detected
+            #   divergence.
+            #
+            #   @return [Integer]
+            required :cache_missed_tokens, Integer
+
+            # @!attribute reason
+            #   The reason prompt cache reuse did not occur.
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss::Reason]
+            required :reason, enum: -> { OpenAI::Responses::Response::PromptCacheDiagnostics::CacheMiss::Reason }
+
+            # @!attribute type
+            #
+            #   @return [Symbol, :cache_miss]
+            required :type, const: :cache_miss
+
+            # @!attribute comparison_reusable_tokens
+            #   The raw token count of the reusable prefix in the compared response.
+            #
+            #   @return [Integer, nil]
+            optional :comparison_reusable_tokens, Integer
+
+            # @!method initialize(cache_missed_tokens:, reason:, comparison_reusable_tokens: nil, type: :cache_miss)
+            #   Some parameter documentations has been truncated, see
+            #   {OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss} for
+            #   more details.
+            #
+            #   @param cache_missed_tokens [Integer] The estimated number of input tokens affected after the first detected divergenc
+            #
+            #   @param reason [Symbol, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss::Reason] The reason prompt cache reuse did not occur.
+            #
+            #   @param comparison_reusable_tokens [Integer] The raw token count of the reusable prefix in the compared response.
+            #
+            #   @param type [Symbol, :cache_miss]
+
+            # The reason prompt cache reuse did not occur.
+            #
+            # @see OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss#reason
+            module Reason
+              extend OpenAI::Internal::Type::Enum
+
+              MODEL_CHANGED = :model_changed
+              PROMPT_CACHE_KEY_CHANGED = :prompt_cache_key_changed
+              TOOLS_CHANGED = :tools_changed
+              TEXT_FORMAT_CHANGED = :text_format_changed
+              REASONING_EFFORT_CHANGED = :reasoning_effort_changed
+              VERBOSITY_CHANGED = :verbosity_changed
+              CONTEXT_COMPACTED = :context_compacted
+              INPUT_CHANGED = :input_changed
+              SERVICE_TIER_CHANGED = :service_tier_changed
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          class CacheHit < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :cache_hit]
+            required :type, const: :cache_hit
+
+            # @!method initialize(type: :cache_hit)
+            #   @param type [Symbol, :cache_hit]
+          end
+
+          class ComparisonResponseNotFound < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :comparison_response_not_found]
+            required :type, const: :comparison_response_not_found
+
+            # @!method initialize(type: :comparison_response_not_found)
+            #   @param type [Symbol, :comparison_response_not_found]
+          end
+
+          class Unavailable < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :unavailable]
+            required :type, const: :unavailable
+
+            # @!method initialize(type: :unavailable)
+            #   @param type [Symbol, :unavailable]
+          end
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheMiss, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::CacheHit, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::ComparisonResponseNotFound, OpenAI::Models::Responses::Response::PromptCacheDiagnostics::Unavailable)]
+        end
+
         # @see OpenAI::Models::Responses::Response#prompt_cache_options
         class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
           # @!attribute mode
@@ -856,13 +977,21 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Responses::Response::PromptCacheOptions::Ttl]
           required :ttl, enum: -> { OpenAI::Responses::Response::PromptCacheOptions::Ttl }
 
-          # @!method initialize(mode:, ttl:)
+          # @!attribute comparison_response_id
+          #   The response ID supplied as the prompt cache diagnostics comparison.
+          #
+          #   @return [String, nil]
+          optional :comparison_response_id, String, nil?: true
+
+          # @!method initialize(mode:, ttl:, comparison_response_id: nil)
           #   The prompt-caching options that were applied to the response. Supported for
           #   `gpt-5.6` and later models.
           #
           #   @param mode [Symbol, OpenAI::Models::Responses::Response::PromptCacheOptions::Mode] Whether implicit prompt-cache breakpoints were enabled.
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::Response::PromptCacheOptions::Ttl] The minimum lifetime applied to each cache breakpoint.
+          #
+          #   @param comparison_response_id [String, nil] The response ID supplied as the prompt cache diagnostics comparison.
 
           # Whether implicit prompt-cache breakpoints were enabled.
           #

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

@@ -88,12 +88,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.
         #
         #   @return [Symbol, OpenAI::Models::Responses::ResponseCompactParams::ServiceTier, nil]
         optional :service_tier, enum: -> { OpenAI::Responses::ResponseCompactParams::ServiceTier }, nil?: true
@@ -581,12 +582,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.
         module ServiceTier
           extend OpenAI::Internal::Type::Enum
 

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

@@ -607,6 +607,13 @@ module OpenAI
         end
 
         class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+          # @!attribute comparison_response_id
+          #   The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+          #   this field requests prompt cache diagnostics when the feature is enabled.
+          #
+          #   @return [String, nil]
+          optional :comparison_response_id, String, nil?: true
+
           # @!attribute mode
           #   Controls whether OpenAI automatically creates an implicit cache breakpoint.
           #   Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -626,7 +633,7 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Ttl, nil]
           optional :ttl, enum: -> { OpenAI::Responses::ResponseCreateParams::PromptCacheOptions::Ttl }
 
-          # @!method initialize(mode: nil, ttl: nil)
+          # @!method initialize(comparison_response_id: nil, mode: nil, ttl: nil)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions} for more
           #   details.
@@ -641,6 +648,8 @@ module OpenAI
           #   [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
           #   for current details.
           #
+          #   @param comparison_response_id [String, nil] The ID of a response to compare when diagnosing prompt cache reuse. Supplying th
+          #
           #   @param mode [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Mode] Controls whether OpenAI automatically creates an implicit cache breakpoint. Defa
           #
           #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions::Ttl] The minimum lifetime applied to every implicit and explicit cache breakpoint wri

data/lib/openai/models/responses/response_function_call_arguments_done_event.rb

@@ -16,12 +16,6 @@ module OpenAI
         #   @return [String]
         required :item_id, String
 
-        # @!attribute name
-        #   The name of the function that was called.
-        #
-        #   @return [String]
-        required :name, String
-
         # @!attribute output_index
         #   The index of the output item.
         #
@@ -39,15 +33,13 @@ module OpenAI
         #   @return [Symbol, :"response.function_call_arguments.done"]
         required :type, const: :"response.function_call_arguments.done"
 
-        # @!method initialize(arguments:, item_id:, name:, output_index:, sequence_number:, type: :"response.function_call_arguments.done")
+        # @!method initialize(arguments:, item_id:, output_index:, sequence_number:, type: :"response.function_call_arguments.done")
         #   Emitted when function-call arguments are finalized.
         #
         #   @param arguments [String] The function-call arguments.
         #
         #   @param item_id [String] The ID of the item.
         #
-        #   @param name [String] The name of the function that was called.
-        #
         #   @param output_index [Integer] The index of the output item.
         #
         #   @param sequence_number [Integer] The sequence number of this event.

data/lib/openai/models/responses/response_function_web_search.rb

@@ -208,6 +208,7 @@ module OpenAI
           SEARCHING = :searching
           COMPLETED = :completed
           FAILED = :failed
+          INCOMPLETE = :incomplete
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/openai/models/responses/responses_client_event.rb

@@ -719,6 +719,13 @@ module OpenAI
 
           # @see OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate#prompt_cache_options
           class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+            # @!attribute comparison_response_id
+            #   The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+            #   this field requests prompt cache diagnostics when the feature is enabled.
+            #
+            #   @return [String, nil]
+            optional :comparison_response_id, String, nil?: true
+
             # @!attribute mode
             #   Controls whether OpenAI automatically creates an implicit cache breakpoint.
             #   Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -744,7 +751,7 @@ module OpenAI
               enum: -> { OpenAI::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl }
             )
 
-            # @!method initialize(mode: nil, ttl: nil)
+            # @!method initialize(comparison_response_id: nil, mode: nil, ttl: nil)
             #   Some parameter documentations has been truncated, see
             #   {OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions}
             #   for more details.
@@ -759,6 +766,8 @@ module OpenAI
             #   [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
             #   for current details.
             #
+            #   @param comparison_response_id [String, nil] The ID of a response to compare when diagnosing prompt cache reuse. Supplying th
+            #
             #   @param mode [Symbol, OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode] Controls whether OpenAI automatically creates an implicit cache breakpoint. Defa
             #
             #   @param ttl [Symbol, OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl] The minimum lifetime applied to every implicit and explicit cache breakpoint wri

data/lib/openai/models/responses/responses_server_event.rb

@@ -810,7 +810,7 @@ module OpenAI
           #   @return [String, nil]
           optional :stream_id, String
 
-          # @!method initialize(arguments:, item_id:, name:, output_index:, sequence_number:, stream_id: nil, type: :"response.function_call_arguments.done")
+          # @!method initialize(arguments:, item_id:, output_index:, sequence_number:, stream_id: nil, type: :"response.function_call_arguments.done")
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::ResponsesServerEvent::ResponseFunctionCallArgumentsWsDone}
           #   for more details.
@@ -821,8 +821,6 @@ module OpenAI
           #
           #   @param item_id [String] The ID of the item.
           #
-          #   @param name [String] The name of the function that was called.
-          #
           #   @param output_index [Integer] The index of the output item.
           #
           #   @param sequence_number [Integer] The sequence number of this event.

data/lib/openai/net_http_client.rb

@@ -244,6 +244,7 @@ module OpenAI
 
       req = nil
       finished = false
+      request_may_have_been_sent = false
 
       # rubocop:disable Metrics/BlockLength
       enum = Enumerator.new do |y|
@@ -285,6 +286,7 @@ module OpenAI
 
               calibrate_socket_timeout(conn, deadline)
               ::Kernel.catch(:jump) do
+                request_may_have_been_sent = true
                 conn.request(req) do |rsp|
                   y << [req, rsp]
                   ::Kernel.throw(:jump) if finished
@@ -313,9 +315,21 @@ module OpenAI
       rescue ConnectionConfigurationError => e
         raise e.original, cause: e.original.cause
       rescue Timeout::Error
-        raise OpenAI::Errors::APITimeoutError.new(url: url, request: req)
+        raise(
+          OpenAI::Errors::APITimeoutError.new(
+            url: url,
+            request: req,
+            request_may_have_been_sent: request_may_have_been_sent
+          )
+        )
       rescue *NETWORK_ERRORS
-        raise OpenAI::Errors::APIConnectionError.new(url: url, request: req)
+        raise(
+          OpenAI::Errors::APIConnectionError.new(
+            url: url,
+            request: req,
+            request_may_have_been_sent: request_may_have_been_sent
+          )
+        )
       end
       # rubocop:enable Metrics/BlockLength
 

data/lib/openai/providers/bedrock.rb

@@ -602,8 +602,9 @@ module OpenAI
           token_provider
         elsif environment_bearer
           lambda do
-            ENV["AWS_BEARER_TOKEN_BEDROCK"] ||
+            token = ENV["AWS_BEARER_TOKEN_BEDROCK"] ||
               raise(OpenAI::Errors::Error, Bedrock::MISSING_CREDENTIALS_MESSAGE)
+            Bedrock.normalize_optional_string(token) || token
           end
         end
 

data/lib/openai/request_options.rb

@@ -7,6 +7,16 @@ module OpenAI
   # When making a request, you can pass an actual {RequestOptions} instance, or
   # simply pass a Hash with symbol keys matching the attributes on this class.
   class RequestOptions < OpenAI::Internal::Type::BaseModel
+    # @api private
+    module ExtraQueryValue
+      extend OpenAI::Internal::Type::Union
+
+      variant String
+      variant OpenAI::Internal::Type::ArrayOf[String]
+    end
+
+    private_constant :ExtraQueryValue
+
     # @api private
     #
     # @param opts [OpenAI::RequestOptions, Hash{Symbol=>Object}]
@@ -37,7 +47,10 @@ module OpenAI
     #   `query` given at the client level.
     #
     #   @return [Hash{String=>Array<String>, String, nil}, nil]
-    optional :extra_query, OpenAI::Internal::Type::HashOf[OpenAI::Internal::Type::ArrayOf[String]]
+    optional(
+      :extra_query,
+      OpenAI::Internal::Type::HashOf[{union: ExtraQueryValue}, nil?: true]
+    )
 
     # @!attribute extra_headers
     #   Extra headers to send with the request. These are `.merged`’d into any
@@ -66,9 +79,10 @@ module OpenAI
     optional :timeout, Float
 
     # @!attribute include_raw_body
-    #   Retain the exact successful HTTP response body on the returned model or
-    #   page through `last_response.body`. Body retention is disabled by default
-    #   and cannot be enabled for streaming responses.
+    #   Retain the exact successful HTTP response body on the returned model,
+    #   page, or direct binary StringIO response through `last_response.body`.
+    #   Body retention is disabled by default and cannot be enabled for
+    #   streaming responses.
     #
     #   @return [Boolean, nil]
     optional :include_raw_body, OpenAI::Internal::Type::Boolean

data/lib/openai/resources/admin/organization/projects/service_accounts/api_keys.rb

@@ -9,12 +9,14 @@ module OpenAI
             class APIKeys
               # Creates an API key for a service account in the project.
               #
-              # @overload create(service_account_id, project_id:, name: nil, scopes: nil, request_options: {})
+              # @overload create(service_account_id, project_id:, expires_in_seconds: nil, name: nil, scopes: nil, request_options: {})
               #
               # @param service_account_id [String] Path param: The ID of the service account.
               #
               # @param project_id [String] Path param: The ID of the project.
               #
+              # @param expires_in_seconds [Integer, nil] Body param: Number of seconds until the API key expires.
+              #
               # @param name [String] Body param: API key name.
               #
               # @param scopes [Array<String>] Body param: API key scopes.

data/lib/openai/resources/containers/files.rb

@@ -37,6 +37,7 @@ module OpenAI
           @client.request(
             method: :post,
             path: ["containers/%1$s/files", container_id],
+            headers: parsed[:file].nil? ? nil : {"content-type" => "multipart/form-data"},
             body: parsed,
             model: OpenAI::Models::Containers::FileCreateResponse,
             security: {bearer_auth: true},

data/lib/openai/resources/responses.rb

@@ -136,7 +136,7 @@ module OpenAI
       # [file search](https://platform.openai.com/docs/guides/tools-file-search) to use
       # your own data as input for the model's response.
       #
-      # @overload stream(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_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
+      # @overload stream(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, response_id: nil, safety_identifier: nil, service_tier: nil, starting_after: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
       #
       # @param background [Boolean, nil] Whether to run the model response in the background.
       #
@@ -162,7 +162,7 @@ module OpenAI
       #
       # @param parallel_tool_calls [Boolean, nil] Whether to allow the model to run tool calls in parallel.
       #
-      # @param previous_response_id [String, nil] The unique ID of the previous response to the response to the model. Use this to resume streams from a given response.
+      # @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to create multi-turn conversations.
       #
       # @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
       #
@@ -174,10 +174,14 @@ module OpenAI
       #
       # @param reasoning [OpenAI::Models::Reasoning, nil] **o-series models only**
       #
+      # @param response_id [String, nil] The ID of the response whose stream to resume.
+      #
       # @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
       #
       # @param service_tier [Symbol, OpenAI::Models::Responses::ResponseCreateParams::ServiceTier, nil] Specifies the processing type used for serving the request.
       #
+      # @param starting_after [Integer, nil] The sequence number of the event after which to resume streaming. Can only be used with `response_id`.
+      #
       # @param store [Boolean, nil] Whether to store the generated model response for later retrieval via
       #
       # @param temperature [Float, nil] What sampling temperature to use, between 0 and 2. Higher values like 0.8 will m
@@ -288,7 +292,7 @@ module OpenAI
       #
       # @param parallel_tool_calls [Boolean, nil] Whether to allow the model to run tool calls in parallel.
       #
-      # @param previous_response_id [String, nil] The unique ID of the previous response to the response to the model. Use this to resume streams from a given response.
+      # @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to create multi-turn conversations.
       #
       # @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
       #
@@ -356,7 +360,7 @@ module OpenAI
       #
       # Retrieves a model response with the given ID.
       #
-      # @overload retrieve(response_id, include: nil, include_obfuscation: nil, starting_after: nil, request_options: {})
+      # @overload retrieve(response_id, include: nil, include_obfuscation: nil, starting_after: nil, text: nil, tools: nil, request_options: {})
       #
       # @param response_id [String] The ID of the response to retrieve.
       #
@@ -366,6 +370,14 @@ module OpenAI
       #
       # @param starting_after [Integer] The sequence number of the event after which to start streaming.
       #
+      # @param text [OpenAI::Responses::ResponseTextConfig, OpenAI::StructuredOutput::JsonSchemaConverter, Hash, nil] The structured-output model,
+      #   or the same typed/hash text configuration accepted by creation, used to parse retrieved text output. This is a local parsing hint and is not
+      #   sent to the API.
+      #
+      # @param tools [Array<OpenAI::Responses::FunctionTool, OpenAI::StructuredOutput::JsonSchemaConverter, Hash>, nil] Structured-output models, or
+      #   the same typed/hash function-tool definitions accepted by creation, used to parse retrieved function tool calls. These are local parsing hints
+      #   and are not sent to the API.
+      #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [OpenAI::Models::Responses::Response]
@@ -373,16 +385,28 @@ module OpenAI
       # @see OpenAI::Models::Responses::ResponseRetrieveParams
       def retrieve(response_id, params = {})
         parsed, options = OpenAI::Responses::ResponseRetrieveParams.dump_request(params)
+        structured_output_params = parsed.slice(:text, :tools)
+        parsed.delete(:text)
+        parsed.delete(:tools)
         query = OpenAI::Internal::Util.encode_query_params(parsed)
         if parsed[:stream]
           message = "Please use `#retrieve_streaming` for the streaming use case."
           raise ArgumentError.new(message)
         end
 
+        model, tool_models = get_retrieval_structured_output_models(structured_output_params)
+
+        unwrap = if model || !tool_models.empty?
+          -> (raw) do
+            parse_retrieved_structured_outputs!(raw, model, tool_models)
+          end
+        end
+
         @client.request(
           method: :get,
           path: ["responses/%1$s", response_id],
           query: query,
+          unwrap: unwrap,
           model: OpenAI::Responses::Response,
           security: {bearer_auth: true},
           options: options
@@ -552,9 +576,17 @@ module OpenAI
         OpenAI::Helpers::StructuredOutput::ResponseParser.parse!(raw, model, tool_models)
       end
 
+      def parse_retrieved_structured_outputs!(raw, model, tool_models)
+        OpenAI::Helpers::StructuredOutput::ResponseParser.parse_retrieved!(raw, model, tool_models)
+      end
+
       def get_structured_output_models(parsed)
         OpenAI::Helpers::StructuredOutput::ResponseParser.get_models(parsed)
       end
+
+      def get_retrieval_structured_output_models(parsed)
+        OpenAI::Helpers::StructuredOutput::ResponseParser.get_retrieval_models(parsed)
+      end
     end
   end
 end