openai 0.87.0 → 0.89.0

data/lib/openai/models/beta/thread_create_params.rb

@@ -9,8 +9,9 @@ module OpenAI
         include OpenAI::Internal::Type::RequestParameters
 
         # @!attribute messages
-        #   A list of [messages](https://platform.openai.com/docs/api-reference/messages) to
-        #   start the thread with.
+        #   A list of
+        #   [messages](https://developers.openai.com/api/docs/assistants/migration) to start
+        #   the thread with.
         #
         #   @return [Array<OpenAI::Models::Beta::ThreadCreateParams::Message>, nil]
         optional :messages, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::ThreadCreateParams::Message] }
@@ -36,14 +37,24 @@ module OpenAI
         optional :tool_resources, -> { OpenAI::Beta::ThreadCreateParams::ToolResources }, nil?: true
 
         # @!method initialize(messages: nil, metadata: nil, tool_resources: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::ThreadCreateParams} for more details.
+        #   @param messages [Array<OpenAI::Models::Beta::ThreadCreateParams::Message>]
+        #     A list of
+        #     [messages](https://developers.openai.com/api/docs/assistants/migration) to start
+        #     the thread with.
         #
-        #   @param messages [Array<OpenAI::Models::Beta::ThreadCreateParams::Message>] A list of [messages](https://platform.openai.com/docs/api-reference/messages) to
+        #   @param metadata [Hash{Symbol=>String}, 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.
         #
-        #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #     Keys are strings with a maximum length of 64 characters. Values are strings with
+        #     a maximum length of 512 characters.
         #
-        #   @param tool_resources [OpenAI::Models::Beta::ThreadCreateParams::ToolResources, nil] A set of resources that are made available to the assistant's tools in this thre
+        #   @param tool_resources [OpenAI::Models::Beta::ThreadCreateParams::ToolResources, nil]
+        #     A set of resources that are made available to the assistant's tools in this
+        #     thread. The resources are specific to the type of tool. For example, the
+        #     `code_interpreter` tool requires a list of file IDs, while the `file_search`
+        #     tool requires a list of vector store IDs.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -89,16 +100,27 @@ module OpenAI
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
           # @!method initialize(content:, role:, attachments: nil, metadata: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::ThreadCreateParams::Message} for more details.
+          #   @param content [String, Array<OpenAI::Models::Beta::Threads::ImageFileContentBlock, OpenAI::Models::Beta::Threads::ImageURLContentBlock, OpenAI::Models::Beta::Threads::TextContentBlockParam>]
+          #     The text contents of the message.
           #
-          #   @param content [String, Array<OpenAI::Models::Beta::Threads::ImageFileContentBlock, OpenAI::Models::Beta::Threads::ImageURLContentBlock, OpenAI::Models::Beta::Threads::TextContentBlockParam>] The text contents of the message.
+          #   @param role [Symbol, OpenAI::Models::Beta::ThreadCreateParams::Message::Role]
+          #     The role of the entity that is creating the message. Allowed values include:
           #
-          #   @param role [Symbol, OpenAI::Models::Beta::ThreadCreateParams::Message::Role] The role of the entity that is creating the message. Allowed values include:
+          #     - `user`: Indicates the message is sent by an actual user and should be used in
+          #       most cases to represent user-generated messages.
+          #     - `assistant`: Indicates the message is generated by the assistant. Use this
+          #       value to insert messages from the assistant into the conversation.
           #
-          #   @param attachments [Array<OpenAI::Models::Beta::ThreadCreateParams::Message::Attachment>, nil] A list of files attached to the message, and the tools they should be added to.
+          #   @param attachments [Array<OpenAI::Models::Beta::ThreadCreateParams::Message::Attachment>, nil]
+          #     A list of files attached to the message, and the tools they should be added to.
           #
-          #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+          #   @param metadata [Hash{Symbol=>String}, 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.
 
           # The text contents of the message.
           #
@@ -109,7 +131,7 @@ module OpenAI
             # The text contents of the message.
             variant String
 
