openai 0.86.0 → 0.88.0

data/lib/openai/models/vector_stores/file_batch_create_params.rb

@@ -37,12 +37,12 @@ module OpenAI
         optional :chunking_strategy, union: -> { OpenAI::FileChunkingStrategyParam }
 
         # @!attribute file_ids
-        #   A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-        #   the vector store should use. Useful for tools like `file_search` that can access
-        #   files. If `attributes` or `chunking_strategy` are provided, they will be applied
-        #   to all files in the batch. The maximum batch size is 2000 files. This endpoint
-        #   is recommended for multi-file ingestion and helps reduce per-vector-store write
-        #   request pressure. Mutually exclusive with `files`.
+        #   A list of [File](https://developers.openai.com/api/reference/resources/files)
+        #   IDs that the vector store should use. Useful for tools like `file_search` that
+        #   can access files. If `attributes` or `chunking_strategy` are provided, they will
+        #   be applied to all files in the batch. The maximum batch size is 2000 files. This
+        #   endpoint is recommended for multi-file ingestion and helps reduce
+        #   per-vector-store write request pressure. Mutually exclusive with `files`.
         #
         #   @return [Array<String>, nil]
         optional :file_ids, OpenAI::Internal::Type::ArrayOf[String]
@@ -59,18 +59,34 @@ module OpenAI
         optional :files, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::VectorStores::FileBatchCreateParams::File] }
 
         # @!method initialize(vector_store_id:, attributes: nil, chunking_strategy: nil, file_ids: nil, files: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStores::FileBatchCreateParams} for more details.
-        #
         #   @param vector_store_id [String]
         #
-        #   @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #   @param attributes [Hash{Symbol=>String, Float, Boolean}, nil]
+        #     Set of 16 key-value pairs that can be attached to an object. This can be useful
+        #     for storing additional information about the object in a structured format, and
+        #     querying for objects via API or the dashboard. Keys are strings with a maximum
+        #     length of 64 characters. Values are strings with a maximum length of 512
+        #     characters, booleans, or numbers.
         #
-        #   @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+        #   @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam]
+        #     The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+        #     strategy. Only applicable if `file_ids` is non-empty.
         #
-        #   @param file_ids [Array<String>] A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
+        #   @param file_ids [Array<String>]
+        #     A list of [File](https://developers.openai.com/api/reference/resources/files)
+        #     IDs that the vector store should use. Useful for tools like `file_search` that
+        #     can access files. If `attributes` or `chunking_strategy` are provided, they will
+        #     be applied to all files in the batch. The maximum batch size is 2000 files. This
+        #     endpoint is recommended for multi-file ingestion and helps reduce
+        #     per-vector-store write request pressure. Mutually exclusive with `files`.
         #
-        #   @param files [Array<OpenAI::Models::VectorStores::FileBatchCreateParams::File>] A list of objects that each include a `file_id` plus optional `attributes` or `c
+        #   @param files [Array<OpenAI::Models::VectorStores::FileBatchCreateParams::File>]
+        #     A list of objects that each include a `file_id` plus optional `attributes` or
+        #     `chunking_strategy`. Use this when you need to override metadata for specific
+        #     files. The global `attributes` or `chunking_strategy` will be ignored and must
+        #     be specified for each file. The maximum batch size is 2000 files. This endpoint
+        #     is recommended for multi-file ingestion and helps reduce per-vector-store write
+        #     request pressure. Mutually exclusive with `file_ids`.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -89,10 +105,10 @@ module OpenAI
 
         class File < OpenAI::Internal::Type::BaseModel
           # @!attribute file_id
-          #   A [File](https://platform.openai.com/docs/api-reference/files) ID that the
-          #   vector store should use. Useful for tools like `file_search` that can access
+          #   A [File](https://developers.openai.com/api/reference/resources/files) ID that
+          #   the vector store should use. Useful for tools like `file_search` that can access
           #   files. For multi-file ingestion, we recommend
-          #   [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          #   [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
           #   to minimize per-vector-store write requests.
           #
           #   @return [String]
@@ -122,15 +138,23 @@ module OpenAI
           optional :chunking_strategy, union: -> { OpenAI::FileChunkingStrategyParam }
 
           # @!method initialize(file_id:, attributes: nil, chunking_strategy: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::VectorStores::FileBatchCreateParams::File} for more details.
