openai 0.78.0 → 0.80.0

data/rbi/openai/models/responses/web_search_tool.rbi

@@ -13,6 +13,15 @@ module OpenAI
         sig { returns(OpenAI::Responses::WebSearchTool::Type::OrSymbol) }
         attr_accessor :type
 
+        # Allow live internet access for web search. Defaults to true when omitted. When
+        # false, the web search tool runs in offline/cache-only mode and will not fetch
+        # new external content.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :external_web_access
+
+        sig { params(external_web_access: T::Boolean).void }
+        attr_writer :external_web_access
+
         # Filters for the search.
         sig { returns(T.nilable(OpenAI::Responses::WebSearchTool::Filters)) }
         attr_reader :filters
@@ -63,6 +72,7 @@ module OpenAI
         sig do
           params(
             type: OpenAI::Responses::WebSearchTool::Type::OrSymbol,
+            external_web_access: T::Boolean,
             filters:
               T.nilable(OpenAI::Responses::WebSearchTool::Filters::OrHash),
             search_context_size:
@@ -74,6 +84,10 @@ module OpenAI
         def self.new(
           # The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
           type:,
+          # Allow live internet access for web search. Defaults to true when omitted. When
+          # false, the web search tool runs in offline/cache-only mode and will not fetch
+          # new external content.
+          external_web_access: nil,
           # Filters for the search.
           filters: nil,
           # High level guidance for the amount of context window space to use for the
@@ -88,6 +102,7 @@ module OpenAI
           override.returns(
             {
               type: OpenAI::Responses::WebSearchTool::Type::OrSymbol,
+              external_web_access: T::Boolean,
               filters: T.nilable(OpenAI::Responses::WebSearchTool::Filters),
               search_context_size:
                 OpenAI::Responses::WebSearchTool::SearchContextSize::OrSymbol,

data/rbi/openai/models/responses_model.rbi

@@ -73,6 +73,16 @@ module OpenAI
             :"computer-use-preview-2025-03-11",
             OpenAI::ResponsesModel::ResponsesOnlyModel::TaggedSymbol
           )
+        GPT_5_5_PRO =
+          T.let(
+            :"gpt-5.5-pro",
+            OpenAI::ResponsesModel::ResponsesOnlyModel::TaggedSymbol
+          )
+        GPT_5_5_PRO_2026_04_23 =
+          T.let(
+            :"gpt-5.5-pro-2026-04-23",
+            OpenAI::ResponsesModel::ResponsesOnlyModel::TaggedSymbol
+          )
         GPT_5_CODEX =
           T.let(
             :"gpt-5-codex",
@@ -93,6 +103,21 @@ module OpenAI
             :"gpt-5.1-codex-max",
             OpenAI::ResponsesModel::ResponsesOnlyModel::TaggedSymbol
           )
+        GPT_DAYBREAK_BLUE_LATEST =
+          T.let(
+            :"gpt-daybreak-blue-latest",
+            OpenAI::ResponsesModel::ResponsesOnlyModel::TaggedSymbol
+          )
+        GPT_DAYBREAK_RED_LATEST =
+          T.let(
+            :"gpt-daybreak-red-latest",
+            OpenAI::ResponsesModel::ResponsesOnlyModel::TaggedSymbol
+          )
+        GPT_5_6_CYBER =
+          T.let(
+            :"gpt-5.6-cyber",
+            OpenAI::ResponsesModel::ResponsesOnlyModel::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/openai/models/skill_create_params.rbi

@@ -12,6 +12,10 @@ module OpenAI
         end
 
       # Skill files to upload (directory upload) or a single zip file.
+      #
+      # `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.
       sig { returns(T.nilable(OpenAI::SkillCreateParams::Files::Variants)) }
       attr_reader :files
 
@@ -26,6 +30,10 @@ module OpenAI
       end
       def self.new(
         # Skill files to upload (directory upload) or a single zip file.
+        #
+        # `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.
         files: nil,
         request_options: {}
       )

data/rbi/openai/models/skills/version_create_params.rbi

@@ -26,6 +26,10 @@ module OpenAI
         attr_writer :default
 
         # Skill files to upload (directory upload) or a single zip file.
+        #
+        # `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.
         sig do
           returns(
             T.nilable(OpenAI::Skills::VersionCreateParams::Files::Variants)
@@ -53,6 +57,10 @@ module OpenAI
           # Whether to set this version as the default.
           default: nil,
           # Skill files to upload (directory upload) or a single zip file.
+          #
+          # `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.
           files: nil,
           request_options: {}
         )

data/rbi/openai/models/uploads/part_create_params.rbi

@@ -16,6 +16,10 @@ module OpenAI
         attr_accessor :upload_id
 
         # The chunk of bytes for this Part.
+        #
+        # `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.
         sig { returns(OpenAI::Internal::FileInput) }
         attr_accessor :data
 
@@ -29,6 +33,10 @@ module OpenAI
         def self.new(
           upload_id:,
           # The chunk of bytes for this Part.
+          #
+          # `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.
           data:,
           request_options: {}
         )

data/rbi/openai/models/video_create_character_params.rbi

@@ -16,6 +16,10 @@ module OpenAI
       attr_accessor :name
 
       # Video file used to create a character.
+      #
+      # `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.
       sig { returns(OpenAI::Internal::FileInput) }
       attr_accessor :video
 
@@ -30,6 +34,10 @@ module OpenAI
         # Display name for this API character.
         name:,
         # Video file used to create a character.
+        #
+        # `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.
         video:,
         request_options: {}
       )

data/rbi/openai/models/video_create_params.rbi

@@ -16,6 +16,10 @@ module OpenAI
       attr_accessor :prompt
 
       # Optional reference asset upload or reference object that guides generation.
+      #
+      # `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.
       sig do
         returns(
           T.nilable(
@@ -77,6 +81,10 @@ module OpenAI
         # Text prompt that describes the video to generate.
         prompt:,
         # Optional reference asset upload or reference object that guides generation.
+        #
+        # `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.
         input_reference: nil,
         # The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
         # to `sora-2`.

data/rbi/openai/models/video_edit_params.rbi

@@ -16,6 +16,10 @@ module OpenAI
       attr_accessor :prompt
 
       # Reference to the completed video to edit.
+      #
+      # `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.
       sig do
         returns(
           T.any(
@@ -41,6 +45,10 @@ module OpenAI
         # Text prompt that describes how to edit the source video.
         prompt:,
         # Reference to the completed video to edit.
+        #
+        # `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.
         video:,
         request_options: {}
       )

data/rbi/openai/models/video_extend_params.rbi

@@ -21,6 +21,10 @@ module OpenAI
       attr_accessor :seconds
 
       # Reference to the completed video to extend.
+      #
+      # `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.
       sig do
         returns(
           T.any(
@@ -50,6 +54,10 @@ module OpenAI
         # 8, 12, 16, 20).
         seconds:,
         # Reference to the completed video to extend.
+        #
+        # `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.
         video:,
         request_options: {}
       )

data/rbi/openai/net_http_client.rbi

@@ -10,7 +10,7 @@ module OpenAI
     private def connect(url:)
     end
 
-    sig { params(conn: Net::HTTP, deadline: Float).void }
+    sig { params(conn: Net::HTTP, deadline: T.nilable(Float)).void }
     private def calibrate_socket_timeout(conn, deadline)
     end
 
@@ -26,7 +26,7 @@ module OpenAI
     sig do
       params(
         url: URI::Generic,
-        deadline: Float,
+        deadline: T.nilable(Float),
         blk: T.proc.params(arg0: Net::HTTP).void
       ).void
     end

data/rbi/openai/providers.rbi

@@ -5,6 +5,16 @@ module OpenAI
     class << self
       sig do
         params(
+          endpoint: T.nilable(String),
+          api_key: T.nilable(String),
+          token_provider: T.nilable(T.proc.returns(String))
+        ).returns(OpenAI::Provider)
+      end
+      def azure(endpoint: nil, api_key: nil, token_provider: nil); end
+
+      sig do
+        params(
+          endpoint: T.nilable(T.any(String, Symbol)),
           region: T.nilable(String),
           base_url: T.nilable(String),
           api_key: T.nilable(String),
@@ -17,6 +27,7 @@ module OpenAI
         ).returns(OpenAI::Provider)
       end
       def bedrock(
+        endpoint: nil,
         region: nil,
         base_url: nil,
         api_key: nil,

data/rbi/openai/resources/audio/transcriptions.rbi

@@ -44,7 +44,13 @@ module OpenAI
         end
         def create(
           # The audio file object (not file name) to transcribe, in one of these formats:
-          # flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.
+          # flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm. The request must include
+          # enough format metadata for the file to be identified. We recommend an
+          # extension-bearing filename and an appropriate content type.
+          #
+          # `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.
           file:,
           # ID of the model to use. The options are `gpt-transcribe`, `gpt-4o-transcribe`,
           # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`, `whisper-1`
@@ -159,7 +165,13 @@ module OpenAI
         end
         def create_streaming(
           # The audio file object (not file name) to transcribe, in one of these formats:
-          # flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.
+          # flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm. The request must include
+          # enough format metadata for the file to be identified. We recommend an
+          # extension-bearing filename and an appropriate content type.
+          #
+          # `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.
           file:,
           # ID of the model to use. The options are `gpt-transcribe`, `gpt-4o-transcribe`,
           # `gpt-4o-mini-transcribe`, `gpt-4o-mini-transcribe-2025-12-15`, `whisper-1`

data/rbi/openai/resources/audio/translations.rbi

@@ -19,7 +19,13 @@ module OpenAI
         end
         def create(
           # The audio file object (not file name) translate, in one of these formats: flac,
-          # mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.
+          # mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm. The request must include enough
+          # format metadata for the file to be identified. We recommend an extension-bearing
+          # filename and an appropriate content type.
+          #
+          # `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.
           file:,
           # ID of the model to use. Only `whisper-1` (which is powered by our open source
           # Whisper V2 model) is currently available.

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

@@ -269,6 +269,10 @@ module OpenAI
           #   Responses or Chat Completions. The response will show `service_tier=priority`
           #   regardless of if you specify `service_tier=fast` or `priority` in your
           #   request.
+          # - If set to 'ultrafast', then the request will be processed with the
+          #   access-controlled Ultrafast Processing service tier. This tier is currently
+          #   available for `gpt-5.6-sol`; a response served through it will show
+          #   `service_tier=ultrafast`.
           # - When not set, the default behavior is 'auto'.
           #
           # When the `service_tier` parameter is set, the response body will include the
@@ -616,6 +620,10 @@ module OpenAI
           #   Responses or Chat Completions. The response will show `service_tier=priority`
           #   regardless of if you specify `service_tier=fast` or `priority` in your
           #   request.
+          # - If set to 'ultrafast', then the request will be processed with the
+          #   access-controlled Ultrafast Processing service tier. This tier is currently
+          #   available for `gpt-5.6-sol`; a response served through it will show
+          #   `service_tier=ultrafast`.
           # - When not set, the default behavior is 'auto'.
           #
           # When the `service_tier` parameter is set, the response body will include the

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

@@ -22,6 +22,10 @@ module OpenAI
         def create(
           container_id,
           # The File object (not file name) to be uploaded.
+          #
+          # `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.
           file: nil,
           # Name of the file to create.
           file_id: nil,

data/rbi/openai/resources/content_provenance_checks.rbi

@@ -20,6 +20,10 @@ module OpenAI
       end
       def create(
         # The image or audio file to check for supported OpenAI provenance signals.
+        #
+        # `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.
         file:,
         request_options: {}
       )

data/rbi/openai/resources/files.rbi

@@ -42,6 +42,10 @@ module OpenAI
       end
       def create(
         # The File object (not file name) to be uploaded.
+        #
+        # `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.
         file:,
         # The intended purpose of the uploaded file. One of:
         #
@@ -115,7 +119,7 @@ module OpenAI
       )
       end
 
-      # Returns the contents of the specified file.
+      # Returns a response containing the contents of the specified file.
       sig do
         params(
           file_id: String,

data/rbi/openai/resources/images.rbi

@@ -22,6 +22,10 @@ module OpenAI
       def create_variation(
         # The image to use as the basis for the variation(s). Must be a valid PNG file,
         # less than 4MB, and square.
+        #
+        # `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:,
         # The model to use for image generation. Only `dall-e-2` is supported at this
         # time.
@@ -82,6 +86,10 @@ module OpenAI
         #
         # 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.
@@ -108,6 +116,10 @@ module OpenAI
         # indicate where `image` should be edited. If there are multiple images provided,
         # the mask will be applied on the first image. Must be a valid PNG file, less than
         # 4MB, and have the same dimensions as `image`.
+        #
+        # `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.
         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`,
@@ -203,6 +215,10 @@ module OpenAI
         #
         # 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.
@@ -229,6 +245,10 @@ module OpenAI
         # indicate where `image` should be edited. If there are multiple images provided,
         # the mask will be applied on the first image. Must be a valid PNG file, less than
         # 4MB, and have the same dimensions as `image`.
+        #
+        # `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.
         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`,

data/rbi/openai/resources/responses.rbi

@@ -266,6 +266,10 @@ module OpenAI
         #   Responses or Chat Completions. The response will show `service_tier=priority`
         #   regardless of if you specify `service_tier=fast` or `priority` in your
         #   request.
+        # - If set to 'ultrafast', then the request will be processed with the
+        #   access-controlled Ultrafast Processing service tier. This tier is currently
+        #   available for `gpt-5.6-sol`; a response served through it will show
+        #   `service_tier=ultrafast`.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the
@@ -606,6 +610,10 @@ module OpenAI
         #   Responses or Chat Completions. The response will show `service_tier=priority`
         #   regardless of if you specify `service_tier=fast` or `priority` in your
         #   request.
+        # - If set to 'ultrafast', then the request will be processed with the
+        #   access-controlled Ultrafast Processing service tier. This tier is currently
+        #   available for `gpt-5.6-sol`; a response served through it will show
+        #   `service_tier=ultrafast`.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the

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

@@ -22,6 +22,10 @@ module OpenAI
           # Whether to set this version as the default.
           default: nil,
           # Skill files to upload (directory upload) or a single zip file.
+          #
+          # `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.
           files: nil,
           request_options: {}
         )

data/rbi/openai/resources/skills.rbi

@@ -18,6 +18,10 @@ module OpenAI
       end
       def create(
         # Skill files to upload (directory upload) or a single zip file.
+        #
+        # `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.
         files: nil,
         request_options: {}
       )

data/rbi/openai/resources/uploads/parts.rbi

@@ -27,6 +27,10 @@ module OpenAI
           # The ID of the Upload.
           upload_id,
           # The chunk of bytes for this Part.
+          #
+          # `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.
           data:,
           request_options: {}
         )

data/rbi/openai/resources/videos.rbi

@@ -22,6 +22,10 @@ module OpenAI
         # Text prompt that describes the video to generate.
         prompt:,
         # Optional reference asset upload or reference object that guides generation.
+        #
+        # `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.
         input_reference: nil,
         # The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
         # to `sora-2`.
@@ -96,6 +100,10 @@ module OpenAI
         # Display name for this API character.
         name:,
         # Video file used to create a character.
+        #
+        # `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.
         video:,
         request_options: {}
       )
@@ -137,6 +145,10 @@ module OpenAI
         # Text prompt that describes how to edit the source video.
         prompt:,
         # Reference to the completed video to edit.
+        #
+        # `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.
         video:,
         request_options: {}
       )
@@ -162,6 +174,10 @@ module OpenAI
         # 8, 12, 16, 20).
         seconds:,
         # Reference to the completed video to extend.
+        #
+        # `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.
         video:,
         request_options: {}
       )

data/sig/openai/client.rbs

@@ -91,11 +91,15 @@ module OpenAI
       ?webhook_secret: String?,
       ?provider: OpenAI::Provider?,
       ?base_url: String?,
+      ?default_headers: ::Hash[String, String?]?,
       ?max_retries: Integer,
-      ?timeout: Float,
+      ?timeout: Float?,
       ?initial_retry_delay: Float,
       ?max_retry_delay: Float,
-      ?http_client: OpenAI::_HTTPClient?
+      ?http_client: OpenAI::_HTTPClient?,
+      ?logger: OpenAI::_Logger?,
+      ?log_level: (Symbol | String)?,
+      ?on_retry: (^(OpenAI::RetryEvent) -> void)?
     ) -> void
   end
 end

data/sig/openai/errors.rbs

@@ -31,6 +31,11 @@ module OpenAI
 
       attr_accessor type: String?
 
+      # The ID of the API request, returned via the `x-request-id` response
+      # header. This is nil when no HTTP response was received or the response
+      # did not include the header.
+      def request_id: -> String?
+
       def initialize: (
         url: URI::Generic,
         ?status: Integer?,

data/sig/openai/http_client.rbs

@@ -1,4 +1,38 @@
 module OpenAI
+  interface _Logger
+    def debug: (String message) -> untyped
+    def info: (String message) -> untyped
+    def warn: (String message) -> untyped
+    def error: (String message) -> untyped
+  end
+
+  class ResponseMetadata
+    attr_reader status: Integer
+    attr_reader headers: ::Hash[String, String]
+    attr_reader request_id: String?
+
+    def initialize: (status: Integer, headers: ::Hash[String, String]) -> void
+  end
+
+  class RetryEvent
+    attr_reader attempt: Integer
+    attr_reader max_attempts: Integer
+    attr_reader delay: Float
+    attr_reader response: OpenAI::ResponseMetadata?
+    attr_reader error: OpenAI::Errors::APIConnectionError?
+
+    def initialize: (
+      attempt: Integer,
+      max_attempts: Integer,
+      delay: Float,
+      response: OpenAI::ResponseMetadata?,
+      error: OpenAI::Errors::APIConnectionError?
+    ) -> void
+
+    def status: -> Integer?
+    def request_id: -> String?
+  end
+
   interface _HTTPClient
     def execute: (
       OpenAI::HTTPClient::Request request
@@ -11,14 +45,14 @@ module OpenAI
       attr_reader url: URI::Generic
       attr_reader headers: ::Hash[String, String]
       attr_reader body: top
-      attr_reader timeout: Float
+      attr_reader timeout: Float?
 
       def initialize: (
         method: Symbol,
         url: URI::Generic,
         headers: ::Hash[String, String],
         body: top,
-        timeout: Float
+        timeout: Float?
       ) -> void
     end
 
@@ -26,6 +60,7 @@ module OpenAI
       attr_reader status: Integer
       attr_reader headers: ::Hash[String, String]
       attr_reader body: Enumerable[String]
+      attr_reader metadata: OpenAI::ResponseMetadata
 
       def initialize: (
         status: Integer,