-            # An array of content parts with a defined type, each can be of type `text` or images can be passed with `image_url` or `image_file`. Image types are only supported on [Vision-compatible models](https://platform.openai.com/docs/models).
+            # An array of content parts with a defined type, each can be of type `text` or images can be passed with `image_url` or `image_file`. Image types are only supported on [Vision-compatible models](https://developers.openai.com/api/docs/models).
             variant -> { OpenAI::Models::Beta::ThreadCreateParams::Message::Content::MessageContentPartParamArray }
 
             # @!method self.variants
@@ -158,10 +180,11 @@ module OpenAI
             )
 
             # @!method initialize(file_id: nil, tools: nil)
-            #   @param file_id [String] The ID of the file to attach to the message.
+            #   @param file_id [String]
+            #     The ID of the file to attach to the message.
             #
-            #   @param tools [Array<OpenAI::Models::Beta::CodeInterpreterTool, OpenAI::Models::Beta::ThreadCreateParams::Message::Attachment::Tool::FileSearch>] The tools to add this file to.
-
+            #   @param tools [Array<OpenAI::Models::Beta::CodeInterpreterTool, OpenAI::Models::Beta::ThreadCreateParams::Message::Attachment::Tool::FileSearch>]
+            #     The tools to add this file to.
             module Tool
               extend OpenAI::Internal::Type::Union
 
@@ -179,7 +202,8 @@ module OpenAI
                 required :type, const: :file_search
 
                 # @!method initialize(type: :file_search)
-                #   @param type [Symbol, :file_search] The type of tool being defined: `file_search`
+                #   @param type [Symbol, :file_search]
+                #     The type of tool being defined: `file_search`
               end
 
               # @!method self.variants
@@ -211,26 +235,25 @@ module OpenAI
           # @see OpenAI::Models::Beta::ThreadCreateParams::ToolResources#code_interpreter
           class CodeInterpreter < OpenAI::Internal::Type::BaseModel
             # @!attribute file_ids
-            #   A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
-            #   available to the `code_interpreter` tool. There can be a maximum of 20 files
-            #   associated with the tool.
+            #   A list of [file](https://developers.openai.com/api/reference/resources/files)
+            #   IDs made available to the `code_interpreter` tool. There can be a maximum of 20
+            #   files associated with the tool.
             #
             #   @return [Array<String>, nil]
             optional :file_ids, OpenAI::Internal::Type::ArrayOf[String]
 
             # @!method initialize(file_ids: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::ThreadCreateParams::ToolResources::CodeInterpreter} for
-            #   more details.
-            #
-            #   @param file_ids [Array<String>] A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+            #   @param file_ids [Array<String>]
+            #     A list of [file](https://developers.openai.com/api/reference/resources/files)
+            #     IDs made available to the `code_interpreter` tool. There can be a maximum of 20
+            #     files associated with the tool.
           end
 
           # @see OpenAI::Models::Beta::ThreadCreateParams::ToolResources#file_search
           class FileSearch < OpenAI::Internal::Type::BaseModel
             # @!attribute vector_store_ids
             #   The
-            #   [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+            #   [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
             #   attached to this thread. There can be a maximum of 1 vector store attached to
             #   the thread.
             #
@@ -239,7 +262,7 @@ module OpenAI
 
             # @!attribute vector_stores
             #   A helper to create a
-            #   [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+            #   [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
             #   with file_ids and attach it to this thread. There can be a maximum of 1 vector
             #   store attached to the thread.
             #
@@ -254,14 +277,17 @@ module OpenAI
             )
 
             # @!method initialize(vector_store_ids: nil, vector_stores: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch} for more
-            #   details.
+            #   @param vector_store_ids [Array<String>]
+            #     The
+            #     [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+            #     attached to this thread. There can be a maximum of 1 vector store attached to
+            #     the thread.
             #