+          #   @param file_id [String]
+          #     A [File](https://developers.openai.com/api/reference/resources/files) ID that
+          #     the vector store should use. Useful for tools like `file_search` that can access
+          #     files. For multi-file ingestion, we recommend
+          #     [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
+          #     to minimize per-vector-store write requests.
           #
-          #   @param file_id [String] A [File](https://platform.openai.com/docs/api-reference/files) ID that the vecto
+          #   @param attributes [Hash{Symbol=>String, Float, Boolean}, nil]
+          #     Set of 16 key-value pairs that can be attached to an object. This can be useful
+          #     for storing additional information about the object in a structured format, and
+          #     querying for objects via API or the dashboard. Keys are strings with a maximum
+          #     length of 64 characters. Values are strings with a maximum length of 512
+          #     characters, booleans, or numbers.
           #
-          #   @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
-          #
-          #   @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the file(s). If not set, will use the `auto`
-
+          #   @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam]
+          #     The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+          #     strategy. Only applicable if `file_ids` is non-empty.
           module Attribute
             extend OpenAI::Internal::Type::Union
 

data/lib/openai/models/vector_stores/file_batch_list_files_params.rb

@@ -57,22 +57,32 @@ module OpenAI
         optional :order, enum: -> { OpenAI::VectorStores::FileBatchListFilesParams::Order }
 
         # @!method initialize(vector_store_id:, batch_id:, after: nil, before: nil, filter: nil, limit: nil, order: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStores::FileBatchListFilesParams} for more details.
-        #
         #   @param vector_store_id [String]
         #
         #   @param batch_id [String]
         #
-        #   @param after [String] A cursor for use in pagination. `after` is an object ID that defines your place
+        #   @param after [String]
+        #     A cursor for use in pagination. `after` is an object ID that defines your place
+        #     in the list. For instance, if you make a list request and receive 100 objects,
+        #     ending with obj_foo, your subsequent call can include after=obj_foo in order to
+        #     fetch the next page of the list.
         #
-        #   @param before [String] A cursor for use in pagination. `before` is an object ID that defines your place
+        #   @param before [String]
+        #     A cursor for use in pagination. `before` is an object ID that defines your place
+        #     in the list. For instance, if you make a list request and receive 100 objects,
+        #     starting with obj_foo, your subsequent call can include before=obj_foo in order
+        #     to fetch the previous page of the list.
         #
-        #   @param filter [Symbol, OpenAI::Models::VectorStores::FileBatchListFilesParams::Filter] Filter by file status. One of `in_progress`, `completed`, `failed`, `cancelled`.
+        #   @param filter [Symbol, OpenAI::Models::VectorStores::FileBatchListFilesParams::Filter]
+        #     Filter by file status. One of `in_progress`, `completed`, `failed`, `cancelled`.
         #
-        #   @param limit [Integer] A limit on the number of objects to be returned. Limit can range between 1 and 1
+        #   @param limit [Integer]
+        #     A limit on the number of objects to be returned. Limit can range between 1 and
+        #     100, and the default is 20.
         #
-        #   @param order [Symbol, OpenAI::Models::VectorStores::FileBatchListFilesParams::Order] Sort order by the `created_at` timestamp of the objects. `asc` for ascending ord
+        #   @param order [Symbol, OpenAI::Models::VectorStores::FileBatchListFilesParams::Order]
+        #     Sort order by the `created_at` timestamp of the objects. `asc` for ascending
+        #     order and `desc` for descending order.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/vector_stores/file_content_response.rb

@@ -18,9 +18,11 @@ module OpenAI
         optional :type, String
 
         # @!method initialize(text: nil, type: nil)
-        #   @param text [String] The text content
+        #   @param text [String]
+        #     The text content
         #
-        #   @param type [String] The content type (currently only `"text"`)
+        #   @param type [String]
+        #     The content type (currently only `"text"`)
       end
     end
   end

data/lib/openai/models/vector_stores/file_create_params.rb

@@ -14,10 +14,10 @@ module OpenAI
         required :vector_store_id, String
 
         # @!attribute file_id
