openai 0.91.0 → 0.93.0

data/sig/openai/models/chat/completion_list_params.rbs

@@ -15,26 +15,52 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # Identifier for the last chat completion from the previous pagination request.
         attr_reader after: String?
 
+        # Identifier for the last chat completion from the previous pagination request.
         def after=: (String) -> String
 
+        # Number of Chat Completions to retrieve.
         attr_reader limit: Integer?
 
+        # Number of Chat Completions to retrieve.
         def limit=: (Integer) -> Integer
 
+        # A list of metadata keys to filter the Chat Completions by. Example:
+        #
+        # `metadata[key1]=value1&metadata[key2]=value2`
         attr_accessor metadata: OpenAI::Models::metadata?
 
+        # The model used to generate the Chat Completions.
         attr_reader model: String?
 
+        # The model used to generate the Chat Completions.
         def model=: (String) -> String
 
+        # Sort order for Chat Completions by timestamp. Use `asc` for ascending order or
+        # `desc` for descending order. Defaults to `asc`.
         attr_reader order: OpenAI::Models::Chat::CompletionListParams::order?
 
+        # Sort order for Chat Completions by timestamp. Use `asc` for ascending order or
+        # `desc` for descending order. Defaults to `asc`.
         def order=: (
           OpenAI::Models::Chat::CompletionListParams::order
         ) -> OpenAI::Models::Chat::CompletionListParams::order
 