-            #   @param vector_store_ids [Array<String>] The [vector store](https://platform.openai.com/docs/api-reference/vector-stores/
-            #
-            #   @param vector_stores [Array<OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore>] A helper to create a [vector store](https://platform.openai.com/docs/api-referen
-
+            #   @param vector_stores [Array<OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore>]
+            #     A helper to create a
+            #     [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+            #     with file_ids and attach it to this thread. There can be a maximum of 1 vector
+            #     store attached to the thread.
             class VectorStore < OpenAI::Internal::Type::BaseModel
               # @!attribute chunking_strategy
               #   The chunking strategy used to chunk the file(s). If not set, will use the `auto`
@@ -276,10 +302,10 @@ module OpenAI
               )
 
               # @!attribute file_ids
-              #   A list of [file](https://platform.openai.com/docs/api-reference/files) IDs to
-              #   add to the vector store. For vector stores created before Nov 2025, there can be
-              #   a maximum of 10,000 files in a vector store. For vector stores created starting
-              #   in Nov 2025, the limit is 100,000,000 files.
+              #   A list of [file](https://developers.openai.com/api/reference/resources/files)
+              #   IDs to add to the vector store. For vector stores created before Nov 2025, there
+              #   can be a maximum of 10,000 files in a vector store. For vector stores created
+              #   starting in Nov 2025, the limit is 100,000,000 files.
               #
               #   @return [Array<String>, nil]
               optional :file_ids, OpenAI::Internal::Type::ArrayOf[String]
@@ -296,15 +322,23 @@ module OpenAI
               optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
               # @!method initialize(chunking_strategy: nil, file_ids: nil, metadata: nil)
-              #   Some parameter documentations has been truncated, see
-              #   {OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore}
-              #   for more details.
+              #   @param chunking_strategy [OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Auto, OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Static]
+              #     The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+              #     strategy.
               #
-              #   @param chunking_strategy [OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Auto, OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Static] The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+              #   @param file_ids [Array<String>]
+              #     A list of [file](https://developers.openai.com/api/reference/resources/files)
+              #     IDs to add to the vector store. For vector stores created before Nov 2025, there
+              #     can be a maximum of 10,000 files in a vector store. For vector stores created
+              #     starting in Nov 2025, the limit is 100,000,000 files.
               #
-              #   @param file_ids [Array<String>] A list of [file](https://platform.openai.com/docs/api-reference/files) IDs to ad
+              #   @param metadata [Hash{Symbol=>String}, 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.
               #
-              #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+              #     Keys are strings with a maximum length of 64 characters. Values are strings with
+              #     a maximum length of 512 characters.
 
               # The chunking strategy used to chunk the file(s). If not set, will use the `auto`
               # strategy.
@@ -341,7 +375,8 @@ module OpenAI
                   #   The default strategy. This strategy currently uses a `max_chunk_size_tokens` of
                   #   `800` and `chunk_overlap_tokens` of `400`.
                   #
-                  #   @param type [Symbol, :auto] Always `auto`.
+                  #   @param type [Symbol, :auto]
+                  #     Always `auto`.
                 end
 
                 class Static < OpenAI::Internal::Type::BaseModel
@@ -364,7 +399,8 @@ module OpenAI
                   # @!method initialize(static:, type: :static)
                   #   @param static [OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Static::Static]
                   #
-                  #   @param type [Symbol, :static] Always `static`.
+                  #   @param type [Symbol, :static]
+                  #     Always `static`.
 
                   # @see OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Static#static
                   class Static < OpenAI::Internal::Type::BaseModel
@@ -384,13 +420,14 @@ module OpenAI
                     required :max_chunk_size_tokens, Integer
 
                     # @!method initialize(chunk_overlap_tokens:, max_chunk_size_tokens:)
-                    #   Some parameter documentations has been truncated, see
-                    #   {OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Static::Static}
-                    #   for more details.
+                    #   @param chunk_overlap_tokens [Integer]
+                    #     The number of tokens that overlap between chunks. The default value is `400`.
                     #
-                    #   @param chunk_overlap_tokens [Integer] The number of tokens that overlap between chunks. The default value is `400`.
+                    #     Note that the overlap must not exceed half of `max_chunk_size_tokens`.
                     #
