openai 0.29.0 → 0.30.0

data/rbi/openai/models/video_model.rbi

@@ -0,0 +1,19 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module VideoModel
+      extend OpenAI::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::VideoModel) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      SORA_2 = T.let(:"sora-2", OpenAI::VideoModel::TaggedSymbol)
+      SORA_2_PRO = T.let(:"sora-2-pro", OpenAI::VideoModel::TaggedSymbol)
+
+      sig { override.returns(T::Array[OpenAI::VideoModel::TaggedSymbol]) }
+      def self.values
+      end
+    end
+  end
+end

data/rbi/openai/models/video_remix_params.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    class VideoRemixParams < OpenAI::Internal::Type::BaseModel
+      extend OpenAI::Internal::Type::RequestParameters::Converter
+      include OpenAI::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(OpenAI::VideoRemixParams, OpenAI::Internal::AnyHash)
+        end
+
+      # Updated text prompt that directs the remix generation.
+      sig { returns(String) }
+      attr_accessor :prompt
+
+      sig do
+        params(
+          prompt: String,
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Updated text prompt that directs the remix generation.
+        prompt:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          { prompt: String, request_options: OpenAI::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/openai/models/video_retrieve_params.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    class VideoRetrieveParams < OpenAI::Internal::Type::BaseModel
+      extend OpenAI::Internal::Type::RequestParameters::Converter
+      include OpenAI::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(OpenAI::VideoRetrieveParams, OpenAI::Internal::AnyHash)
+        end
+
+      sig do
+        params(request_options: OpenAI::RequestOptions::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(request_options: {})
+      end
+
+      sig { override.returns({ request_options: OpenAI::RequestOptions }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/openai/models/video_seconds.rbi

@@ -0,0 +1,20 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module VideoSeconds
+      extend OpenAI::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::VideoSeconds) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      VIDEO_SECONDS_4 = T.let(:"4", OpenAI::VideoSeconds::TaggedSymbol)
+      VIDEO_SECONDS_8 = T.let(:"8", OpenAI::VideoSeconds::TaggedSymbol)
+      VIDEO_SECONDS_12 = T.let(:"12", OpenAI::VideoSeconds::TaggedSymbol)
+
+      sig { override.returns(T::Array[OpenAI::VideoSeconds::TaggedSymbol]) }
+      def self.values
+      end
+    end
+  end
+end

data/rbi/openai/models/video_size.rbi

@@ -0,0 +1,23 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module VideoSize
+      extend OpenAI::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::VideoSize) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      VIDEO_SIZE_720X1280 = T.let(:"720x1280", OpenAI::VideoSize::TaggedSymbol)
+      VIDEO_SIZE_1280X720 = T.let(:"1280x720", OpenAI::VideoSize::TaggedSymbol)
+      VIDEO_SIZE_1024X1792 =
+        T.let(:"1024x1792", OpenAI::VideoSize::TaggedSymbol)
+      VIDEO_SIZE_1792X1024 =
+        T.let(:"1792x1024", OpenAI::VideoSize::TaggedSymbol)
+
+      sig { override.returns(T::Array[OpenAI::VideoSize::TaggedSymbol]) }
+      def self.values
+      end
+    end
+  end
+end

data/rbi/openai/models.rbi

@@ -224,5 +224,27 @@ module OpenAI
 
   VectorStoreUpdateParams = OpenAI::Models::VectorStoreUpdateParams
 
+  Video = OpenAI::Models::Video
+
+  VideoCreateError = OpenAI::Models::VideoCreateError
+
+  VideoCreateParams = OpenAI::Models::VideoCreateParams
+
+  VideoDeleteParams = OpenAI::Models::VideoDeleteParams
+
+  VideoDownloadContentParams = OpenAI::Models::VideoDownloadContentParams
+
+  VideoListParams = OpenAI::Models::VideoListParams
+
+  VideoModel = OpenAI::Models::VideoModel
+
+  VideoRemixParams = OpenAI::Models::VideoRemixParams
+
+  VideoRetrieveParams = OpenAI::Models::VideoRetrieveParams
+
+  VideoSeconds = OpenAI::Models::VideoSeconds
+
+  VideoSize = OpenAI::Models::VideoSize
+
   Webhooks = OpenAI::Models::Webhooks
 end

data/rbi/openai/resources/beta/chatkit/sessions.rbi

@@ -0,0 +1,61 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Beta
+      class ChatKit
+        class Sessions
+          # Create a ChatKit session
+          sig do
+            params(
+              user: String,
+              workflow: OpenAI::Beta::ChatKit::ChatSessionWorkflowParam::OrHash,
+              chatkit_configuration:
+                OpenAI::Beta::ChatKit::ChatSessionChatKitConfigurationParam::OrHash,
+              expires_after:
+                OpenAI::Beta::ChatKit::ChatSessionExpiresAfterParam::OrHash,
+              rate_limits:
+                OpenAI::Beta::ChatKit::ChatSessionRateLimitsParam::OrHash,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Beta::ChatKit::ChatSession)
+          end
+          def create(
+            # A free-form string that identifies your end user; ensures this Session can
+            # access other objects that have the same `user` scope.
+            user:,
+            # Workflow that powers the session.
+            workflow:,
+            # Optional overrides for ChatKit runtime configuration features
+            chatkit_configuration: nil,
+            # Optional override for session expiration timing in seconds from creation.
+            # Defaults to 10 minutes.
+            expires_after: nil,
+            # Optional override for per-minute request limits. When omitted, defaults to 10.
+            rate_limits: nil,
+            request_options: {}
+          )
+          end
+
+          # Cancel a ChatKit session
+          sig do
+            params(
+              session_id: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Beta::ChatKit::ChatSession)
+          end
+          def cancel(
+            # Unique identifier for the ChatKit session to cancel.
+            session_id,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/beta/chatkit/threads.rbi

@@ -0,0 +1,110 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Beta
+      class ChatKit
+        class Threads
+          # Retrieve a ChatKit thread
+          sig do
+            params(
+              thread_id: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Beta::ChatKit::ChatKitThread)
+          end
+          def retrieve(
+            # Identifier of the ChatKit thread to retrieve.
+            thread_id,
+            request_options: {}
+          )
+          end
+
+          # List ChatKit threads
+          sig do
+            params(
+              after: String,
+              before: String,
+              limit: Integer,
+              order: OpenAI::Beta::ChatKit::ThreadListParams::Order::OrSymbol,
+              user: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Internal::ConversationCursorPage[
+                OpenAI::Beta::ChatKit::ChatKitThread
+              ]
+            )
+          end
+          def list(
+            # List items created after this thread item ID. Defaults to null for the first
+            # page.
+            after: nil,
+            # List items created before this thread item ID. Defaults to null for the newest
+            # results.
+            before: nil,
+            # Maximum number of thread items to return. Defaults to 20.
+            limit: nil,
+            # Sort order for results by creation time. Defaults to `desc`.
+            order: nil,
+            # Filter threads that belong to this user identifier. Defaults to null to return
+            # all users.
+            user: nil,
+            request_options: {}
+          )
+          end
+
+          # Delete a ChatKit thread
+          sig do
+            params(
+              thread_id: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(OpenAI::Models::Beta::ChatKit::ThreadDeleteResponse)
+          end
+          def delete(
+            # Identifier of the ChatKit thread to delete.
+            thread_id,
+            request_options: {}
+          )
+          end
+
+          # List ChatKit thread items
+          sig do
+            params(
+              thread_id: String,
+              after: String,
+              before: String,
+              limit: Integer,
+              order:
+                OpenAI::Beta::ChatKit::ThreadListItemsParams::Order::OrSymbol,
+              request_options: OpenAI::RequestOptions::OrHash
+            ).returns(
+              OpenAI::Internal::ConversationCursorPage[
+                OpenAI::Beta::ChatKit::ChatKitThreadItemList::Data::Variants
+              ]
+            )
+          end
+          def list_items(
+            # Identifier of the ChatKit thread whose items are requested.
+            thread_id,
+            # List items created after this thread item ID. Defaults to null for the first
+            # page.
+            after: nil,
+            # List items created before this thread item ID. Defaults to null for the newest
+            # results.
+            before: nil,
+            # Maximum number of thread items to return. Defaults to 20.
+            limit: nil,
+            # Sort order for results by creation time. Defaults to `desc`.
+            order: nil,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/beta/chatkit.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Beta
+      class ChatKit
+        sig { returns(OpenAI::Resources::Beta::ChatKit::Sessions) }
+        attr_reader :sessions
+
+        sig { returns(OpenAI::Resources::Beta::ChatKit::Threads) }
+        attr_reader :threads
+
+        # Upload a ChatKit file
+        sig do
+          params(
+            file: OpenAI::Internal::FileInput,
+            request_options: OpenAI::RequestOptions::OrHash
+          ).returns(OpenAI::Models::Beta::ChatKitUploadFileResponse::Variants)
+        end
+        def upload_file(
+          # Binary file contents to store with the ChatKit session. Supports PDFs and PNG,
+          # JPG, JPEG, GIF, or WEBP images.
+          file:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: OpenAI::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/openai/resources/beta.rbi

@@ -3,6 +3,9 @@
 module OpenAI
   module Resources
     class Beta
+      sig { returns(OpenAI::Resources::Beta::ChatKit) }
+      attr_reader :chatkit
+
       sig { returns(OpenAI::Resources::Beta::Assistants) }
       attr_reader :assistants
 

data/rbi/openai/resources/images.rbi

@@ -91,7 +91,8 @@ module OpenAI
         background: nil,
         # Control how much effort the model will exert to match the style and features,
         # especially facial features, of input images. This parameter is only supported
-        # for `gpt-image-1`. Supports `high` and `low`. Defaults to `low`.
+        # for `gpt-image-1`. Unsupported for `gpt-image-1-mini`. Supports `high` and
+        # `low`. Defaults to `low`.
         input_fidelity: nil,
         # An additional image whose fully transparent areas (e.g. where alpha is zero)
         # indicate where `image` should be edited. If there are multiple images provided,
@@ -194,7 +195,8 @@ module OpenAI
         background: nil,
         # Control how much effort the model will exert to match the style and features,
         # especially facial features, of input images. This parameter is only supported
-        # for `gpt-image-1`. Supports `high` and `low`. Defaults to `low`.
+        # for `gpt-image-1`. Unsupported for `gpt-image-1-mini`. Supports `high` and
+        # `low`. Defaults to `low`.
         input_fidelity: nil,
         # An additional image whose fully transparent areas (e.g. where alpha is zero)
         # indicate where `image` should be edited. If there are multiple images provided,

data/rbi/openai/resources/videos.rbi

@@ -0,0 +1,121 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+    class Videos
+      # Create a video
+      sig do
+        params(
+          prompt: String,
+          input_reference: OpenAI::Internal::FileInput,
+          model: OpenAI::VideoModel::OrSymbol,
+          seconds: OpenAI::VideoSeconds::OrSymbol,
+          size: OpenAI::VideoSize::OrSymbol,
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(OpenAI::Video)
+      end
+      def create(
+        # Text prompt that describes the video to generate.
+        prompt:,
+        # Optional image reference that guides generation.
+        input_reference: nil,
+        # The video generation model to use. Defaults to `sora-2`.
+        model: nil,
+        # Clip duration in seconds. Defaults to 4 seconds.
+        seconds: nil,
+        # Output resolution formatted as width x height. Defaults to 720x1280.
+        size: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieve a video
+      sig do
+        params(
+          video_id: String,
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(OpenAI::Video)
+      end
+      def retrieve(
+        # The identifier of the video to retrieve.
+        video_id,
+        request_options: {}
+      )
+      end
+
+      # List videos
+      sig do
+        params(
+          after: String,
+          limit: Integer,
+          order: OpenAI::VideoListParams::Order::OrSymbol,
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(OpenAI::Internal::ConversationCursorPage[OpenAI::Video])
+      end
+      def list(
+        # Identifier for the last item from the previous pagination request
+        after: nil,
+        # Number of items to retrieve
+        limit: nil,
+        # Sort order of results by timestamp. Use `asc` for ascending order or `desc` for
+        # descending order.
+        order: nil,
+        request_options: {}
+      )
+      end
+
+      # Delete a video
+      sig do
+        params(
+          video_id: String,
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(OpenAI::Models::VideoDeleteResponse)
+      end
+      def delete(
+        # The identifier of the video to delete.
+        video_id,
+        request_options: {}
+      )
+      end
+
+      # Download video content
+      sig do
+        params(
+          video_id: String,
+          variant: OpenAI::VideoDownloadContentParams::Variant::OrSymbol,
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(StringIO)
+      end
+      def download_content(
+        # The identifier of the video whose media to download.
+        video_id,
+        # Which downloadable asset to return. Defaults to the MP4 video.
+        variant: nil,
+        request_options: {}
+      )
+      end
+
+      # Create a video remix
+      sig do
+        params(
+          video_id: String,
+          prompt: String,
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(OpenAI::Video)
+      end
+      def remix(
+        # The identifier of the completed video to remix.
+        video_id,
+        # Updated text prompt that directs the remix generation.
+        prompt:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: OpenAI::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/sig/openai/client.rbs

@@ -54,6 +54,8 @@ module OpenAI
 
     attr_reader containers: OpenAI::Resources::Containers
 
+    attr_reader videos: OpenAI::Resources::Videos
+
     private def auth_headers: -> ::Hash[String, String]
 
     def initialize: (

data/sig/openai/models/all_models.rbs

@@ -20,6 +20,8 @@ module OpenAI
         | :"computer-use-preview"
         | :"computer-use-preview-2025-03-11"
         | :"gpt-5-codex"
+        | :"gpt-5-pro"
+        | :"gpt-5-pro-2025-10-06"
 
       module ResponsesOnlyModel
         extend OpenAI::Internal::Type::Enum
@@ -35,6 +37,8 @@ module OpenAI
         COMPUTER_USE_PREVIEW: :"computer-use-preview"
         COMPUTER_USE_PREVIEW_2025_03_11: :"computer-use-preview-2025-03-11"
         GPT_5_CODEX: :"gpt-5-codex"
+        GPT_5_PRO: :"gpt-5-pro"
+        GPT_5_PRO_2025_10_06: :"gpt-5-pro-2025-10-06"
 
         def self?.values: -> ::Array[OpenAI::Models::AllModels::responses_only_model]
       end

data/sig/openai/models/beta/chatkit/chat_session.rbs

@@ -0,0 +1,69 @@
+module OpenAI
+  module Models
+    module Beta
+      module ChatKit
+        type chat_session =
+          {
+            id: String,
+            chatkit_configuration: OpenAI::Beta::ChatKit::ChatSessionChatKitConfiguration,
+            client_secret: String,
+            expires_at: Integer,
+            :max_requests_per_1_minute => Integer,
+            object: :"chatkit.session",
+            rate_limits: OpenAI::Beta::ChatKit::ChatSessionRateLimits,
+            status: OpenAI::Models::Beta::ChatKit::chat_session_status,
+            user: String,
+            workflow: OpenAI::Beta::ChatKitWorkflow
+          }
+
+        class ChatSession < OpenAI::Internal::Type::BaseModel
+          attr_accessor id: String
+
+          attr_accessor chatkit_configuration: OpenAI::Beta::ChatKit::ChatSessionChatKitConfiguration
+
+          attr_accessor client_secret: String
+
+          attr_accessor expires_at: Integer
+
+          attr_accessor max_requests_per_1_minute: Integer
+
+          attr_accessor object: :"chatkit.session"
+
+          attr_accessor rate_limits: OpenAI::Beta::ChatKit::ChatSessionRateLimits
+
+          attr_accessor status: OpenAI::Models::Beta::ChatKit::chat_session_status
+
+          attr_accessor user: String
+
+          attr_accessor workflow: OpenAI::Beta::ChatKitWorkflow
+
+          def initialize: (
+            id: String,
+            chatkit_configuration: OpenAI::Beta::ChatKit::ChatSessionChatKitConfiguration,
+            client_secret: String,
+            expires_at: Integer,
+            max_requests_per_1_minute: Integer,
+            rate_limits: OpenAI::Beta::ChatKit::ChatSessionRateLimits,
+            status: OpenAI::Models::Beta::ChatKit::chat_session_status,
+            user: String,
+            workflow: OpenAI::Beta::ChatKitWorkflow,
+            ?object: :"chatkit.session"
+          ) -> void
+
+          def to_hash: -> {
+            id: String,
+            chatkit_configuration: OpenAI::Beta::ChatKit::ChatSessionChatKitConfiguration,
+            client_secret: String,
+            expires_at: Integer,
+            :max_requests_per_1_minute => Integer,
+            object: :"chatkit.session",
+            rate_limits: OpenAI::Beta::ChatKit::ChatSessionRateLimits,
+            status: OpenAI::Models::Beta::ChatKit::chat_session_status,
+            user: String,
+            workflow: OpenAI::Beta::ChatKitWorkflow
+          }
+        end
+      end
+    end
+  end
+end

data/sig/openai/models/beta/chatkit/chat_session_automatic_thread_titling.rbs

@@ -0,0 +1,17 @@
+module OpenAI
+  module Models
+    module Beta
+      module ChatKit
+        type chat_session_automatic_thread_titling = { enabled: bool }
+
+        class ChatSessionAutomaticThreadTitling < OpenAI::Internal::Type::BaseModel
+          attr_accessor enabled: bool
+
+          def initialize: (enabled: bool) -> void
+
+          def to_hash: -> { enabled: bool }
+        end
+      end
+    end
+  end
+end

data/sig/openai/models/beta/chatkit/chat_session_chatkit_configuration.rbs

@@ -0,0 +1,34 @@
+module OpenAI
+  module Models
+    module Beta
+      module ChatKit
+        type chat_session_chatkit_configuration =
+          {
+            automatic_thread_titling: OpenAI::Beta::ChatKit::ChatSessionAutomaticThreadTitling,
+            file_upload: OpenAI::Beta::ChatKit::ChatSessionFileUpload,
+            history: OpenAI::Beta::ChatKit::ChatSessionHistory
+          }
+
+        class ChatSessionChatKitConfiguration < OpenAI::Internal::Type::BaseModel
+          attr_accessor automatic_thread_titling: OpenAI::Beta::ChatKit::ChatSessionAutomaticThreadTitling
+
+          attr_accessor file_upload: OpenAI::Beta::ChatKit::ChatSessionFileUpload
+
+          attr_accessor history: OpenAI::Beta::ChatKit::ChatSessionHistory
+
+          def initialize: (
+            automatic_thread_titling: OpenAI::Beta::ChatKit::ChatSessionAutomaticThreadTitling,
+            file_upload: OpenAI::Beta::ChatKit::ChatSessionFileUpload,
+            history: OpenAI::Beta::ChatKit::ChatSessionHistory
+          ) -> void
+
+          def to_hash: -> {
+            automatic_thread_titling: OpenAI::Beta::ChatKit::ChatSessionAutomaticThreadTitling,
+            file_upload: OpenAI::Beta::ChatKit::ChatSessionFileUpload,
+            history: OpenAI::Beta::ChatKit::ChatSessionHistory
+          }
+        end
+      end
+    end
+  end
+end