-        #   A [File](https://platform.openai.com/docs/api-reference/files) ID that the
-        #   vector store should use. Useful for tools like `file_search` that can access
+        #   A [File](https://developers.openai.com/api/reference/resources/files) ID that
+        #   the vector store should use. Useful for tools like `file_search` that can access
         #   files. For multi-file ingestion, we recommend
-        #   [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+        #   [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
         #   to minimize per-vector-store write requests.
         #
         #   @return [String]
@@ -47,16 +47,25 @@ module OpenAI
         optional :chunking_strategy, union: -> { OpenAI::FileChunkingStrategyParam }
 
         # @!method initialize(vector_store_id:, file_id:, attributes: nil, chunking_strategy: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStores::FileCreateParams} for more details.
-        #
         #   @param vector_store_id [String]
         #
-        #   @param file_id [String] A [File](https://platform.openai.com/docs/api-reference/files) ID that the vecto
+        #   @param file_id [String]
+        #     A [File](https://developers.openai.com/api/reference/resources/files) ID that
+        #     the vector store should use. Useful for tools like `file_search` that can access
+        #     files. For multi-file ingestion, we recommend
+        #     [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
+        #     to minimize per-vector-store write requests.
         #
-        #   @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #   @param attributes [Hash{Symbol=>String, Float, Boolean}, nil]
+        #     Set of 16 key-value pairs that can be attached to an object. This can be useful
+        #     for storing additional information about the object in a structured format, and
+        #     querying for objects via API or the dashboard. Keys are strings with a maximum
+        #     length of 64 characters. Values are strings with a maximum length of 512
+        #     characters, booleans, or numbers.
         #
-        #   @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+        #   @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam]
+        #     The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+        #     strategy. Only applicable if `file_ids` is non-empty.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/vector_stores/file_list_params.rb

@@ -52,20 +52,30 @@ module OpenAI
         optional :order, enum: -> { OpenAI::VectorStores::FileListParams::Order }
 
         # @!method initialize(vector_store_id:, after: nil, before: nil, filter: nil, limit: nil, order: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStores::FileListParams} for more details.
-        #
         #   @param vector_store_id [String]
         #
-        #   @param after [String] A cursor for use in pagination. `after` is an object ID that defines your place
+        #   @param after [String]
+        #     A cursor for use in pagination. `after` is an object ID that defines your place
+        #     in the list. For instance, if you make a list request and receive 100 objects,
+        #     ending with obj_foo, your subsequent call can include after=obj_foo in order to
+        #     fetch the next page of the list.
         #
-        #   @param before [String] A cursor for use in pagination. `before` is an object ID that defines your place
+        #   @param before [String]
+        #     A cursor for use in pagination. `before` is an object ID that defines your place
+        #     in the list. For instance, if you make a list request and receive 100 objects,
+        #     starting with obj_foo, your subsequent call can include before=obj_foo in order
+        #     to fetch the previous page of the list.
         #
-        #   @param filter [Symbol, OpenAI::Models::VectorStores::FileListParams::Filter] Filter by file status. One of `in_progress`, `completed`, `failed`, `cancelled`.
+        #   @param filter [Symbol, OpenAI::Models::VectorStores::FileListParams::Filter]
+        #     Filter by file status. One of `in_progress`, `completed`, `failed`, `cancelled`.
         #
-        #   @param limit [Integer] A limit on the number of objects to be returned. Limit can range between 1 and 1
+        #   @param limit [Integer]
+        #     A limit on the number of objects to be returned. Limit can range between 1 and
+        #     100, and the default is 20.
         #
-        #   @param order [Symbol, OpenAI::Models::VectorStores::FileListParams::Order] Sort order by the `created_at` timestamp of the objects. `asc` for ascending ord
+        #   @param order [Symbol, OpenAI::Models::VectorStores::FileListParams::Order]
+        #     Sort order by the `created_at` timestamp of the objects. `asc` for ascending
+        #     order and `desc` for descending order.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/vector_stores/file_update_params.rb

@@ -35,14 +35,16 @@ module OpenAI
         )
 
         # @!method initialize(vector_store_id:, file_id:, attributes:, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStores::FileUpdateParams} for more details.