-                    #   @param max_chunk_size_tokens [Integer] The maximum number of tokens in each chunk. The default value is `800`. The mini
+                    #   @param max_chunk_size_tokens [Integer]
+                    #     The maximum number of tokens in each chunk. The default value is `800`. The
+                    #     minimum value is `100` and the maximum value is `4096`.
                   end
                 end
 

data/lib/openai/models/beta/thread_stream_event.rb

@@ -6,7 +6,7 @@ module OpenAI
       class ThreadStreamEvent < OpenAI::Internal::Type::BaseModel
         # @!attribute data
         #   Represents a thread that contains
-        #   [messages](https://platform.openai.com/docs/api-reference/messages).
+        #   [messages](https://developers.openai.com/api/docs/assistants/migration).
         #
         #   @return [OpenAI::Models::Beta::Thread]
         required :data, -> { OpenAI::Beta::Thread }
@@ -23,16 +23,16 @@ module OpenAI
         optional :enabled, OpenAI::Internal::Type::Boolean
 
         # @!method initialize(data:, enabled: nil, event: :"thread.created")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::ThreadStreamEvent} for more details.
-        #
         #   Occurs when a new
-        #   [thread](https://platform.openai.com/docs/api-reference/threads/object) is
+        #   [thread](https://developers.openai.com/api/docs/assistants/migration) is
         #   created.
         #
-        #   @param data [OpenAI::Models::Beta::Thread] Represents a thread that contains [messages](https://platform.openai.com/docs/ap
+        #   @param data [OpenAI::Models::Beta::Thread]
+        #     Represents a thread that contains
+        #     [messages](https://developers.openai.com/api/docs/assistants/migration).
         #
-        #   @param enabled [Boolean] Whether to enable input audio transcription.
+        #   @param enabled [Boolean]
+        #     Whether to enable input audio transcription.
         #
         #   @param event [Symbol, :"thread.created"]
       end

data/lib/openai/models/beta/thread_update_params.rb

@@ -34,14 +34,21 @@ module OpenAI
         optional :tool_resources, -> { OpenAI::Beta::ThreadUpdateParams::ToolResources }, nil?: true
 
         # @!method initialize(thread_id:, metadata: nil, tool_resources: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::ThreadUpdateParams} for more details.
-        #
         #   @param thread_id [String]
         #
-        #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #   @param metadata [Hash{Symbol=>String}, 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.
         #
-        #   @param tool_resources [OpenAI::Models::Beta::ThreadUpdateParams::ToolResources, nil] A set of resources that are made available to the assistant's tools in this thre
+        #   @param tool_resources [OpenAI::Models::Beta::ThreadUpdateParams::ToolResources, nil]
+        #     A set of resources that are made available to the assistant's tools in this
+        #     thread. The resources are specific to the type of tool. For example, the
+        #     `code_interpreter` tool requires a list of file IDs, while the `file_search`
+        #     tool requires a list of vector store IDs.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -68,26 +75,25 @@ module OpenAI
           # @see OpenAI::Models::Beta::ThreadUpdateParams::ToolResources#code_interpreter
           class CodeInterpreter < OpenAI::Internal::Type::BaseModel
             # @!attribute file_ids
-            #   A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
-            #   available to the `code_interpreter` tool. There can be a maximum of 20 files
-            #   associated with the tool.
+            #   A list of [file](https://developers.openai.com/api/reference/resources/files)
+            #   IDs made available to the `code_interpreter` tool. There can be a maximum of 20
+            #   files associated with the tool.
             #
             #   @return [Array<String>, nil]
             optional :file_ids, OpenAI::Internal::Type::ArrayOf[String]
 
             # @!method initialize(file_ids: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::ThreadUpdateParams::ToolResources::CodeInterpreter} for
