feat(api): sora api improvements: character api, video extensions/edits, higher resolution exports.

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 151
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-8de5b14ece687aac55187d923c8dca4b8c4a4dbaaa38bb1bcfffc975d441aca8.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-3e207c26eea3b15837c78ef2fe0e1c68937708fd0763971ce749c0bdb7db6376.yml
 openapi_spec_hash: 626982004d5a594a822fa7883422efb4
-config_hash: 8421b0e4dae127df4dcc071c1aa5ea1a
+config_hash: 0dda4b3af379312c9c55467a5e1e1ec0

lib/openai.rb

@@ -403,6 +403,7 @@
 require_relative "openai/models/image_generate_params"
 require_relative "openai/models/image_gen_partial_image_event"
 require_relative "openai/models/image_gen_stream_event"
+require_relative "openai/models/image_input_reference_param"
 require_relative "openai/models/image_model"
 require_relative "openai/models/images_response"
 require_relative "openai/models/metadata"
@@ -733,21 +734,21 @@
 require_relative "openai/models/vector_store_search_response"
 require_relative "openai/models/vector_store_update_params"
 require_relative "openai/models/video"
+require_relative "openai/models/video_create_character_params"
+require_relative "openai/models/video_create_character_response"
 require_relative "openai/models/video_create_error"
 require_relative "openai/models/video_create_params"
 require_relative "openai/models/video_delete_params"
 require_relative "openai/models/video_delete_response"
 require_relative "openai/models/video_download_content_params"
 require_relative "openai/models/video_edit_params"
 require_relative "openai/models/video_extend_params"
+require_relative "openai/models/video_get_character_params"
+require_relative "openai/models/video_get_character_response"
 require_relative "openai/models/video_list_params"
 require_relative "openai/models/video_model"
 require_relative "openai/models/video_remix_params"
 require_relative "openai/models/video_retrieve_params"
-require_relative "openai/models/videos/character_create_params"
-require_relative "openai/models/videos/character_create_response"
-require_relative "openai/models/videos/character_get_params"
-require_relative "openai/models/videos/character_get_response"
 require_relative "openai/models/video_seconds"
 require_relative "openai/models/video_size"
 require_relative "openai/models/webhooks/batch_cancelled_webhook_event"
@@ -825,7 +826,6 @@
 require_relative "openai/resources/vector_stores/file_batches"
 require_relative "openai/resources/vector_stores/files"
 require_relative "openai/resources/videos"
-require_relative "openai/resources/videos/character"
 require_relative "openai/resources/webhooks"
 require_relative "openai/helpers/streaming/response_events"
 require_relative "openai/helpers/streaming/response_stream"

lib/openai/models.rb

@@ -176,6 +176,8 @@ module OpenAI
 
   ImageGenStreamEvent = OpenAI::Models::ImageGenStreamEvent
 
+  ImageInputReferenceParam = OpenAI::Models::ImageInputReferenceParam
+
   ImageModel = OpenAI::Models::ImageModel
 
   ImagesResponse = OpenAI::Models::ImagesResponse
@@ -279,6 +281,8 @@ module OpenAI
 
   Video = OpenAI::Models::Video
 
+  VideoCreateCharacterParams = OpenAI::Models::VideoCreateCharacterParams
+
   VideoCreateError = OpenAI::Models::VideoCreateError
 
   VideoCreateParams = OpenAI::Models::VideoCreateParams
@@ -291,6 +295,8 @@ module OpenAI
 
   VideoExtendParams = OpenAI::Models::VideoExtendParams
 
+  VideoGetCharacterParams = OpenAI::Models::VideoGetCharacterParams
+
   VideoListParams = OpenAI::Models::VideoListParams
 
   VideoModel = OpenAI::Models::VideoModel
@@ -299,8 +305,6 @@ module OpenAI
 
   VideoRetrieveParams = OpenAI::Models::VideoRetrieveParams
 
-  Videos = OpenAI::Models::Videos
-
   VideoSeconds = OpenAI::Models::VideoSeconds
 
   VideoSize = OpenAI::Models::VideoSize