-        #
         #   @param vector_store_id [String]
         #
         #   @param file_id [String]
         #
-        #   @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #   @param attributes [Hash{Symbol=>String, Float, Boolean}, nil]
+        #     Set of 16 key-value pairs that can be attached to an object. This can be useful
+        #     for storing additional information about the object in a structured format, and
+        #     querying for objects via API or the dashboard. Keys are strings with a maximum
+        #     length of 64 characters. Values are strings with a maximum length of 512
+        #     characters, booleans, or numbers.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/vector_stores/vector_store_file.rb

@@ -47,8 +47,8 @@ module OpenAI
 
         # @!attribute vector_store_id
         #   The ID of the
-        #   [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
-        #   that the [File](https://platform.openai.com/docs/api-reference/files) is
+        #   [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+        #   that the [File](https://developers.openai.com/api/reference/resources/files) is
         #   attached to.
         #
         #   @return [String]
@@ -77,28 +77,45 @@ module OpenAI
         optional :chunking_strategy, union: -> { OpenAI::FileChunkingStrategy }
 
         # @!method initialize(id:, created_at:, last_error:, status:, usage_bytes:, vector_store_id:, attributes: nil, chunking_strategy: nil, object: :"vector_store.file")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStores::VectorStoreFile} for more details.
-        #
         #   A list of files attached to a vector store.
         #
-        #   @param id [String] The identifier, which can be referenced in API endpoints.
+        #   @param id [String]
+        #     The identifier, which can be referenced in API endpoints.
         #
-        #   @param created_at [Integer] The Unix timestamp (in seconds) for when the vector store file was created.
+        #   @param created_at [Integer]
+        #     The Unix timestamp (in seconds) for when the vector store file was created.
         #
-        #   @param last_error [OpenAI::Models::VectorStores::VectorStoreFile::LastError, nil] The last error associated with this vector store file. Will be `null` if there a
+        #   @param last_error [OpenAI::Models::VectorStores::VectorStoreFile::LastError, nil]
+        #     The last error associated with this vector store file. Will be `null` if there
+        #     are no errors.
         #
-        #   @param status [Symbol, OpenAI::Models::VectorStores::VectorStoreFile::Status] The status of the vector store file, which can be either `in_progress`, `complet
+        #   @param status [Symbol, OpenAI::Models::VectorStores::VectorStoreFile::Status]
+        #     The status of the vector store file, which can be either `in_progress`,
+        #     `completed`, `cancelled`, or `failed`. The status `completed` indicates that the
+        #     vector store file is ready for use.
         #
-        #   @param usage_bytes [Integer] The total vector store usage in bytes. Note that this may be different from the
+        #   @param usage_bytes [Integer]
+        #     The total vector store usage in bytes. Note that this may be different from the
+        #     original file size.
         #
-        #   @param vector_store_id [String] The ID of the [vector store](https://platform.openai.com/docs/api-reference/vect
+        #   @param vector_store_id [String]
+        #     The ID of the
+        #     [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+        #     that the [File](https://developers.openai.com/api/reference/resources/files) is
+        #     attached to.
         #
-        #   @param attributes [Hash{Symbol=>String, Float, Boolean}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #   @param attributes [Hash{Symbol=>String, Float, Boolean}, nil]
+        #     Set of 16 key-value pairs that can be attached to an object. This can be useful
+        #     for storing additional information about the object in a structured format, and
+        #     querying for objects via API or the dashboard. Keys are strings with a maximum
+        #     length of 64 characters. Values are strings with a maximum length of 512
+        #     characters, booleans, or numbers.
         #
-        #   @param chunking_strategy [OpenAI::Models::StaticFileChunkingStrategyObject, OpenAI::Models::OtherFileChunkingStrategyObject] The strategy used to chunk the file.
+        #   @param chunking_strategy [OpenAI::Models::StaticFileChunkingStrategyObject, OpenAI::Models::OtherFileChunkingStrategyObject]
+        #     The strategy used to chunk the file.
         #
-        #   @param object [Symbol, :"vector_store.file"] The object type, which is always `vector_store.file`.
+        #   @param object [Symbol, :"vector_store.file"]
+        #     The object type, which is always `vector_store.file`.
 
         # @see OpenAI::Models::VectorStores::VectorStoreFile#last_error
         class LastError < OpenAI::Internal::Type::BaseModel