-            #   more details.
-            #
-            #   @param file_ids [Array<String>] A list of [file](https://platform.openai.com/docs/api-reference/files) IDs made
+            #   @param file_ids [Array<String>]
+            #     A list of [file](https://developers.openai.com/api/reference/resources/files)
+            #     IDs made available to the `code_interpreter` tool. There can be a maximum of 20
+            #     files associated with the tool.
           end
 
           # @see OpenAI::Models::Beta::ThreadUpdateParams::ToolResources#file_search
           class FileSearch < OpenAI::Internal::Type::BaseModel
             # @!attribute vector_store_ids
             #   The
-            #   [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+            #   [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
             #   attached to this thread. There can be a maximum of 1 vector store attached to
             #   the thread.
             #
@@ -95,11 +101,11 @@ module OpenAI
             optional :vector_store_ids, OpenAI::Internal::Type::ArrayOf[String]
 
             # @!method initialize(vector_store_ids: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::ThreadUpdateParams::ToolResources::FileSearch} for more
-            #   details.
-            #
-            #   @param vector_store_ids [Array<String>] The [vector store](https://platform.openai.com/docs/api-reference/vector-stores/
+            #   @param vector_store_ids [Array<String>]
+            #     The
+            #     [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+            #     attached to this thread. There can be a maximum of 1 vector store attached to
+            #     the thread.
           end
         end
       end

data/lib/openai/models/beta/threads/file_citation_annotation.rb

@@ -43,9 +43,11 @@ module OpenAI
           #
           #   @param start_index [Integer]
           #
-          #   @param text [String] The text in the message content that needs to be replaced.
+          #   @param text [String]
+          #     The text in the message content that needs to be replaced.
           #
-          #   @param type [Symbol, :file_citation] Always `file_citation`.
+          #   @param type [Symbol, :file_citation]
+          #     Always `file_citation`.
 
           # @see OpenAI::Models::Beta::Threads::FileCitationAnnotation#file_citation
           class FileCitation < OpenAI::Internal::Type::BaseModel
@@ -56,7 +58,8 @@ module OpenAI
             required :file_id, String
 
             # @!method initialize(file_id:)
-            #   @param file_id [String] The ID of the specific File the citation is from.
+            #   @param file_id [String]
+            #     The ID of the specific File the citation is from.
           end
         end
       end

data/lib/openai/models/beta/threads/file_citation_delta_annotation.rb

@@ -43,7 +43,8 @@ module OpenAI
           #   File associated with the assistant or the message. Generated when the assistant
           #   uses the "file_search" tool to search files.
           #
-          #   @param index [Integer] The index of the annotation in the text content part.
+          #   @param index [Integer]
+          #     The index of the annotation in the text content part.
           #
           #   @param end_index [Integer]
           #
@@ -51,9 +52,11 @@ module OpenAI
           #
           #   @param start_index [Integer]
           #
-          #   @param text [String] The text in the message content that needs to be replaced.
+          #   @param text [String]
+          #     The text in the message content that needs to be replaced.
           #
-          #   @param type [Symbol, :file_citation] Always `file_citation`.
+          #   @param type [Symbol, :file_citation]
+          #     Always `file_citation`.
 
           # @see OpenAI::Models::Beta::Threads::FileCitationDeltaAnnotation#file_citation
           class FileCitation < OpenAI::Internal::Type::BaseModel
@@ -70,9 +73,11 @@ module OpenAI
             optional :quote, String
 
             # @!method initialize(file_id: nil, quote: nil)
-            #   @param file_id [String] The ID of the specific File the citation is from.
+            #   @param file_id [String]
+            #     The ID of the specific File the citation is from.
             #
-            #   @param quote [String] The specific quote in the file.
+            #   @param quote [String]
+            #     The specific quote in the file.
           end
         end
       end

data/lib/openai/models/beta/threads/file_path_annotation.rb

@@ -42,9 +42,11 @@ module OpenAI
           #
           #   @param start_index [Integer]
           #
-          #   @param text [String] The text in the message content that needs to be replaced.
+          #   @param text [String]
+          #     The text in the message content that needs to be replaced.
           #