lib/openai/models/image_input_reference_param.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    class ImageInputReferenceParam < OpenAI::Internal::Type::BaseModel
+      # @!attribute file_id
+      #
+      #   @return [String, nil]
+      optional :file_id, String
+
+      # @!attribute image_url
+      #   A fully qualified URL or base64-encoded data URL.
+      #
+      #   @return [String, nil]
+      optional :image_url, String
+
+      # @!method initialize(file_id: nil, image_url: nil)
+      #   @param file_id [String]
+      #
+      #   @param image_url [String] A fully qualified URL or base64-encoded data URL.
+    end
+  end
+end

lib/openai/models/video_create_character_params.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    # @see OpenAI::Resources::Videos#create_character
+    class VideoCreateCharacterParams < OpenAI::Internal::Type::BaseModel
+      extend OpenAI::Internal::Type::RequestParameters::Converter
+      include OpenAI::Internal::Type::RequestParameters
+
+      # @!attribute name
+      #   Display name for this API character.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute video
+      #   Video file used to create a character.
+      #
+      #   @return [Pathname, StringIO, IO, String, OpenAI::FilePart]
+      required :video, OpenAI::Internal::Type::FileInput
+
+      # @!method initialize(name:, video:, request_options: {})
+      #   @param name [String] Display name for this API character.
+      #
+      #   @param video [Pathname, StringIO, IO, String, OpenAI::FilePart] Video file used to create a character.
+      #
+      #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

lib/openai/models/video_create_character_response.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    # @see OpenAI::Resources::Videos#create_character
+    class VideoCreateCharacterResponse < OpenAI::Internal::Type::BaseModel
+      # @!attribute id
+      #   Identifier for the character creation cameo.
+      #
+      #   @return [String, nil]
+      required :id, String, nil?: true
+
+      # @!attribute created_at
+      #   Unix timestamp (in seconds) when the character was created.
+      #
+      #   @return [Integer]
+      required :created_at, Integer
+
+      # @!attribute name
+      #   Display name for the character.
+      #
+      #   @return [String, nil]
+      required :name, String, nil?: true
+
+      # @!method initialize(id:, created_at:, name:)
+      #   @param id [String, nil] Identifier for the character creation cameo.
+      #
+      #   @param created_at [Integer] Unix timestamp (in seconds) when the character was created.
+      #
+      #   @param name [String, nil] Display name for the character.
+    end
+  end
+end

lib/openai/models/video_create_params.rb

@@ -16,7 +16,7 @@ class VideoCreateParams < OpenAI::Internal::Type::BaseModel
       # @!attribute input_reference
       #   Optional reference asset upload or reference object that guides generation.
       #
-      #   @return [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoCreateParams::InputReference::ImageRefParam2, nil]
+      #   @return [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::ImageInputReferenceParam, nil]
       optional :input_reference, union: -> { OpenAI::VideoCreateParams::InputReference }
 
       # @!attribute model
@@ -45,7 +45,7 @@ class VideoCreateParams < OpenAI::Internal::Type::BaseModel
       #
       #   @param prompt [String] Text prompt that describes the video to generate.
       #
-      #   @param input_reference [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoCreateParams::InputReference::ImageRefParam2] Optional reference asset upload or reference object that guides generation.
+      #   @param input_reference [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::ImageInputReferenceParam] Optional reference asset upload or reference object that guides generation.
       #
       #   @param model [String, Symbol, OpenAI::Models::VideoModel] The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
       #
@@ -62,28 +62,10 @@ module InputReference
         # Optional reference asset upload or reference object that guides generation.
         variant OpenAI::Internal::Type::FileInput
 
-        variant -> { OpenAI::VideoCreateParams::InputReference::ImageRefParam2 }
-
-        class ImageRefParam2 < OpenAI::Internal::Type::BaseModel
-          # @!attribute file_id
-          #
-          #   @return [String, nil]
-          optional :file_id, String
-
-          # @!attribute image_url
-          #   A fully qualified URL or base64-encoded data URL.
-          #
-          #   @return [String, nil]
-          optional :image_url, String
-
-          # @!method initialize(file_id: nil, image_url: nil)
-          #   @param file_id [String]
-          #
-          #   @param image_url [String] A fully qualified URL or base64-encoded data URL.
-        end
+        variant -> { OpenAI::ImageInputReferenceParam }
 
         # @!method self.variants