@@ -118,9 +135,11 @@ module OpenAI
           #   The last error associated with this vector store file. Will be `null` if there
           #   are no errors.
           #
-          #   @param code [Symbol, OpenAI::Models::VectorStores::VectorStoreFile::LastError::Code] One of `server_error`, `unsupported_file`, or `invalid_file`.
+          #   @param code [Symbol, OpenAI::Models::VectorStores::VectorStoreFile::LastError::Code]
+          #     One of `server_error`, `unsupported_file`, or `invalid_file`.
           #
-          #   @param message [String] A human-readable description of the error.
+          #   @param message [String]
+          #     A human-readable description of the error.
 
           # One of `server_error`, `unsupported_file`, or `invalid_file`.
           #

data/lib/openai/models/vector_stores/vector_store_file_batch.rb

@@ -38,30 +38,37 @@ module OpenAI
 
         # @!attribute vector_store_id
         #   The ID of the
-        #   [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
-        #   that the [File](https://platform.openai.com/docs/api-reference/files) is
+        #   [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+        #   that the [File](https://developers.openai.com/api/reference/resources/files) is
         #   attached to.
         #
         #   @return [String]
         required :vector_store_id, String
 
         # @!method initialize(id:, created_at:, file_counts:, status:, vector_store_id:, object: :"vector_store.files_batch")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::VectorStores::VectorStoreFileBatch} for more details.
-        #
         #   A batch of files attached to a vector store.
         #
-        #   @param id [String] The identifier, which can be referenced in API endpoints.
+        #   @param id [String]
+        #     The identifier, which can be referenced in API endpoints.
         #
-        #   @param created_at [Integer] The Unix timestamp (in seconds) for when the vector store files batch was create
+        #   @param created_at [Integer]
+        #     The Unix timestamp (in seconds) for when the vector store files batch was
+        #     created.
         #
         #   @param file_counts [OpenAI::Models::VectorStores::VectorStoreFileBatch::FileCounts]
         #
-        #   @param status [Symbol, OpenAI::Models::VectorStores::VectorStoreFileBatch::Status] The status of the vector store files batch, which can be either `in_progress`, `
+        #   @param status [Symbol, OpenAI::Models::VectorStores::VectorStoreFileBatch::Status]
+        #     The status of the vector store files batch, which can be either `in_progress`,
+        #     `completed`, `cancelled` or `failed`.
         #
-        #   @param vector_store_id [String] The ID of the [vector store](https://platform.openai.com/docs/api-reference/vect
+        #   @param vector_store_id [String]
+        #     The ID of the
+        #     [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+        #     that the [File](https://developers.openai.com/api/reference/resources/files) is
+        #     attached to.
         #
-        #   @param object [Symbol, :"vector_store.files_batch"] The object type, which is always `vector_store.file_batch`.
+        #   @param object [Symbol, :"vector_store.files_batch"]
+        #     The object type, which is always `vector_store.file_batch`.
 
         # @see OpenAI::Models::VectorStores::VectorStoreFileBatch#file_counts
         class FileCounts < OpenAI::Internal::Type::BaseModel
@@ -96,15 +103,20 @@ module OpenAI
           required :total, Integer
 
           # @!method initialize(cancelled:, completed:, failed:, in_progress:, total:)
-          #   @param cancelled [Integer] The number of files that where cancelled.
+          #   @param cancelled [Integer]
+          #     The number of files that where cancelled.
           #
-          #   @param completed [Integer] The number of files that have been processed.
+          #   @param completed [Integer]
+          #     The number of files that have been processed.
           #
-          #   @param failed [Integer] The number of files that have failed to process.
+          #   @param failed [Integer]
+          #     The number of files that have failed to process.
           #
-          #   @param in_progress [Integer] The number of files that are currently being processed.
+          #   @param in_progress [Integer]
+          #     The number of files that are currently being processed.
           #
-          #   @param total [Integer] The total number of files.
+          #   @param total [Integer]
+          #     The total number of files.
         end
 
         # The status of the vector store files batch, which can be either `in_progress`,

data/lib/openai/models/video.rb