+        # @param after
+        #   Identifier for the last chat completion from the previous pagination request.
+        # @param limit
+        #   Number of Chat Completions to retrieve.
+        # @param metadata
+        #   A list of metadata keys to filter the Chat Completions by. Example:
+        #
+        #   `metadata[key1]=value1&metadata[key2]=value2`
+        # @param model
+        #   The model used to generate the Chat Completions.
+        # @param order
+        #   Sort order for Chat Completions by timestamp. Use `asc` for ascending order or
+        #   `desc` for descending order. Defaults to `asc`.
         def initialize: (
           ?after: String,
           ?limit: Integer,

data/sig/openai/models/chat/completion_update_params.rbs

@@ -14,8 +14,21 @@ module OpenAI
 
         attr_accessor completion_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?
 
+        # @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: (
           completion_id: String,
           metadata: OpenAI::Models::metadata?,

data/sig/openai/models/chat/completions/message_list_params.rbs

@@ -17,20 +17,35 @@ module OpenAI
 
           attr_accessor completion_id: String
 
+          # Identifier for the last message from the previous pagination request.
           attr_reader after: String?
 
+          # Identifier for the last message from the previous pagination request.
           def after=: (String) -> String
 
+          # Number of messages to retrieve.
           attr_reader limit: Integer?
 
+          # Number of messages to retrieve.
           def limit=: (Integer) -> Integer
 
+          # Sort order for messages by timestamp. Use `asc` for ascending order or `desc`
+          # for descending order. Defaults to `asc`.
           attr_reader order: OpenAI::Models::Chat::Completions::MessageListParams::order?
 
+          # Sort order for messages by timestamp. Use `asc` for ascending order or `desc`
+          # for descending order. Defaults to `asc`.
           def order=: (
             OpenAI::Models::Chat::Completions::MessageListParams::order
           ) -> OpenAI::Models::Chat::Completions::MessageListParams::order
 
+          # @param after
+          #   Identifier for the last message from the previous pagination request.
+          # @param limit
+          #   Number of messages to retrieve.
+          # @param order
+          #   Sort order for messages by timestamp. Use `asc` for ascending order or `desc`
+          #   for descending order. Defaults to `asc`.
           def initialize: (
             completion_id: String,
             ?after: String,

data/sig/openai/models/chat_model.rbs

@@ -21,6 +21,7 @@ module OpenAI
       | :"gpt-5.1"
       | :"gpt-5.1-2025-11-13"
       | :"gpt-5.1-codex"
+      | :"gpt-5.1-mini"
       | :"gpt-5.1-chat-latest"
       | :"gpt-5"
       | :"gpt-5-mini"
@@ -86,7 +87,6 @@ module OpenAI
       | :"gpt-3.5-turbo-1106"
       | :"gpt-3.5-turbo-0125"
       | :"gpt-3.5-turbo-16k-0613"
-      | :"gpt-5.1-mini"
 
     module ChatModel
       extend OpenAI::Internal::Type::Enum
@@ -111,6 +111,7 @@ module OpenAI
       GPT_5_1: :"gpt-5.1"
       GPT_5_1_2025_11_13: :"gpt-5.1-2025-11-13"
       GPT_5_1_CODEX: :"gpt-5.1-codex"
+      GPT_5_1_MINI: :"gpt-5.1-mini"
       GPT_5_1_CHAT_LATEST: :"gpt-5.1-chat-latest"
       GPT_5: :"gpt-5"
       GPT_5_MINI: :"gpt-5-mini"
@@ -176,7 +177,6 @@ module OpenAI
       GPT_3_5_TURBO_1106: :"gpt-3.5-turbo-1106"
       GPT_3_5_TURBO_0125: :"gpt-3.5-turbo-0125"
       GPT_3_5_TURBO_16K_0613: :"gpt-3.5-turbo-16k-0613"
-      GPT_5_1_MINI: :"gpt-5.1-mini"
 
       def self?.values: -> ::Array[OpenAI::Models::chat_model]
     end

data/sig/openai/models/comparison_filter.rbs

@@ -8,12 +8,43 @@ module OpenAI
       }
 
     class ComparisonFilter < OpenAI::Internal::Type::BaseModel
+      # The key to compare against the value.
       attr_accessor key: String
 
+      # Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`,
+      # `nin`.
+      #
+      # - `eq`: equals
+      # - `ne`: not equal
+      # - `gt`: greater than
+      # - `gte`: greater than or equal
+      # - `lt`: less than
+      # - `lte`: less than or equal
+      # - `in`: in
+      # - `nin`: not in
       attr_accessor type: OpenAI::Models::ComparisonFilter::type_
 
+      # The value to compare against the attribute key; supports string, number, or
+      # boolean types.
       attr_accessor value: OpenAI::Models::ComparisonFilter::value
 
+      # @param key
+      #   The key to compare against the value.
+      # @param type
+      #   Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`,
+      #   `nin`.
+      #
+      #   - `eq`: equals
+      #   - `ne`: not equal
+      #   - `gt`: greater than
+      #   - `gte`: greater than or equal
+      #   - `lt`: less than
+      #   - `lte`: less than or equal
+      #   - `in`: in
+      #   - `nin`: not in
+      # @param value
+      #   The value to compare against the attribute key; supports string, number, or
+      #   boolean types.
       def initialize: (
         key: String,
         type: OpenAI::Models::ComparisonFilter::type_,

data/sig/openai/models/completion.rbs

@@ -12,24 +12,56 @@ module OpenAI
       }
 
     class Completion < OpenAI::Internal::Type::BaseModel
+      # A unique identifier for the completion.
       attr_accessor id: String
 
+      # The list of completion choices the model generated for the input prompt.
       attr_accessor choices: ::Array[OpenAI::CompletionChoice]
 
+      # The Unix timestamp (in seconds) of when the completion was created.
       attr_accessor created: Integer
 
+      # The model used for completion.
       attr_accessor model: String
 
+      # The object type, which is always "text_completion"
       attr_accessor object: :text_completion
 
+      # This fingerprint represents the backend configuration that the model runs with.
+      #
+      # Can be used in conjunction with the `seed` request parameter to understand when
+      # backend changes have been made that might impact determinism.
       attr_reader system_fingerprint: String?
 
+      # This fingerprint represents the backend configuration that the model runs with.
+      #
+      # Can be used in conjunction with the `seed` request parameter to understand when
+      # backend changes have been made that might impact determinism.
       def system_fingerprint=: (String) -> String
 
+      # Usage statistics for the completion request.
       attr_reader usage: OpenAI::CompletionUsage?
 
+      # Usage statistics for the completion request.
       def usage=: (OpenAI::CompletionUsage) -> OpenAI::CompletionUsage
 
+      # @param id
+      #   A unique identifier for the completion.
+      # @param choices
+      #   The list of completion choices the model generated for the input prompt.
+      # @param created
+      #   The Unix timestamp (in seconds) of when the completion was created.
+      # @param model
+      #   The model used for completion.
+      # @param system_fingerprint
+      #   This fingerprint represents the backend configuration that the model runs with.
+      #
+      #   Can be used in conjunction with the `seed` request parameter to understand when
+      #   backend changes have been made that might impact determinism.
+      # @param usage
+      #   Usage statistics for the completion request.
+      # @param object
+      #   The object type, which is always "text_completion"
       def initialize: (
         id: String,
         choices: ::Array[OpenAI::CompletionChoice],

data/sig/openai/models/completion_choice.rbs

@@ -9,6 +9,10 @@ module OpenAI
       }
 
     class CompletionChoice < OpenAI::Internal::Type::BaseModel
+      # The reason the model stopped generating tokens. This will be `stop` if the model
+      # hit a natural stop point or a provided stop sequence, `length` if the maximum
+      # number of tokens specified in the request was reached, or `content_filter` if
+      # content was omitted due to a flag from our content filters.
       attr_accessor finish_reason: OpenAI::Models::CompletionChoice::finish_reason
 
       attr_accessor index: Integer
@@ -17,6 +21,11 @@ module OpenAI
 
       attr_accessor text: String
 
+      # @param finish_reason
+      #   The reason the model stopped generating tokens. This will be `stop` if the model
+      #   hit a natural stop point or a provided stop sequence, `length` if the maximum
+      #   number of tokens specified in the request was reached, or `content_filter` if
+      #   content was omitted due to a flag from our content filters.
       def initialize: (
         finish_reason: OpenAI::Models::CompletionChoice::finish_reason,
         index: Integer,

data/sig/openai/models/completion_create_params.rbs

@@ -26,42 +26,240 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
+      # ID of the model to use. You can use the
+      # [List models](https://developers.openai.com/api/reference/resources/models/methods/list)
+      # API to see all of your available models, or see our
+      # [Model overview](https://developers.openai.com/api/docs/models) for descriptions
+      # of them.
       attr_accessor model: OpenAI::Models::CompletionCreateParams::model
 
+      # The prompt(s) to generate completions for, encoded as a string, array of
+      # strings, array of tokens, or array of token arrays.
+      #
+      # Note that <|endoftext|> is the document separator that the model sees during
+      # training, so if a prompt is not specified the model will generate as if from the
+      # beginning of a new document.
       attr_accessor prompt: OpenAI::Models::CompletionCreateParams::prompt?
 
+      # Generates `best_of` completions server-side and returns the "best" (the one with
+      # the highest log probability per token). Results cannot be streamed.
+      #
+      # When used with `n`, `best_of` controls the number of candidate completions and
+      # `n` specifies how many to return – `best_of` must be greater than `n`.
+      #
+      # **Note:** Because this parameter generates many completions, it can quickly
+      # consume your token quota. Use carefully and ensure that you have reasonable
+      # settings for `max_tokens` and `stop`.
       attr_accessor best_of: Integer?
 
+      # Echo back the prompt in addition to the completion
       attr_accessor echo: bool?
 
+      # Number between -2.0 and 2.0. Positive values penalize new tokens based on their
+      # existing frequency in the text so far, decreasing the model's likelihood to
+      # repeat the same line verbatim.
+      #
+      # [See more information about frequency and presence penalties.](https://developers.openai.com/api/docs/guides/text)
       attr_accessor frequency_penalty: Float?
 
+      # Modify the likelihood of specified tokens appearing in the completion.
+      #
+      # Accepts a JSON object that maps tokens (specified by their token ID in the GPT
+      # tokenizer) to an associated bias value from -100 to 100. You can use this
+      # [tokenizer tool](https://platform.openai.com/tokenizer?view=bpe) to convert text
+      # to token IDs. Mathematically, the bias is added to the logits generated by the
+      # model prior to sampling. The exact effect will vary per model, but values
+      # between -1 and 1 should decrease or increase likelihood of selection; values
+      # like -100 or 100 should result in a ban or exclusive selection of the relevant
+      # token.
+      #
+      # As an example, you can pass `{"50256": -100}` to prevent the <|endoftext|> token
+      # from being generated.
       attr_accessor logit_bias: ::Hash[Symbol, Integer]?
 
+      # Include the log probabilities on the `logprobs` most likely output tokens, as
+      # well the chosen tokens. For example, if `logprobs` is 5, the API will return a
+      # list of the 5 most likely tokens. The API will always return the `logprob` of
+      # the sampled token, so there may be up to `logprobs+1` elements in the response.
+      #
+      # The maximum value for `logprobs` is 5.
       attr_accessor logprobs: Integer?
 
+      # The maximum number of [tokens](https://platform.openai.com/tokenizer) that can
+      # be generated in the completion.
+      #
+      # The token count of your prompt plus `max_tokens` cannot exceed the model's
+      # context length.
+      # [Example Python code](https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken)
+      # for counting tokens.
       attr_accessor max_tokens: Integer?
 
+      # How many completions to generate for each prompt.
+      #
+      # **Note:** Because this parameter generates many completions, it can quickly
+      # consume your token quota. Use carefully and ensure that you have reasonable
+      # settings for `max_tokens` and `stop`.
       attr_accessor n: Integer?
 
+      # Number between -2.0 and 2.0. Positive values penalize new tokens based on
+      # whether they appear in the text so far, increasing the model's likelihood to
+      # talk about new topics.
+      #
+      # [See more information about frequency and presence penalties.](https://developers.openai.com/api/docs/guides/text)
       attr_accessor presence_penalty: Float?
 
+      # If specified, our system will make a best effort to sample deterministically,
+      # such that repeated requests with the same `seed` and parameters should return
+      # the same result.
+      #
+      # Determinism is not guaranteed, and you should refer to the `system_fingerprint`
+      # response parameter to monitor changes in the backend.
       attr_accessor seed: Integer?
 
+      # Not supported with latest reasoning models `o3` and `o4-mini`.
+      #
+      # Up to 4 sequences where the API will stop generating further tokens. The
+      # returned text will not contain the stop sequence.
       attr_accessor stop: OpenAI::Models::CompletionCreateParams::stop?
 
+      # Options for streaming response. Only set this when you set `stream: true`.
       attr_accessor stream_options: OpenAI::Chat::ChatCompletionStreamOptions?
 
+      # The suffix that comes after a completion of inserted text.
+      #
+      # This parameter is only supported for `gpt-3.5-turbo-instruct`.
       attr_accessor suffix: String?
 
+      # What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+      # make the output more random, while lower values like 0.2 will make it more
+      # focused and deterministic.
+      #
+      # We generally recommend altering this or `top_p` but not both.
       attr_accessor temperature: Float?
 
+      # An alternative to sampling with temperature, called nucleus sampling, where the
+      # model considers the results of the tokens with top_p probability mass. So 0.1
+      # means only the tokens comprising the top 10% probability mass are considered.
+      #
+      # We generally recommend altering this or `temperature` but not both.
       attr_accessor top_p: Float?
 
+      # A unique identifier representing your end-user, which can help OpenAI to monitor
+      # and detect abuse.
+      # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       attr_reader user: String?
 
+      # A unique identifier representing your end-user, which can help OpenAI to monitor
+      # and detect abuse.
+      # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       def user=: (String) -> String
 
+      # @param model
+      #   ID of the model to use. You can use the
+      #   [List models](https://developers.openai.com/api/reference/resources/models/methods/list)
+      #   API to see all of your available models, or see our
+      #   [Model overview](https://developers.openai.com/api/docs/models) for descriptions
+      #   of them.
+      # @param prompt
+      #   The prompt(s) to generate completions for, encoded as a string, array of
+      #   strings, array of tokens, or array of token arrays.
+      #
+      #   Note that <|endoftext|> is the document separator that the model sees during
+      #   training, so if a prompt is not specified the model will generate as if from the
+      #   beginning of a new document.
+      # @param best_of
+      #   Generates `best_of` completions server-side and returns the "best" (the one with
+      #   the highest log probability per token). Results cannot be streamed.
+      #
+      #   When used with `n`, `best_of` controls the number of candidate completions and
+      #   `n` specifies how many to return – `best_of` must be greater than `n`.
+      #
+      #   **Note:** Because this parameter generates many completions, it can quickly
+      #   consume your token quota. Use carefully and ensure that you have reasonable
+      #   settings for `max_tokens` and `stop`.
+      # @param echo
+      #   Echo back the prompt in addition to the completion
+      # @param frequency_penalty
+      #   Number between -2.0 and 2.0. Positive values penalize new tokens based on their
+      #   existing frequency in the text so far, decreasing the model's likelihood to
+      #   repeat the same line verbatim.
+      #
+      #   [See more information about frequency and presence penalties.](https://developers.openai.com/api/docs/guides/text)
+      # @param logit_bias
+      #   Modify the likelihood of specified tokens appearing in the completion.
+      #
+      #   Accepts a JSON object that maps tokens (specified by their token ID in the GPT
+      #   tokenizer) to an associated bias value from -100 to 100. You can use this
+      #   [tokenizer tool](https://platform.openai.com/tokenizer?view=bpe) to convert text
+      #   to token IDs. Mathematically, the bias is added to the logits generated by the
+      #   model prior to sampling. The exact effect will vary per model, but values
+      #   between -1 and 1 should decrease or increase likelihood of selection; values
+      #   like -100 or 100 should result in a ban or exclusive selection of the relevant
+      #   token.
+      #
+      #   As an example, you can pass `{"50256": -100}` to prevent the <|endoftext|> token
+      #   from being generated.
+      # @param logprobs
+      #   Include the log probabilities on the `logprobs` most likely output tokens, as
+      #   well the chosen tokens. For example, if `logprobs` is 5, the API will return a
+      #   list of the 5 most likely tokens. The API will always return the `logprob` of
+      #   the sampled token, so there may be up to `logprobs+1` elements in the response.
+      #
+      #   The maximum value for `logprobs` is 5.
+      # @param max_tokens
+      #   The maximum number of [tokens](https://platform.openai.com/tokenizer) that can
+      #   be generated in the completion.
+      #
+      #   The token count of your prompt plus `max_tokens` cannot exceed the model's
+      #   context length.
+      #   [Example Python code](https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken)
+      #   for counting tokens.
+      # @param n
+      #   How many completions to generate for each prompt.
+      #
+      #   **Note:** Because this parameter generates many completions, it can quickly
+      #   consume your token quota. Use carefully and ensure that you have reasonable
+      #   settings for `max_tokens` and `stop`.
+      # @param presence_penalty
+      #   Number between -2.0 and 2.0. Positive values penalize new tokens based on
+      #   whether they appear in the text so far, increasing the model's likelihood to
+      #   talk about new topics.
+      #
+      #   [See more information about frequency and presence penalties.](https://developers.openai.com/api/docs/guides/text)
+      # @param seed
+      #   If specified, our system will make a best effort to sample deterministically,
+      #   such that repeated requests with the same `seed` and parameters should return
+      #   the same result.
+      #
+      #   Determinism is not guaranteed, and you should refer to the `system_fingerprint`
+      #   response parameter to monitor changes in the backend.
+      # @param stop
+      #   Not supported with latest reasoning models `o3` and `o4-mini`.
+      #
+      #   Up to 4 sequences where the API will stop generating further tokens. The
+      #   returned text will not contain the stop sequence.
+      # @param stream_options
+      #   Options for streaming response. Only set this when you set `stream: true`.
+      # @param suffix
+      #   The suffix that comes after a completion of inserted text.
+      #
+      #   This parameter is only supported for `gpt-3.5-turbo-instruct`.
+      # @param temperature
+      #   What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+      #   make the output more random, while lower values like 0.2 will make it more
+      #   focused and deterministic.
+      #
+      #   We generally recommend altering this or `top_p` but not both.
+      # @param top_p
+      #   An alternative to sampling with temperature, called nucleus sampling, where the
+      #   model considers the results of the tokens with top_p probability mass. So 0.1
+      #   means only the tokens comprising the top 10% probability mass are considered.
+      #
+      #   We generally recommend altering this or `temperature` but not both.
+      # @param user
+      #   A unique identifier representing your end-user, which can help OpenAI to monitor
+      #   and detect abuse.
+      #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       def initialize: (
         model: OpenAI::Models::CompletionCreateParams::model,
         prompt: OpenAI::Models::CompletionCreateParams::prompt?,

data/sig/openai/models/completion_usage.rbs

@@ -10,24 +10,41 @@ module OpenAI
       }
 
     class CompletionUsage < OpenAI::Internal::Type::BaseModel
+      # Number of tokens in the generated completion.
       attr_accessor completion_tokens: Integer
 
+      # Number of tokens in the prompt.
       attr_accessor prompt_tokens: Integer
 
+      # Total number of tokens used in the request (prompt + completion).
       attr_accessor total_tokens: Integer
 
+      # Breakdown of tokens used in a completion.
       attr_reader completion_tokens_details: OpenAI::CompletionUsage::CompletionTokensDetails?
 
+      # Breakdown of tokens used in a completion.
       def completion_tokens_details=: (
         OpenAI::CompletionUsage::CompletionTokensDetails
       ) -> OpenAI::CompletionUsage::CompletionTokensDetails
 
+      # Breakdown of tokens used in the prompt.
       attr_reader prompt_tokens_details: OpenAI::CompletionUsage::PromptTokensDetails?
 
+      # Breakdown of tokens used in the prompt.
       def prompt_tokens_details=: (
         OpenAI::CompletionUsage::PromptTokensDetails
       ) -> OpenAI::CompletionUsage::PromptTokensDetails
 
+      # @param completion_tokens
+      #   Number of tokens in the generated completion.
+      # @param prompt_tokens
+      #   Number of tokens in the prompt.
+      # @param total_tokens
+      #   Total number of tokens used in the request (prompt + completion).
+      # @param completion_tokens_details
+      #   Breakdown of tokens used in a completion.
+      # @param prompt_tokens_details
+      #   Breakdown of tokens used in the prompt.
       def initialize: (
         completion_tokens: Integer,
         prompt_tokens: Integer,
@@ -54,26 +71,58 @@ module OpenAI
         }
 
       class CompletionTokensDetails < OpenAI::Internal::Type::BaseModel
+        # When using Predicted Outputs, the number of tokens in the prediction that
+        # appeared in the completion.
         attr_reader accepted_prediction_tokens: Integer?
 
+        # When using Predicted Outputs, the number of tokens in the prediction that
+        # appeared in the completion.
         def accepted_prediction_tokens=: (Integer) -> Integer
 
+        # Audio input tokens generated by the model.
         attr_reader audio_tokens: Integer?
 
+        # Audio input tokens generated by the model.
         def audio_tokens=: (Integer) -> Integer
 
+        # Tokens generated by the model for reasoning.
         attr_reader reasoning_tokens: Integer?
 
+        # Tokens generated by the model for reasoning.
         def reasoning_tokens=: (Integer) -> Integer
 
+        # When using Predicted Outputs, the number of tokens in the prediction that did
+        # not appear in the completion. However, like reasoning tokens, these tokens are
+        # still counted in the total completion tokens for purposes of billing, output,
+        # and context window limits.
         attr_reader rejected_prediction_tokens: Integer?
 
+        # When using Predicted Outputs, the number of tokens in the prediction that did
+        # not appear in the completion. However, like reasoning tokens, these tokens are
+        # still counted in the total completion tokens for purposes of billing, output,
+        # and context window limits.
         def rejected_prediction_tokens=: (Integer) -> Integer
 
+        # Text output tokens generated by the model.
         attr_reader text_tokens: Integer?
 
+        # Text output tokens generated by the model.
         def text_tokens=: (Integer) -> Integer
 
+        # @param accepted_prediction_tokens
+        #   When using Predicted Outputs, the number of tokens in the prediction that
+        #   appeared in the completion.
+        # @param audio_tokens
+        #   Audio input tokens generated by the model.
+        # @param reasoning_tokens
+        #   Tokens generated by the model for reasoning.
+        # @param rejected_prediction_tokens
+        #   When using Predicted Outputs, the number of tokens in the prediction that did
+        #   not appear in the completion. However, like reasoning tokens, these tokens are
+        #   still counted in the total completion tokens for purposes of billing, output,
+        #   and context window limits.
+        # @param text_tokens
+        #   Text output tokens generated by the model.
         def initialize: (
           ?accepted_prediction_tokens: Integer,
           ?audio_tokens: Integer,
@@ -101,26 +150,46 @@ module OpenAI
         }
 
       class PromptTokensDetails < OpenAI::Internal::Type::BaseModel
+        # Audio input tokens present in the prompt.
         attr_reader audio_tokens: Integer?
 
+        # Audio input tokens present in the prompt.
         def audio_tokens=: (Integer) -> Integer
 
+        # The unadjusted number of prompt tokens written to cache.
         attr_reader cache_write_tokens: Integer?
 
+        # The unadjusted number of prompt tokens written to cache.
         def cache_write_tokens=: (Integer) -> Integer
 
+        # Cached tokens present in the prompt.
         attr_reader cached_tokens: Integer?
 
+        # Cached tokens present in the prompt.
         def cached_tokens=: (Integer) -> Integer
 
+        # Image input tokens present in the prompt.
         attr_reader image_tokens: Integer?
 
+        # Image input tokens present in the prompt.
         def image_tokens=: (Integer) -> Integer
 
+        # Text input tokens present in the prompt.
         attr_reader text_tokens: Integer?
 
+        # Text input tokens present in the prompt.
         def text_tokens=: (Integer) -> Integer
 
+        # @param audio_tokens
+        #   Audio input tokens present in the prompt.
+        # @param cache_write_tokens
+        #   The unadjusted number of prompt tokens written to cache.
+        # @param cached_tokens
+        #   Cached tokens present in the prompt.
+        # @param image_tokens
+        #   Image input tokens present in the prompt.
+        # @param text_tokens
+        #   Text input tokens present in the prompt.
         def initialize: (
           ?audio_tokens: Integer,
           ?cache_write_tokens: Integer,

data/sig/openai/models/compound_filter.rbs

@@ -7,10 +7,18 @@ module OpenAI
       }
 
     class CompoundFilter < OpenAI::Internal::Type::BaseModel
+      # Array of filters to combine. Items can be `ComparisonFilter` or
+      # `CompoundFilter`.
       attr_accessor filters: ::Array[OpenAI::Models::CompoundFilter::filter]
 
+      # Type of operation: `and` or `or`.
       attr_accessor type: OpenAI::Models::CompoundFilter::type_
 
+      # @param filters
+      #   Array of filters to combine. Items can be `ComparisonFilter` or
+      #   `CompoundFilter`.
+      # @param type
+      #   Type of operation: `and` or `or`.
       def initialize: (
         filters: ::Array[OpenAI::Models::CompoundFilter::filter],
         type: OpenAI::Models::CompoundFilter::type_