-        #   @return [Array(StringIO, OpenAI::Models::VideoCreateParams::InputReference::ImageRefParam2)]
+        #   @return [Array(StringIO, OpenAI::Models::ImageInputReferenceParam)]
       end
     end
   end

lib/openai/models/video_extend_params.rb

@@ -21,9 +21,9 @@ class VideoExtendParams < OpenAI::Internal::Type::BaseModel
       required :seconds, enum: -> { OpenAI::VideoSeconds }
 
       # @!attribute video
-      #   Reference to the completed video.
+      #   Reference to the completed video to extend.
       #
-      #   @return [OpenAI::Models::VideoExtendParams::Video::VideoReferenceInputParam, Pathname, StringIO, IO, String, OpenAI::FilePart]
+      #   @return [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoExtendParams::Video::VideoReferenceInputParam]
       required :video, union: -> { OpenAI::VideoExtendParams::Video }
 
       # @!method initialize(prompt:, seconds:, video:, request_options: {})
@@ -34,20 +34,20 @@ class VideoExtendParams < OpenAI::Internal::Type::BaseModel
       #
       #   @param seconds [Symbol, OpenAI::Models::VideoSeconds] Length of the newly generated extension segment in seconds (allowed values: 4, 8
       #
-      #   @param video [OpenAI::Models::VideoExtendParams::Video::VideoReferenceInputParam, Pathname, StringIO, IO, String, OpenAI::FilePart] Reference to the completed video.
+      #   @param video [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoExtendParams::Video::VideoReferenceInputParam] Reference to the completed video to extend.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-      # Reference to the completed video.
+      # Reference to the completed video to extend.
       module Video
         extend OpenAI::Internal::Type::Union
 
-        # Reference to the completed video.
-        variant -> { OpenAI::VideoExtendParams::Video::VideoReferenceInputParam }
-
         # Reference to the completed video to extend.
         variant OpenAI::Internal::Type::FileInput
 
+        # Reference to the completed video.
+        variant -> { OpenAI::VideoExtendParams::Video::VideoReferenceInputParam }
+
         class VideoReferenceInputParam < OpenAI::Internal::Type::BaseModel
           # @!attribute id
           #   The identifier of the completed video.
@@ -62,7 +62,7 @@ class VideoReferenceInputParam < OpenAI::Internal::Type::BaseModel
         end
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::VideoExtendParams::Video::VideoReferenceInputParam, StringIO)]
+        #   @return [Array(StringIO, OpenAI::Models::VideoExtendParams::Video::VideoReferenceInputParam)]
       end
     end
   end

lib/openai/models/video_get_character_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    # @see OpenAI::Resources::Videos#get_character
+    class VideoGetCharacterParams < OpenAI::Internal::Type::BaseModel
+      extend OpenAI::Internal::Type::RequestParameters::Converter
+      include OpenAI::Internal::Type::RequestParameters
+
+      # @!attribute character_id
+      #
+      #   @return [String]
+      required :character_id, String
+
+      # @!method initialize(character_id:, request_options: {})
+      #   @param character_id [String]
+      #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

lib/openai/models/video_get_character_response.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    # @see OpenAI::Resources::Videos#get_character
+    class VideoGetCharacterResponse < OpenAI::Internal::Type::BaseModel
+      # @!attribute id
+      #   Identifier for the character creation cameo.
+      #
+      #   @return [String, nil]
+      required :id, String, nil?: true
+
+      # @!attribute created_at
+      #   Unix timestamp (in seconds) when the character was created.
+      #
+      #   @return [Integer]
+      required :created_at, Integer
+
+      # @!attribute name
+      #   Display name for the character.
+      #
+      #   @return [String, nil]
+      required :name, String, nil?: true
+
+      # @!method initialize(id:, created_at:, name:)
+      #   @param id [String, nil] Identifier for the character creation cameo.
+      #
+      #   @param created_at [Integer] Unix timestamp (in seconds) when the character was created.
+      #
+      #   @param name [String, nil] Display name for the character.
+    end
+  end
+end