openai 0.78.0 → 0.79.0

data/rbi/openai/models/responses_model.rbi

@@ -93,6 +93,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

@@ -3,6 +3,15 @@
 module OpenAI
   module Providers
     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(
           region: T.nilable(String),

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/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:
         #

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/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,

data/sig/openai/internal/logging.rbs

@@ -0,0 +1,88 @@
+module OpenAI
+  module Internal
+    module Logging
+      LOG_LEVELS: ::Hash[Symbol, Integer]
+      REDACTED_HEADERS: ::Array[String]
+      MAX_BODY_BYTES: Integer
+      MAX_ARRAY_ITEMS: Integer
+      OPAQUE_STRING_BYTES: Integer
+      SENSITIVE_BODY_KEY: Regexp
+      SENSITIVE_QUERY_KEY: Regexp
+      URL_HEADER_KEY: Regexp
+
+      class Context
+        def initialize: (
+          logger: OpenAI::_Logger?,
+          log_level: Symbol,
+          on_retry: (^(OpenAI::RetryEvent) -> void)?,
+          method: Symbol,
+          url: URI::Generic
+        ) -> void
+        def request_started: (
+          OpenAI::HTTPClient::Request request,
+          redirect_count: Integer
+        ) -> void
+        def response_received: (
+          OpenAI::HTTPClient::Response response
+        ) -> OpenAI::HTTPClient::Response
+        def attempt_failed: (OpenAI::Errors::APIConnectionError error) -> void
+        def retry_scheduled: (
+          Integer | OpenAI::Errors::APIConnectionError cause,
+          delay: Float,
+          response: OpenAI::ResponseMetadata?,
+          retry_count: Integer,
+          max_retries: Integer
+        ) -> void
+        def completed: (OpenAI::HTTPClient::Response response) -> void
+        def observe_stream: [Elem] (
+          OpenAI::Internal::Type::BaseStream[top, Elem] stream,
+          response: OpenAI::HTTPClient::Response
+        ) -> OpenAI::Internal::Type::BaseStream[top, Elem]
+        def request_failed: (StandardError error) -> void
+        def response_body: (
+          String body,
+          headers: ::Hash[String, String],
+          complete: bool,
+          total_bytes: Integer,
+          attempt: Integer
+        ) -> void
+      end
+
+      class ObservedBody
+        include Enumerable[String]
+
+        def initialize: (
+          body: Enumerable[String],
+          headers: ::Hash[String, String],
+          context: OpenAI::Internal::Logging::Context,
+          attempt: Integer
+        ) -> void
+
+        def each: { (String) -> void } -> void
+        def close: -> void
+      end
+
+      def self.normalize_level: (Symbol | String value) -> Symbol
+      def self.validate_logger!: (OpenAI::_Logger? logger) -> void
+      def self.default_logger: -> OpenAI::_Logger
+      def self.enabled?: (Symbol configured_level, Symbol event_level) -> bool
+      def self.safe_path: (URI::Generic url) -> String
+      def self.safe_url: (URI::Generic url) -> String
+      def self.safe_field: (top? value) -> String
+      def self.sensitive_header?: (String | Symbol name) -> bool
+      def self.credential_header?: (String | Symbol name) -> bool
+      def self.format_headers: (::Hash[String, String] headers) -> String
+      def self.format_body: (
+        top body,
+        headers: ::Hash[String, String]
+      ) -> String
+      def self.capture_response_body?: (::Hash[String, String] headers) -> bool
+      def self.format_observed_body: (
+        String body,
+        headers: ::Hash[String, String],
+        complete: bool,
+        total_bytes: Integer
+      ) -> String
+    end
+  end
+end

data/sig/openai/internal/provider.rbs

@@ -7,13 +7,15 @@ module OpenAI
         attr_accessor prepare_request: (^(
           OpenAI::Internal::Transport::BaseClient::request_input
         ) -> OpenAI::Internal::Transport::BaseClient::request_input)?
+        attr_accessor authentication_headers: Array[String]
 
         def initialize: (
           name: String,
           base_url: String,
           prepare_request: (^(
             OpenAI::Internal::Transport::BaseClient::request_input
-          ) -> OpenAI::Internal::Transport::BaseClient::request_input)?
+          ) -> OpenAI::Internal::Transport::BaseClient::request_input)?,
+          authentication_headers: Array[String]
         ) -> void
       end
 

data/sig/openai/internal/read_io_adapter.rbs

@@ -6,7 +6,9 @@ module OpenAI
 
         def close: -> void
 
-        private def read_enum: (Integer? max_len) -> String
+        private def read_enum: (Integer? max_len) -> String?
+
+        private def read_buffer: (Integer max_len) -> String
 
         def read: (?Integer? max_len, ?String? out_string) -> String?