openai 0.92.0 → 0.94.0

data/sig/openai/models/beta/thread_create_params.rbs

@@ -13,16 +13,48 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # A list of
+        # [messages](https://developers.openai.com/api/docs/assistants/migration) to start
+        # the thread with.
         attr_reader messages: ::Array[OpenAI::Beta::ThreadCreateParams::Message]?
 
+        # A list of
+        # [messages](https://developers.openai.com/api/docs/assistants/migration) to start
+        # the thread with.
         def messages=: (
           ::Array[OpenAI::Beta::ThreadCreateParams::Message]
         ) -> ::Array[OpenAI::Beta::ThreadCreateParams::Message]
 
+        # 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.
         attr_accessor metadata: OpenAI::Models::metadata?
 
+        # 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.
         attr_accessor tool_resources: OpenAI::Beta::ThreadCreateParams::ToolResources?
 
+        # @param messages
+        #   A list of
+        #   [messages](https://developers.openai.com/api/docs/assistants/migration) to start
+        #   the thread with.
+        # @param metadata
+        #   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
+        #   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.
         def initialize: (
           ?messages: ::Array[OpenAI::Beta::ThreadCreateParams::Message],
           ?metadata: OpenAI::Models::metadata?,
@@ -46,14 +78,46 @@ module OpenAI
           }
 
         class Message < OpenAI::Internal::Type::BaseModel
+          # The text contents of the message.
           attr_accessor content: OpenAI::Models::Beta::ThreadCreateParams::Message::content
 
+          # 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.
           attr_accessor role: OpenAI::Models::Beta::ThreadCreateParams::Message::role
 
+          # A list of files attached to the message, and the tools they should be added to.
           attr_accessor attachments: ::Array[OpenAI::Beta::ThreadCreateParams::Message::Attachment]?
 
+          # 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.
           attr_accessor metadata: OpenAI::Models::metadata?
 
+          # @param content
+          #   The text contents of the message.
+          # @param 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
+          #   A list of files attached to the message, and the tools they should be added to.
+          # @param metadata
+          #   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.
           def initialize: (
             content: OpenAI::Models::Beta::ThreadCreateParams::Message::content,
             role: OpenAI::Models::Beta::ThreadCreateParams::Message::role,
@@ -98,16 +162,24 @@ module OpenAI
             }
 
           class Attachment < OpenAI::Internal::Type::BaseModel
+            # The ID of the file to attach to the message.
             attr_reader file_id: String?
 
+            # The ID of the file to attach to the message.
             def file_id=: (String) -> String
 
+            # The tools to add this file to.
             attr_reader tools: ::Array[OpenAI::Models::Beta::ThreadCreateParams::Message::Attachment::tool]?
 
+            # The tools to add this file to.
             def tools=: (
               ::Array[OpenAI::Models::Beta::ThreadCreateParams::Message::Attachment::tool]
             ) -> ::Array[OpenAI::Models::Beta::ThreadCreateParams::Message::Attachment::tool]
 
+            # @param file_id
+            #   The ID of the file to attach to the message.
+            # @param tools
+            #   The tools to add this file to.
             def initialize: (
               ?file_id: String,
               ?tools: ::Array[OpenAI::Models::Beta::ThreadCreateParams::Message::Attachment::tool]
@@ -128,8 +200,11 @@ module OpenAI
               type file_search = { ?type: :file_search }
 
               class FileSearch < OpenAI::Internal::Type::BaseModel
+                # The type of tool being defined: `file_search`
                 attr_accessor type: :file_search
 
+                # @param type
+                #   The type of tool being defined: `file_search`
                 def initialize: (?type: :file_search) -> void
 
                 def to_hash: -> { ?type: :file_search }
@@ -172,10 +247,20 @@ module OpenAI
           type code_interpreter = { ?file_ids: ::Array[String] }
 
           class CodeInterpreter < OpenAI::Internal::Type::BaseModel
+            # 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.
             attr_reader 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.
             def file_ids=: (::Array[String]) -> ::Array[String]
 
+            # @param file_ids
+            #   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.
             def initialize: (?file_ids: ::Array[String]) -> void
 
             def to_hash: -> { ?file_ids: ::Array[String] }
@@ -188,16 +273,42 @@ module OpenAI
             }
 
           class FileSearch < OpenAI::Internal::Type::BaseModel
+            # 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.
             attr_reader 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.
             def vector_store_ids=: (::Array[String]) -> ::Array[String]
 