-          #   @param type [Symbol, :file_path] Always `file_path`.
+          #   @param type [Symbol, :file_path]
+          #     Always `file_path`.
 
           # @see OpenAI::Models::Beta::Threads::FilePathAnnotation#file_path
           class FilePath < OpenAI::Internal::Type::BaseModel
@@ -55,7 +57,8 @@ module OpenAI
             required :file_id, String
 
             # @!method initialize(file_id:)
-            #   @param file_id [String] The ID of the file that was generated.
+            #   @param file_id [String]
+            #     The ID of the file that was generated.
           end
         end
       end

data/lib/openai/models/beta/threads/file_path_delta_annotation.rb

@@ -42,7 +42,8 @@ module OpenAI
           #   A URL for the file that's generated when the assistant used the
           #   `code_interpreter` tool to generate a file.
           #
-          #   @param index [Integer] The index of the annotation in the text content part.
+          #   @param index [Integer]
+          #     The index of the annotation in the text content part.
           #
           #   @param end_index [Integer]
           #
@@ -50,9 +51,11 @@ module OpenAI
           #
           #   @param start_index [Integer]
           #
-          #   @param text [String] The text in the message content that needs to be replaced.
+          #   @param text [String]
+          #     The text in the message content that needs to be replaced.
           #
-          #   @param type [Symbol, :file_path] Always `file_path`.
+          #   @param type [Symbol, :file_path]
+          #     Always `file_path`.
 
           # @see OpenAI::Models::Beta::Threads::FilePathDeltaAnnotation#file_path
           class FilePath < OpenAI::Internal::Type::BaseModel
@@ -63,7 +66,8 @@ module OpenAI
             optional :file_id, String
 
             # @!method initialize(file_id: nil)
-            #   @param file_id [String] The ID of the file that was generated.
+            #   @param file_id [String]
+            #     The ID of the file that was generated.
           end
         end
       end

data/lib/openai/models/beta/threads/image_file.rb

@@ -6,9 +6,9 @@ module OpenAI
       module Threads
         class ImageFile < OpenAI::Internal::Type::BaseModel
           # @!attribute file_id
-          #   The [File](https://platform.openai.com/docs/api-reference/files) ID of the image
-          #   in the message content. Set `purpose="vision"` when uploading the File if you
-          #   need to later display the file content.
+          #   The [File](https://developers.openai.com/api/reference/resources/files) ID of
+          #   the image in the message content. Set `purpose="vision"` when uploading the File
+          #   if you need to later display the file content.
           #
           #   @return [String]
           required :file_id, String
@@ -21,12 +21,14 @@ module OpenAI
           optional :detail, enum: -> { OpenAI::Beta::Threads::ImageFile::Detail }
 
           # @!method initialize(file_id:, detail: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::Threads::ImageFile} for more details.
+          #   @param file_id [String]
+          #     The [File](https://developers.openai.com/api/reference/resources/files) ID of
+          #     the image in the message content. Set `purpose="vision"` when uploading the File
+          #     if you need to later display the file content.
           #
-          #   @param file_id [String] The [File](https://platform.openai.com/docs/api-reference/files) ID of the image
-          #
-          #   @param detail [Symbol, OpenAI::Models::Beta::Threads::ImageFile::Detail] Specifies the detail level of the image if specified by the user. `low` uses few
+          #   @param detail [Symbol, OpenAI::Models::Beta::Threads::ImageFile::Detail]
+          #     Specifies the detail level of the image if specified by the user. `low` uses
+          #     fewer tokens, you can opt in to high resolution using `high`.
 
           # Specifies the detail level of the image if specified by the user. `low` uses
           # fewer tokens, you can opt in to high resolution using `high`.

data/lib/openai/models/beta/threads/image_file_content_block.rb

@@ -17,12 +17,14 @@ module OpenAI
           required :type, const: :image_file
 
           # @!method initialize(image_file:, type: :image_file)
-          #   References an image [File](https://platform.openai.com/docs/api-reference/files)
-          #   in the content of a message.
+          #   References an image
+          #   [File](https://developers.openai.com/api/reference/resources/files) in the
+          #   content of a message.
           #
           #   @param image_file [OpenAI::Models::Beta::Threads::ImageFile]
           #