@@ -84,36 +84,47 @@ module OpenAI
       required :status, enum: -> { OpenAI::Video::Status }
 
       # @!method initialize(id:, completed_at:, created_at:, error:, expires_at:, model:, progress:, prompt:, remixed_from_video_id:, seconds:, size:, status:, object: :video)
-      #   Some parameter documentations has been truncated, see {OpenAI::Models::Video}
-      #   for more details.
-      #
       #   Structured information describing a generated video job.
       #
-      #   @param id [String] Unique identifier for the video job.
+      #   @param id [String]
+      #     Unique identifier for the video job.
       #
-      #   @param completed_at [Integer, nil] Unix timestamp (seconds) for when the job completed, if finished.
+      #   @param completed_at [Integer, nil]
+      #     Unix timestamp (seconds) for when the job completed, if finished.
       #
-      #   @param created_at [Integer] Unix timestamp (seconds) for when the job was created.
+      #   @param created_at [Integer]
+      #     Unix timestamp (seconds) for when the job was created.
       #
-      #   @param error [OpenAI::Models::VideoCreateError, nil] Error payload that explains why generation failed, if applicable.
+      #   @param error [OpenAI::Models::VideoCreateError, nil]
+      #     Error payload that explains why generation failed, if applicable.
       #
-      #   @param expires_at [Integer, nil] Unix timestamp (seconds) for when the downloadable assets expire, if set.
+      #   @param expires_at [Integer, nil]
+      #     Unix timestamp (seconds) for when the downloadable assets expire, if set.
       #
-      #   @param model [String, Symbol, OpenAI::Models::VideoModel] The video generation model that produced the job.
+      #   @param model [String, Symbol, OpenAI::Models::VideoModel]
+      #     The video generation model that produced the job.
       #
-      #   @param progress [Integer] Approximate completion percentage for the generation task.
+      #   @param progress [Integer]
+      #     Approximate completion percentage for the generation task.
       #
-      #   @param prompt [String, nil] The prompt that was used to generate the video.
+      #   @param prompt [String, nil]
+      #     The prompt that was used to generate the video.
       #
-      #   @param remixed_from_video_id [String, nil] Identifier of the source video if this video is a remix.
+      #   @param remixed_from_video_id [String, nil]
+      #     Identifier of the source video if this video is a remix.
       #
-      #   @param seconds [String, Symbol, OpenAI::Models::VideoSeconds] Duration of the generated clip in seconds. For extensions, this is the stitched
+      #   @param seconds [String, Symbol, OpenAI::Models::VideoSeconds]
+      #     Duration of the generated clip in seconds. For extensions, this is the stitched
+      #     total duration.
       #
-      #   @param size [Symbol, OpenAI::Models::VideoSize] The resolution of the generated video.
+      #   @param size [Symbol, OpenAI::Models::VideoSize]
+      #     The resolution of the generated video.
       #
-      #   @param status [Symbol, OpenAI::Models::Video::Status] Current lifecycle status of the video job.
+      #   @param status [Symbol, OpenAI::Models::Video::Status]
+      #     Current lifecycle status of the video job.
       #
-      #   @param object [Symbol, :video] The object type, which is always `video`.
+      #   @param object [Symbol, :video]
+      #     The object type, which is always `video`.
 
       # Duration of the generated clip in seconds. For extensions, this is the stitched
       # total duration.

data/lib/openai/models/video_create_character_params.rb

@@ -24,9 +24,15 @@ module OpenAI
       required :video, OpenAI::Internal::Type::FileInput
 
       # @!method initialize(name:, video:, request_options: {})
-      #   @param name [String] Display name for this API character.
+      #   @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 video [Pathname, StringIO, IO, String, OpenAI::FilePart]
+      #     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.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/openai/models/video_create_character_response.rb

@@ -23,11 +23,14 @@ module OpenAI
       required :name, String, nil?: true
 
       # @!method initialize(id:, created_at:, name:)
-      #   @param id [String, nil] Identifier for the character creation cameo.
+      #   @param id [String, nil]
+      #     Identifier for the character creation cameo.
       #
-      #   @param created_at [Integer] Unix timestamp (in seconds) when the character was created.
+      #   @param created_at [Integer]
+      #     Unix timestamp (in seconds) when the character was created.
       #