+            # 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.
             attr_reader vector_stores: ::Array[OpenAI::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.
             def vector_stores=: (
               ::Array[OpenAI::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore]
             ) -> ::Array[OpenAI::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore]
 
+            # @param vector_store_ids
+            #   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_stores
+            #   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.
             def initialize: (
               ?vector_store_ids: ::Array[String],
               ?vector_stores: ::Array[OpenAI::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore]
@@ -216,18 +327,51 @@ module OpenAI
               }
 
             class VectorStore < OpenAI::Internal::Type::BaseModel
+              # The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+              # strategy.
               attr_reader chunking_strategy: OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::chunking_strategy?
 
+              # The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+              # strategy.
               def chunking_strategy=: (
                 OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::chunking_strategy
               ) -> OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::chunking_strategy
 
+              # 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.
               attr_reader 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.
               def file_ids=: (::Array[String]) -> ::Array[String]
 
+              # 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.
               attr_accessor metadata: OpenAI::Models::metadata?
 
+              # @param chunking_strategy
+              #   The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+              #   strategy.
+              # @param file_ids
+              #   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 metadata
+              #   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.
               def initialize: (
                 ?chunking_strategy: OpenAI::Models::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::chunking_strategy,
                 ?file_ids: ::Array[String],
@@ -250,8 +394,11 @@ module OpenAI
                 type auto = { ?type: :auto }
 
                 class Auto < OpenAI::Internal::Type::BaseModel
+                  # Always `auto`.
                   attr_accessor type: :auto
 
+                  # @param type
+                  #   Always `auto`.
                   def initialize: (?type: :auto) -> void
 
                   def to_hash: -> { ?type: :auto }
@@ -266,8 +413,11 @@ module OpenAI
                 class Static < OpenAI::Internal::Type::BaseModel
                   attr_accessor static: OpenAI::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Static::Static
 
+                  # Always `static`.
                   attr_accessor type: :static
 
+                  # @param type
+                  #   Always `static`.
                   def initialize: (
                     static: OpenAI::Beta::ThreadCreateParams::ToolResources::FileSearch::VectorStore::ChunkingStrategy::Static::Static,
                     ?type: :static
@@ -285,10 +435,22 @@ module OpenAI
                     }
 
                   class Static < OpenAI::Internal::Type::BaseModel
+                    # 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`.
                     attr_accessor chunk_overlap_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`.
                     attr_accessor max_chunk_size_tokens: Integer
 
+                    # @param chunk_overlap_tokens
+                    #   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
+                    #   The maximum number of tokens in each chunk. The default value is `800`. The
+                    #   minimum value is `100` and the maximum value is `4096`.
                     def initialize: (
                       chunk_overlap_tokens: Integer,
                       max_chunk_size_tokens: Integer

data/sig/openai/models/beta/thread_stream_event.rbs

@@ -9,14 +9,23 @@ module OpenAI
         }
 
       class ThreadStreamEvent < OpenAI::Internal::Type::BaseModel
+        # Represents a thread that contains
+        # [messages](https://developers.openai.com/api/docs/assistants/migration).
         attr_accessor data: OpenAI::Beta::Thread
 
         attr_accessor event: :"thread.created"
 
+        # Whether to enable input audio transcription.
         attr_reader enabled: bool?
 
+        # Whether to enable input audio transcription.
         def enabled=: (bool) -> bool
 
+        # @param data
+        #   Represents a thread that contains
+        #   [messages](https://developers.openai.com/api/docs/assistants/migration).
+        # @param enabled
+        #   Whether to enable input audio transcription.
         def initialize: (
           data: OpenAI::Beta::Thread,
           ?enabled: bool,

data/sig/openai/models/beta/thread_update_params.rbs

@@ -15,10 +15,32 @@ module OpenAI
 
         attr_accessor thread_id: String
 
+        # 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.
         attr_accessor metadata: OpenAI::Models::metadata?
 
+        # 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.
         attr_accessor tool_resources: OpenAI::Beta::ThreadUpdateParams::ToolResources?
 
+        # @param metadata
+        #   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
+        #   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.
         def initialize: (
           thread_id: String,
           ?metadata: OpenAI::Models::metadata?,
@@ -65,10 +87,20 @@ module OpenAI
           type code_interpreter = { ?file_ids: ::Array[String] }
 
           class CodeInterpreter < OpenAI::Internal::Type::BaseModel
+            # 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.
             attr_reader 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.
             def file_ids=: (::Array[String]) -> ::Array[String]
 
+            # @param file_ids
+            #   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.
             def initialize: (?file_ids: ::Array[String]) -> void
 
             def to_hash: -> { ?file_ids: ::Array[String] }
@@ -77,10 +109,23 @@ module OpenAI
           type file_search = { ?vector_store_ids: ::Array[String] }
 
           class FileSearch < OpenAI::Internal::Type::BaseModel
+            # 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.
             attr_reader 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.
             def vector_store_ids=: (::Array[String]) -> ::Array[String]
 
+            # @param vector_store_ids
+            #   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.
             def initialize: (?vector_store_ids: ::Array[String]) -> void
 
             def to_hash: -> { ?vector_store_ids: ::Array[String] }

data/sig/openai/models/beta/threads/file_citation_annotation.rbs

@@ -18,10 +18,16 @@ module OpenAI
 
           attr_accessor start_index: Integer
 
+          # The text in the message content that needs to be replaced.
           attr_accessor text: String
 
+          # Always `file_citation`.
           attr_accessor type: :file_citation
 
+          # @param text
+          #   The text in the message content that needs to be replaced.
+          # @param type
+          #   Always `file_citation`.
           def initialize: (
             end_index: Integer,
             file_citation: OpenAI::Beta::Threads::FileCitationAnnotation::FileCitation,
@@ -41,8 +47,11 @@ module OpenAI
           type file_citation = { file_id: String }
 
           class FileCitation < OpenAI::Internal::Type::BaseModel
+            # The ID of the specific File the citation is from.
             attr_accessor file_id: String
 
+            # @param file_id
+            #   The ID of the specific File the citation is from.
             def initialize: (file_id: String) -> void
 
             def to_hash: -> { file_id: String }

data/sig/openai/models/beta/threads/file_citation_delta_annotation.rbs

@@ -13,8 +13,10 @@ module OpenAI
           }
 
         class FileCitationDeltaAnnotation < OpenAI::Internal::Type::BaseModel
+          # The index of the annotation in the text content part.
           attr_accessor index: Integer
 
+          # Always `file_citation`.
           attr_accessor type: :file_citation
 
           attr_reader end_index: Integer?
@@ -31,10 +33,18 @@ module OpenAI
 
           def start_index=: (Integer) -> Integer
 
+          # The text in the message content that needs to be replaced.
           attr_reader text: String?
 
+          # The text in the message content that needs to be replaced.
           def text=: (String) -> String
 
+          # @param index
+          #   The index of the annotation in the text content part.
+          # @param text
+          #   The text in the message content that needs to be replaced.
+          # @param type
+          #   Always `file_citation`.
           def initialize: (
             index: Integer,
             ?end_index: Integer,
@@ -56,14 +66,22 @@ module OpenAI
           type file_citation = { ?file_id: String, ?quote: String }
 
           class FileCitation < OpenAI::Internal::Type::BaseModel
+            # The ID of the specific File the citation is from.
             attr_reader file_id: String?
 
+            # The ID of the specific File the citation is from.
             def file_id=: (String) -> String
 
+            # The specific quote in the file.
             attr_reader quote: String?
 
+            # The specific quote in the file.
             def quote=: (String) -> String
 
+            # @param file_id
+            #   The ID of the specific File the citation is from.
+            # @param quote
+            #   The specific quote in the file.
             def initialize: (?file_id: String, ?quote: String) -> void
 
             def to_hash: -> { ?file_id: String, ?quote: String }

data/sig/openai/models/beta/threads/file_path_annotation.rbs

@@ -18,10 +18,16 @@ module OpenAI
 
           attr_accessor start_index: Integer
 
+          # The text in the message content that needs to be replaced.
           attr_accessor text: String
 
+          # Always `file_path`.
           attr_accessor type: :file_path
 
+          # @param text
+          #   The text in the message content that needs to be replaced.
+          # @param type
+          #   Always `file_path`.
           def initialize: (
             end_index: Integer,
             file_path: OpenAI::Beta::Threads::FilePathAnnotation::FilePath,
@@ -41,8 +47,11 @@ module OpenAI
           type file_path = { file_id: String }
 
           class FilePath < OpenAI::Internal::Type::BaseModel
+            # The ID of the file that was generated.
             attr_accessor file_id: String
 
+            # @param file_id
+            #   The ID of the file that was generated.
             def initialize: (file_id: String) -> void
 
             def to_hash: -> { file_id: String }

data/sig/openai/models/beta/threads/file_path_delta_annotation.rbs

@@ -13,8 +13,10 @@ module OpenAI
           }
 
         class FilePathDeltaAnnotation < OpenAI::Internal::Type::BaseModel
+          # The index of the annotation in the text content part.
           attr_accessor index: Integer
 
+          # Always `file_path`.
           attr_accessor type: :file_path
 
           attr_reader end_index: Integer?
@@ -31,10 +33,18 @@ module OpenAI
 
           def start_index=: (Integer) -> Integer
 
+          # The text in the message content that needs to be replaced.
           attr_reader text: String?
 
+          # The text in the message content that needs to be replaced.
           def text=: (String) -> String
 
+          # @param index
+          #   The index of the annotation in the text content part.
+          # @param text
+          #   The text in the message content that needs to be replaced.
+          # @param type
+          #   Always `file_path`.
           def initialize: (
             index: Integer,
             ?end_index: Integer,
@@ -56,10 +66,14 @@ module OpenAI
           type file_path = { ?file_id: String }
 
           class FilePath < OpenAI::Internal::Type::BaseModel
+            # The ID of the file that was generated.
             attr_reader file_id: String?
 
+            # The ID of the file that was generated.
             def file_id=: (String) -> String
 
+            # @param file_id
+            #   The ID of the file that was generated.
             def initialize: (?file_id: String) -> void
 
             def to_hash: -> { ?file_id: String }

data/sig/openai/models/beta/threads/image_file.rbs

@@ -9,14 +9,28 @@ module OpenAI
           }
 
         class ImageFile < OpenAI::Internal::Type::BaseModel
+          # 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.
           attr_accessor file_id: String
 
+          # 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`.
           attr_reader detail: 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`.
           def detail=: (
             OpenAI::Models::Beta::Threads::ImageFile::detail
           ) -> OpenAI::Models::Beta::Threads::ImageFile::detail
 
+          # @param file_id
+          #   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 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`.
           def initialize: (
             file_id: String,
             ?detail: OpenAI::Models::Beta::Threads::ImageFile::detail

data/sig/openai/models/beta/threads/image_file_content_block.rbs

@@ -8,8 +8,11 @@ module OpenAI
         class ImageFileContentBlock < OpenAI::Internal::Type::BaseModel
           attr_accessor image_file: OpenAI::Beta::Threads::ImageFile
 
+          # Always `image_file`.
           attr_accessor type: :image_file
 
+          # @param type
+          #   Always `image_file`.
           def initialize: (
             image_file: OpenAI::Beta::Threads::ImageFile,
             ?type: :image_file

data/sig/openai/models/beta/threads/image_file_delta.rbs

@@ -9,16 +9,33 @@ module OpenAI
           }
 
         class ImageFileDelta < OpenAI::Internal::Type::BaseModel
+          # 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`.
           attr_reader detail: 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`.
           def detail=: (
             OpenAI::Models::Beta::Threads::ImageFileDelta::detail
           ) -> OpenAI::Models::Beta::Threads::ImageFileDelta::detail
 
+          # 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.
           attr_reader 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.
           def file_id=: (String) -> String
 
+          # @param 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 file_id
+          #   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.
           def initialize: (
             ?detail: OpenAI::Models::Beta::Threads::ImageFileDelta::detail,
             ?file_id: String

data/sig/openai/models/beta/threads/image_file_delta_block.rbs

@@ -10,8 +10,10 @@ module OpenAI
           }
 
         class ImageFileDeltaBlock < OpenAI::Internal::Type::BaseModel
+          # The index of the content part in the message.
           attr_accessor index: Integer
 
+          # Always `image_file`.
           attr_accessor type: :image_file
 
           attr_reader image_file: OpenAI::Beta::Threads::ImageFileDelta?
@@ -20,6 +22,10 @@ module OpenAI
             OpenAI::Beta::Threads::ImageFileDelta
           ) -> OpenAI::Beta::Threads::ImageFileDelta
 
+          # @param index
+          #   The index of the content part in the message.
+          # @param type
+          #   Always `image_file`.
           def initialize: (
             index: Integer,
             ?image_file: OpenAI::Beta::Threads::ImageFileDelta,