-          #   @param type [Symbol, :image_file] Always `image_file`.
+          #   @param type [Symbol, :image_file]
+          #     Always `image_file`.
         end
       end
     end

data/lib/openai/models/beta/threads/image_file_delta.rb

@@ -13,20 +13,22 @@ module OpenAI
           optional :detail, enum: -> { OpenAI::Beta::Threads::ImageFileDelta::Detail }
 
           # @!attribute file_id
-          #   The [File](https://platform.openai.com/docs/api-reference/files) ID of the image
-          #   in the message content. Set `purpose="vision"` when uploading the File if you
-          #   need to later display the file content.
+          #   The [File](https://developers.openai.com/api/reference/resources/files) ID of
+          #   the image in the message content. Set `purpose="vision"` when uploading the File
+          #   if you need to later display the file content.
           #
           #   @return [String, nil]
           optional :file_id, String
 
           # @!method initialize(detail: nil, file_id: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::Threads::ImageFileDelta} for more details.
+          #   @param detail [Symbol, OpenAI::Models::Beta::Threads::ImageFileDelta::Detail]
+          #     Specifies the detail level of the image if specified by the user. `low` uses
+          #     fewer tokens, you can opt in to high resolution using `high`.
           #
-          #   @param detail [Symbol, OpenAI::Models::Beta::Threads::ImageFileDelta::Detail] Specifies the detail level of the image if specified by the user. `low` uses few
-          #
-          #   @param file_id [String] The [File](https://platform.openai.com/docs/api-reference/files) ID of the image
+          #   @param file_id [String]
+          #     The [File](https://developers.openai.com/api/reference/resources/files) ID of
+          #     the image in the message content. Set `purpose="vision"` when uploading the File
+          #     if you need to later display the file content.
 
           # Specifies the detail level of the image if specified by the user. `low` uses
           # fewer tokens, you can opt in to high resolution using `high`.

data/lib/openai/models/beta/threads/image_file_delta_block.rb

@@ -23,14 +23,17 @@ module OpenAI
           optional :image_file, -> { OpenAI::Beta::Threads::ImageFileDelta }
 
           # @!method initialize(index:, image_file: nil, type: :image_file)
-          #   References an image [File](https://platform.openai.com/docs/api-reference/files)
-          #   in the content of a message.
+          #   References an image
+          #   [File](https://developers.openai.com/api/reference/resources/files) in the
+          #   content of a message.
           #
-          #   @param index [Integer] The index of the content part in the message.
+          #   @param index [Integer]
+          #     The index of the content part in the message.
           #
           #   @param image_file [OpenAI::Models::Beta::Threads::ImageFileDelta]
           #
-          #   @param type [Symbol, :image_file] Always `image_file`.
+          #   @param type [Symbol, :image_file]
+          #     Always `image_file`.
         end
       end
     end

data/lib/openai/models/beta/threads/image_url.rb

@@ -20,12 +20,13 @@ module OpenAI
           optional :detail, enum: -> { OpenAI::Beta::Threads::ImageURL::Detail }
 
           # @!method initialize(url:, detail: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::Threads::ImageURL} for more details.
+          #   @param url [String]
+          #     The external URL of the image, must be a supported image types: jpeg, jpg, png,
+          #     gif, webp.
           #
-          #   @param url [String] The external URL of the image, must be a supported image types: jpeg, jpg, png,
-          #
-          #   @param detail [Symbol, OpenAI::Models::Beta::Threads::ImageURL::Detail] Specifies the detail level of the image. `low` uses fewer tokens, you can opt in
+          #   @param detail [Symbol, OpenAI::Models::Beta::Threads::ImageURL::Detail]
+          #     Specifies the detail level of the image. `low` uses fewer tokens, you can opt in
+          #     to high resolution using `high`. Default value is `auto`
 
           # Specifies the detail level of the image. `low` uses fewer tokens, you can opt in
           # to high resolution using `high`. Default value is `auto`