-      #   @param name [String, nil] Display name for the character.
+      #   @param name [String, nil]
+      #     Display name for the character.
     end
   end
 end

data/lib/openai/models/video_create_error.rb

@@ -23,9 +23,11 @@ module OpenAI
       # @!method initialize(code:, message:, misalignment: nil)
       #   An error that occurred while generating the response.
       #
-      #   @param code [String] A machine-readable error code that was returned.
+      #   @param code [String]
+      #     A machine-readable error code that was returned.
       #
-      #   @param message [String] A human-readable description of the error that was returned.
+      #   @param message [String]
+      #     A human-readable description of the error that was returned.
       #
       #   @param misalignment [OpenAI::Models::VideoCreateError::Misalignment]
 
@@ -50,11 +52,14 @@ module OpenAI
         optional :steer, -> { OpenAI::VideoCreateError::Misalignment::Steer }
 
         # @!method initialize(detailed_explanation: nil, error_type: nil, steer: nil)
-        #   @param detailed_explanation [String] The public explanation for this block.
+        #   @param detailed_explanation [String]
+        #     The public explanation for this block.
         #
-        #   @param error_type [String, Symbol, OpenAI::Models::VideoCreateError::Misalignment::ErrorType] An optional classification; clients must accept additional values.
+        #   @param error_type [String, Symbol, OpenAI::Models::VideoCreateError::Misalignment::ErrorType]
+        #     An optional classification; clients must accept additional values.
         #
-        #   @param steer [OpenAI::Models::VideoCreateError::Misalignment::Steer] An optional public continuation instruction.
+        #   @param steer [OpenAI::Models::VideoCreateError::Misalignment::Steer]
+        #     An optional public continuation instruction.
 
         # An optional classification; clients must accept additional values.
         #
@@ -110,7 +115,8 @@ module OpenAI
           # @!method initialize(message:)
           #   An optional public continuation instruction.
           #
-          #   @param message [String] The public continuation instruction.
+          #   @param message [String]
+          #     The public continuation instruction.
         end
       end
     end

data/lib/openai/models/video_create_params.rb

@@ -44,18 +44,26 @@ module OpenAI
       optional :size, enum: -> { OpenAI::VideoSize }
 
       # @!method initialize(prompt:, input_reference: nil, model: nil, seconds: nil, size: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::VideoCreateParams} for more details.
+      #   @param prompt [String]
+      #     Text prompt that describes the video to generate.
       #
-      #   @param prompt [String] Text prompt that describes the video to generate.
+      #   @param input_reference [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::ImageInputReferenceParam]
+      #     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.
+      #     `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.
       #
-      #   @param model [String, Symbol, OpenAI::Models::VideoModel] The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
+      #   @param model [String, Symbol, OpenAI::Models::VideoModel]
+      #     The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
+      #     to `sora-2`.
       #
-      #   @param seconds [Symbol, OpenAI::Models::VideoSeconds] Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
+      #   @param seconds [Symbol, OpenAI::Models::VideoSeconds]
+      #     Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
       #
-      #   @param size [Symbol, OpenAI::Models::VideoSize] Output resolution formatted as width x height (allowed values: 720x1280, 1280x72
+      #   @param size [Symbol, OpenAI::Models::VideoSize]
+      #     Output resolution formatted as width x height (allowed values: 720x1280,
+      #     1280x720, 1024x1792, 1792x1024). Defaults to 720x1280.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/video_delete_response.rb

@@ -25,11 +25,14 @@ module OpenAI
       # @!method initialize(id:, deleted:, object: :"video.deleted")
       #   Confirmation payload returned after deleting a video.
       #
-      #   @param id [String] Identifier of the deleted video.
+      #   @param id [String]
+      #     Identifier of the deleted video.
       #
-      #   @param deleted [Boolean] Indicates that the video resource was deleted.
+      #   @param deleted [Boolean]
+      #     Indicates that the video resource was deleted.
       #
-      #   @param object [Symbol, :"video.deleted"] The object type that signals the deletion response.
+      #   @param object [Symbol, :"video.deleted"]
+      #     The object type that signals the deletion response.
     end
   end
 end