openai 0.87.0 → 0.89.0

data/lib/openai/models/fine_tuning/job_create_params.rb

@@ -10,7 +10,7 @@ module OpenAI
 
         # @!attribute model
         #   The name of the model to fine-tune. You can select one of the
-        #   [supported models](https://platform.openai.com/docs/guides/fine-tuning#which-models-can-be-fine-tuned).
+        #   [supported models](https://developers.openai.com/api/docs/guides/model-optimization#fine-tuning-methods).
         #
         #   @return [String, Symbol, OpenAI::Models::FineTuning::JobCreateParams::Model]
         required :model, union: -> { OpenAI::FineTuning::JobCreateParams::Model }
@@ -18,21 +18,22 @@ module OpenAI
         # @!attribute training_file
         #   The ID of an uploaded file that contains training data.
         #
-        #   See [upload file](https://platform.openai.com/docs/api-reference/files/create)
+        #   See
+        #   [upload file](https://developers.openai.com/api/reference/resources/files/methods/create)
         #   for how to upload a file.
         #
         #   Your dataset must be formatted as a JSONL file. Additionally, you must upload
         #   your file with the purpose `fine-tune`.
         #
         #   The contents of the file should differ depending on if the model uses the
-        #   [chat](https://platform.openai.com/docs/api-reference/fine-tuning/chat-input),
-        #   [completions](https://platform.openai.com/docs/api-reference/fine-tuning/completions-input)
+        #   [chat](https://developers.openai.com/api/docs/guides/supervised-fine-tuning#formatting-your-data),
+        #   [completions](https://developers.openai.com/api/docs/guides/supervised-fine-tuning#formatting-your-data)
         #   format, or if the fine-tuning method uses the
-        #   [preference](https://platform.openai.com/docs/api-reference/fine-tuning/preference-input)
+        #   [preference](https://developers.openai.com/api/docs/guides/direct-preference-optimization)
         #   format.
         #
         #   See the
-        #   [fine-tuning guide](https://platform.openai.com/docs/guides/model-optimization)
+        #   [fine-tuning guide](https://developers.openai.com/api/docs/guides/model-optimization)
         #   for more details.
         #
         #   @return [String]
@@ -104,38 +105,87 @@ module OpenAI
         #   the purpose `fine-tune`.
         #
         #   See the
-        #   [fine-tuning guide](https://platform.openai.com/docs/guides/model-optimization)
+        #   [fine-tuning guide](https://developers.openai.com/api/docs/guides/model-optimization)
         #   for more details.
         #
         #   @return [String, nil]
         optional :validation_file, String, nil?: true
 
         # @!method initialize(model:, training_file:, hyperparameters: nil, integrations: nil, metadata: nil, method_: nil, seed: nil, suffix: nil, validation_file: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::FineTuning::JobCreateParams} for more details.
+        #   @param model [String, Symbol, OpenAI::Models::FineTuning::JobCreateParams::Model]
+        #     The name of the model to fine-tune. You can select one of the
+        #     [supported models](https://developers.openai.com/api/docs/guides/model-optimization#fine-tuning-methods).
         #
-        #   @param model [String, Symbol, OpenAI::Models::FineTuning::JobCreateParams::Model] The name of the model to fine-tune. You can select one of the
+        #   @param training_file [String]
+        #     The ID of an uploaded file that contains training data.
         #
-        #   @param training_file [String] The ID of an uploaded file that contains training data.
+        #     See
+        #     [upload file](https://developers.openai.com/api/reference/resources/files/methods/create)
+        #     for how to upload a file.
         #
-        #   @param hyperparameters [OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters] The hyperparameters used for the fine-tuning job.
+        #     Your dataset must be formatted as a JSONL file. Additionally, you must upload
+        #     your file with the purpose `fine-tune`.
         #
-        #   @param integrations [Array<OpenAI::Models::FineTuning::JobCreateParams::Integration>, nil] A list of integrations to enable for your fine-tuning job.
+        #     The contents of the file should differ depending on if the model uses the
+        #     [chat](https://developers.openai.com/api/docs/guides/supervised-fine-tuning#formatting-your-data),
+        #     [completions](https://developers.openai.com/api/docs/guides/supervised-fine-tuning#formatting-your-data)
+        #     format, or if the fine-tuning method uses the
+        #     [preference](https://developers.openai.com/api/docs/guides/direct-preference-optimization)
+        #     format.
         #
-        #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #     See the
+        #     [fine-tuning guide](https://developers.openai.com/api/docs/guides/model-optimization)
+        #     for more details.
         #
-        #   @param method_ [OpenAI::Models::FineTuning::JobCreateParams::Method] The method used for fine-tuning.
+        #   @param hyperparameters [OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters]
+        #     The hyperparameters used for the fine-tuning job. This value is now deprecated
+        #     in favor of `method`, and should be passed in under the `method` parameter.
         #
-        #   @param seed [Integer, nil] The seed controls the reproducibility of the job. Passing in the same seed and j
+        #   @param integrations [Array<OpenAI::Models::FineTuning::JobCreateParams::Integration>, nil]
+        #     A list of integrations to enable for your fine-tuning job.
         #
-        #   @param suffix [String, nil] A string of up to 64 characters that will be added to your fine-tuned model name
+        #   @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 validation_file [String, nil] The ID of an uploaded file that contains validation data.
+        #     Keys are strings with a maximum length of 64 characters. Values are strings with
+        #     a maximum length of 512 characters.
+        #
+        #   @param method_ [OpenAI::Models::FineTuning::JobCreateParams::Method]
+        #     The method used for fine-tuning.
+        #
+        #   @param seed [Integer, nil]
+        #     The seed controls the reproducibility of the job. Passing in the same seed and
+        #     job parameters should produce the same results, but may differ in rare cases. If
+        #     a seed is not specified, one will be generated for you.
+        #
+        #   @param suffix [String, nil]
+        #     A string of up to 64 characters that will be added to your fine-tuned model
+        #     name.
+        #
+        #     For example, a `suffix` of "custom-model-name" would produce a model name like
+        #     `ft:gpt-4o-mini:openai:custom-model-name:7p4lURel`.
+        #
+        #   @param validation_file [String, nil]
+        #     The ID of an uploaded file that contains validation data.
+        #
+        #     If you provide this file, the data is used to generate validation metrics
+        #     periodically during fine-tuning. These metrics can be viewed in the fine-tuning
+        #     results file. The same data should not be present in both train and validation
+        #     files.
+        #
+        #     Your dataset must be formatted as a JSONL file. You must upload your file with
+        #     the purpose `fine-tune`.
+        #
+        #     See the
+        #     [fine-tuning guide](https://developers.openai.com/api/docs/guides/model-optimization)
+        #     for more details.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
         # The name of the model to fine-tune. You can select one of the
-        # [supported models](https://platform.openai.com/docs/guides/fine-tuning#which-models-can-be-fine-tuned).
+        # [supported models](https://developers.openai.com/api/docs/guides/model-optimization#fine-tuning-methods).
         module Model
           extend OpenAI::Internal::Type::Union
 
@@ -193,17 +243,20 @@ module OpenAI
           optional :n_epochs, union: -> { OpenAI::FineTuning::JobCreateParams::Hyperparameters::NEpochs }
 
           # @!method initialize(batch_size: nil, learning_rate_multiplier: nil, n_epochs: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters} for more details.
-          #
           #   The hyperparameters used for the fine-tuning job. This value is now deprecated
           #   in favor of `method`, and should be passed in under the `method` parameter.
           #
-          #   @param batch_size [Symbol, :auto, Integer] Number of examples in each batch. A larger batch size means that model parameter
+          #   @param batch_size [Symbol, :auto, Integer]
+          #     Number of examples in each batch. A larger batch size means that model
+          #     parameters are updated less frequently, but with lower variance.
           #
-          #   @param learning_rate_multiplier [Symbol, :auto, Float] Scaling factor for the learning rate. A smaller learning rate may be useful to a
+          #   @param learning_rate_multiplier [Symbol, :auto, Float]
+          #     Scaling factor for the learning rate. A smaller learning rate may be useful to
+          #     avoid overfitting.
           #
-          #   @param n_epochs [Symbol, :auto, Integer] The number of epochs to train the model for. An epoch refers to one full cycle
+          #   @param n_epochs [Symbol, :auto, Integer]
+          #     The number of epochs to train the model for. An epoch refers to one full cycle
+          #     through the training dataset.
 
           # Number of examples in each batch. A larger batch size means that model
           # parameters are updated less frequently, but with lower variance.
@@ -269,12 +322,15 @@ module OpenAI
           required :wandb, -> { OpenAI::FineTuning::JobCreateParams::Integration::Wandb }
 
           # @!method initialize(wandb:, type: :wandb)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::FineTuning::JobCreateParams::Integration} for more details.
+          #   @param wandb [OpenAI::Models::FineTuning::JobCreateParams::Integration::Wandb]
+          #     The settings for your integration with Weights and Biases. This payload
+          #     specifies the project that metrics will be sent to. Optionally, you can set an
+          #     explicit display name for your run, add tags to your run, and set a default
+          #     entity (team, username, etc) to be associated with your run.
           #
-          #   @param wandb [OpenAI::Models::FineTuning::JobCreateParams::Integration::Wandb] The settings for your integration with Weights and Biases. This payload specifie
-          #
-          #   @param type [Symbol, :wandb] The type of integration to enable. Currently, only "wandb" (Weights and Biases)
+          #   @param type [Symbol, :wandb]
+          #     The type of integration to enable. Currently, only "wandb" (Weights and Biases)
+          #     is supported.
 
           # @see OpenAI::Models::FineTuning::JobCreateParams::Integration#wandb
           class Wandb < OpenAI::Internal::Type::BaseModel
@@ -308,22 +364,27 @@ module OpenAI
             optional :tags, OpenAI::Internal::Type::ArrayOf[String]
 
             # @!method initialize(project:, entity: nil, name: nil, tags: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::FineTuning::JobCreateParams::Integration::Wandb} for more
-            #   details.
-            #
             #   The settings for your integration with Weights and Biases. This payload
             #   specifies the project that metrics will be sent to. Optionally, you can set an
             #   explicit display name for your run, add tags to your run, and set a default
             #   entity (team, username, etc) to be associated with your run.
             #
-            #   @param project [String] The name of the project that the new run will be created under.
+            #   @param project [String]
+            #     The name of the project that the new run will be created under.
             #
-            #   @param entity [String, nil] The entity to use for the run. This allows you to set the team or username of th
+            #   @param entity [String, nil]
+            #     The entity to use for the run. This allows you to set the team or username of
+            #     the WandB user that you would like associated with the run. If not set, the
+            #     default entity for the registered WandB API key is used.
             #
-            #   @param name [String, nil] A display name to set for the run. If not set, we will use the Job ID as the nam
+            #   @param name [String, nil]
+            #     A display name to set for the run. If not set, we will use the Job ID as the
+            #     name.
             #
-            #   @param tags [Array<String>] A list of tags to be attached to the newly created run. These tags are passed th
+            #   @param tags [Array<String>]
+            #     A list of tags to be attached to the newly created run. These tags are passed
+            #     through directly to WandB. Some default tags are generated by OpenAI:
+            #     "openai/finetune", "openai/{base-model}", "openai/{ftjob-abcdef}".
           end
         end
 
@@ -355,13 +416,17 @@ module OpenAI
           # @!method initialize(type:, dpo: nil, reinforcement: nil, supervised: nil)
           #   The method used for fine-tuning.
           #
-          #   @param type [Symbol, OpenAI::Models::FineTuning::JobCreateParams::Method::Type] The type of method. Is either `supervised`, `dpo`, or `reinforcement`.
+          #   @param type [Symbol, OpenAI::Models::FineTuning::JobCreateParams::Method::Type]
+          #     The type of method. Is either `supervised`, `dpo`, or `reinforcement`.
           #
-          #   @param dpo [OpenAI::Models::FineTuning::DpoMethod] Configuration for the DPO fine-tuning method.
+          #   @param dpo [OpenAI::Models::FineTuning::DpoMethod]
+          #     Configuration for the DPO fine-tuning method.
           #
-          #   @param reinforcement [OpenAI::Models::FineTuning::ReinforcementMethod] Configuration for the reinforcement fine-tuning method.
+          #   @param reinforcement [OpenAI::Models::FineTuning::ReinforcementMethod]
+          #     Configuration for the reinforcement fine-tuning method.
           #
-          #   @param supervised [OpenAI::Models::FineTuning::SupervisedMethod] Configuration for the supervised fine-tuning method.
+          #   @param supervised [OpenAI::Models::FineTuning::SupervisedMethod]
+          #     Configuration for the supervised fine-tuning method.
 
           # The type of method. Is either `supervised`, `dpo`, or `reinforcement`.
           #

data/lib/openai/models/fine_tuning/job_list_events_params.rb

@@ -28,9 +28,11 @@ module OpenAI
         # @!method initialize(fine_tuning_job_id:, after: nil, limit: nil, request_options: {})
         #   @param fine_tuning_job_id [String]
         #
-        #   @param after [String] Identifier for the last event from the previous pagination request.
+        #   @param after [String]
+        #     Identifier for the last event from the previous pagination request.
         #
-        #   @param limit [Integer] Number of events to retrieve.
+        #   @param limit [Integer]
+        #     Number of events to retrieve.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openai/models/fine_tuning/job_list_params.rb

@@ -28,14 +28,15 @@ module OpenAI
         optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
         # @!method initialize(after: nil, limit: nil, metadata: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::FineTuning::JobListParams} for more details.
+        #   @param after [String]
+        #     Identifier for the last job from the previous pagination request.
         #
-        #   @param after [String] Identifier for the last job from the previous pagination request.
+        #   @param limit [Integer]
+        #     Number of fine-tuning jobs to retrieve.
         #
-        #   @param limit [Integer] Number of fine-tuning jobs to retrieve.
-        #
-        #   @param metadata [Hash{Symbol=>String}, nil] Optional metadata filter. To filter, use the syntax `metadata[k]=v`. Alternative
+        #   @param metadata [Hash{Symbol=>String}, nil]
+        #     Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
+        #     Alternatively, set `metadata=null` to indicate no metadata.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openai/models/fine_tuning/jobs/checkpoint_list_params.rb

@@ -29,9 +29,11 @@ module OpenAI
           # @!method initialize(fine_tuning_job_id:, after: nil, limit: nil, request_options: {})
           #   @param fine_tuning_job_id [String]
           #
-          #   @param after [String] Identifier for the last checkpoint ID from the previous pagination request.
+          #   @param after [String]
+          #     Identifier for the last checkpoint ID from the previous pagination request.
           #
-          #   @param limit [Integer] Number of checkpoints to retrieve.
+          #   @param limit [Integer]
+          #     Number of checkpoints to retrieve.
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
         end

data/lib/openai/models/fine_tuning/jobs/fine_tuning_job_checkpoint.rb

@@ -52,19 +52,26 @@ module OpenAI
           #   The `fine_tuning.job.checkpoint` object represents a model checkpoint for a
           #   fine-tuning job that is ready to use.
           #
-          #   @param id [String] The checkpoint identifier, which can be referenced in the API endpoints.
+          #   @param id [String]
+          #     The checkpoint identifier, which can be referenced in the API endpoints.
           #
-          #   @param created_at [Integer] The Unix timestamp (in seconds) for when the checkpoint was created.
+          #   @param created_at [Integer]
+          #     The Unix timestamp (in seconds) for when the checkpoint was created.
           #
-          #   @param fine_tuned_model_checkpoint [String] The name of the fine-tuned checkpoint model that is created.
+          #   @param fine_tuned_model_checkpoint [String]
+          #     The name of the fine-tuned checkpoint model that is created.
           #
-          #   @param fine_tuning_job_id [String] The name of the fine-tuning job that this checkpoint was created from.
+          #   @param fine_tuning_job_id [String]
+          #     The name of the fine-tuning job that this checkpoint was created from.
           #
-          #   @param metrics [OpenAI::Models::FineTuning::Jobs::FineTuningJobCheckpoint::Metrics] Metrics at the step number during the fine-tuning job.
+          #   @param metrics [OpenAI::Models::FineTuning::Jobs::FineTuningJobCheckpoint::Metrics]
+          #     Metrics at the step number during the fine-tuning job.
           #
-          #   @param step_number [Integer] The step number that the checkpoint was created at.
+          #   @param step_number [Integer]
+          #     The step number that the checkpoint was created at.
           #
-          #   @param object [Symbol, :"fine_tuning.job.checkpoint"] The object type, which is always "fine_tuning.job.checkpoint".
+          #   @param object [Symbol, :"fine_tuning.job.checkpoint"]
+          #     The object type, which is always "fine_tuning.job.checkpoint".
 
           # @see OpenAI::Models::FineTuning::Jobs::FineTuningJobCheckpoint#metrics
           class Metrics < OpenAI::Internal::Type::BaseModel

data/lib/openai/models/fine_tuning/reinforcement_hyperparameters.rb

@@ -56,24 +56,31 @@ module OpenAI
         optional :reasoning_effort, enum: -> { OpenAI::FineTuning::ReinforcementHyperparameters::ReasoningEffort }
 
         # @!method initialize(batch_size: nil, compute_multiplier: nil, eval_interval: nil, eval_samples: nil, learning_rate_multiplier: nil, n_epochs: nil, reasoning_effort: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::FineTuning::ReinforcementHyperparameters} for more details.
-        #
         #   The hyperparameters used for the reinforcement fine-tuning job.
         #
-        #   @param batch_size [Symbol, :auto, Integer] Number of examples in each batch. A larger batch size means that model parameter
+        #   @param batch_size [Symbol, :auto, Integer]
+        #     Number of examples in each batch. A larger batch size means that model
+        #     parameters are updated less frequently, but with lower variance.
         #
-        #   @param compute_multiplier [Symbol, :auto, Float] Multiplier on amount of compute used for exploring search space during training.
+        #   @param compute_multiplier [Symbol, :auto, Float]
+        #     Multiplier on amount of compute used for exploring search space during training.
         #
-        #   @param eval_interval [Symbol, :auto, Integer] The number of training steps between evaluation runs.
+        #   @param eval_interval [Symbol, :auto, Integer]
+        #     The number of training steps between evaluation runs.
         #
-        #   @param eval_samples [Symbol, :auto, Integer] Number of evaluation samples to generate per training step.
+        #   @param eval_samples [Symbol, :auto, Integer]
+        #     Number of evaluation samples to generate per training step.
         #
-        #   @param learning_rate_multiplier [Symbol, :auto, Float] Scaling factor for the learning rate. A smaller learning rate may be useful to a
+        #   @param learning_rate_multiplier [Symbol, :auto, Float]
+        #     Scaling factor for the learning rate. A smaller learning rate may be useful to
+        #     avoid overfitting.
         #
-        #   @param n_epochs [Symbol, :auto, Integer] The number of epochs to train the model for. An epoch refers to one full cycle t
+        #   @param n_epochs [Symbol, :auto, Integer]
+        #     The number of epochs to train the model for. An epoch refers to one full cycle
+        #     through the training dataset.
         #
-        #   @param reasoning_effort [Symbol, OpenAI::Models::FineTuning::ReinforcementHyperparameters::ReasoningEffort] Level of reasoning effort.
+        #   @param reasoning_effort [Symbol, OpenAI::Models::FineTuning::ReinforcementHyperparameters::ReasoningEffort]
+        #     Level of reasoning effort.
 
         # Number of examples in each batch. A larger batch size means that model
         # parameters are updated less frequently, but with lower variance.

data/lib/openai/models/fine_tuning/reinforcement_method.rb

@@ -19,9 +19,11 @@ module OpenAI
         # @!method initialize(grader:, hyperparameters: nil)
         #   Configuration for the reinforcement fine-tuning method.
         #
-        #   @param grader [OpenAI::Models::Graders::StringCheckGrader, OpenAI::Models::Graders::TextSimilarityGrader, OpenAI::Models::Graders::PythonGrader, OpenAI::Models::Graders::ScoreModelGrader, OpenAI::Models::Graders::MultiGrader] The grader used for the fine-tuning job.
+        #   @param grader [OpenAI::Models::Graders::StringCheckGrader, OpenAI::Models::Graders::TextSimilarityGrader, OpenAI::Models::Graders::PythonGrader, OpenAI::Models::Graders::ScoreModelGrader, OpenAI::Models::Graders::MultiGrader]
+        #     The grader used for the fine-tuning job.
         #
-        #   @param hyperparameters [OpenAI::Models::FineTuning::ReinforcementHyperparameters] The hyperparameters used for the reinforcement fine-tuning job.
+        #   @param hyperparameters [OpenAI::Models::FineTuning::ReinforcementHyperparameters]
+        #     The hyperparameters used for the reinforcement fine-tuning job.
 
         # The grader used for the fine-tuning job.
         #

data/lib/openai/models/fine_tuning/supervised_hyperparameters.rb

@@ -29,16 +29,19 @@ module OpenAI
         optional :n_epochs, union: -> { OpenAI::FineTuning::SupervisedHyperparameters::NEpochs }
 
         # @!method initialize(batch_size: nil, learning_rate_multiplier: nil, n_epochs: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::FineTuning::SupervisedHyperparameters} for more details.
-        #
         #   The hyperparameters used for the fine-tuning job.
         #
-        #   @param batch_size [Symbol, :auto, Integer] Number of examples in each batch. A larger batch size means that model parameter
+        #   @param batch_size [Symbol, :auto, Integer]
+        #     Number of examples in each batch. A larger batch size means that model
+        #     parameters are updated less frequently, but with lower variance.
         #
-        #   @param learning_rate_multiplier [Symbol, :auto, Float] Scaling factor for the learning rate. A smaller learning rate may be useful to a
+        #   @param learning_rate_multiplier [Symbol, :auto, Float]
+        #     Scaling factor for the learning rate. A smaller learning rate may be useful to
+        #     avoid overfitting.
         #
-        #   @param n_epochs [Symbol, :auto, Integer] The number of epochs to train the model for. An epoch refers to one full cycle t
+        #   @param n_epochs [Symbol, :auto, Integer]
+        #     The number of epochs to train the model for. An epoch refers to one full cycle
+        #     through the training dataset.
 
         # Number of examples in each batch. A larger batch size means that model
         # parameters are updated less frequently, but with lower variance.

data/lib/openai/models/fine_tuning/supervised_method.rb

@@ -13,7 +13,8 @@ module OpenAI
         # @!method initialize(hyperparameters: nil)
         #   Configuration for the supervised fine-tuning method.
         #
-        #   @param hyperparameters [OpenAI::Models::FineTuning::SupervisedHyperparameters] The hyperparameters used for the fine-tuning job.
+        #   @param hyperparameters [OpenAI::Models::FineTuning::SupervisedHyperparameters]
+        #     The hyperparameters used for the fine-tuning job.
       end
     end
   end

data/lib/openai/models/function_definition.rb

@@ -19,8 +19,8 @@ module OpenAI
 
       # @!attribute parameters
       #   The parameters the functions accepts, described as a JSON Schema object. See the
-      #   [guide](https://platform.openai.com/docs/guides/function-calling) for examples,
-      #   and the
+      #   [guide](https://developers.openai.com/api/docs/guides/function-calling) for
+      #   examples, and the
       #   [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for
       #   documentation about the format.
       #
@@ -34,22 +34,35 @@ module OpenAI
       #   set to true, the model will follow the exact schema defined in the `parameters`
       #   field. Only a subset of JSON Schema is supported when `strict` is `true`. Learn
       #   more about Structured Outputs in the
-      #   [function calling guide](https://platform.openai.com/docs/guides/function-calling).
+      #   [function calling guide](https://developers.openai.com/api/docs/guides/function-calling).
       #
       #   @return [Boolean, nil]
       optional :strict, OpenAI::Internal::Type::Boolean, nil?: true
 
       # @!method initialize(name:, description: nil, parameters: nil, strict: nil)
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::FunctionDefinition} for more details.
+      #   @param name [String]
+      #     The name of the function to be called. Must be a-z, A-Z, 0-9, or contain
+      #     underscores and dashes, with a maximum length of 64.
       #
-      #   @param name [String] The name of the function to be called. Must be a-z, A-Z, 0-9, or contain undersc
+      #   @param description [String]
+      #     A description of what the function does, used by the model to choose when and
+      #     how to call the function.
       #
-      #   @param description [String] A description of what the function does, used by the model to choose when and ho
+      #   @param parameters [Hash{Symbol=>Object}]
+      #     The parameters the functions accepts, described as a JSON Schema object. See the
+      #     [guide](https://developers.openai.com/api/docs/guides/function-calling) for
+      #     examples, and the
+      #     [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for
+      #     documentation about the format.
       #
-      #   @param parameters [Hash{Symbol=>Object}] The parameters the functions accepts, described as a JSON Schema object. See the
+      #     Omitting `parameters` defines a function with an empty parameter list.
       #
-      #   @param strict [Boolean, nil] Whether to enable strict schema adherence when generating the function call. If
+      #   @param strict [Boolean, nil]
+      #     Whether to enable strict schema adherence when generating the function call. If
+      #     set to true, the model will follow the exact schema defined in the `parameters`
+      #     field. Only a subset of JSON Schema is supported when `strict` is `true`. Learn
+      #     more about Structured Outputs in the
+      #     [function calling guide](https://developers.openai.com/api/docs/guides/function-calling).
     end
   end
 end

data/lib/openai/models/graders/grader_input_item.rb

@@ -36,14 +36,13 @@ module OpenAI
           required :type, const: :output_text
 
           # @!method initialize(text:, type: :output_text)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Graders::GraderInputItem::OutputText} for more details.
-          #
           #   A text output from the model.
           #
-          #   @param text [String] The text output from the model.
+          #   @param text [String]
+          #     The text output from the model.
           #
-          #   @param type [Symbol, :output_text] The type of the output text. Always `output_text`.
+          #   @param type [Symbol, :output_text]
+          #     The type of the output text. Always `output_text`.
         end
 
         class InputImage < OpenAI::Internal::Type::BaseModel
@@ -67,16 +66,17 @@ module OpenAI
           optional :detail, String
 
           # @!method initialize(image_url:, detail: nil, type: :input_image)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Graders::GraderInputItem::InputImage} for more details.
-          #
           #   An image input block used within EvalItem content arrays.
           #
-          #   @param image_url [String] The URL of the image input.
+          #   @param image_url [String]
+          #     The URL of the image input.
           #
-          #   @param detail [String] The detail level of the image to be sent to the model. One of `high`, `low`, or
+          #   @param detail [String]
+          #     The detail level of the image to be sent to the model. One of `high`, `low`, or
+          #     `auto`. Defaults to `auto`.
           #
-          #   @param type [Symbol, :input_image] The type of the image input. Always `input_image`.
+          #   @param type [Symbol, :input_image]
+          #     The type of the image input. Always `input_image`.
         end
 
         # @!method self.variants

data/lib/openai/models/graders/label_model_grader.rb

@@ -45,16 +45,20 @@ module OpenAI
         #
         #   @param input [Array<OpenAI::Models::Graders::LabelModelGrader::Input>]
         #
-        #   @param labels [Array<String>] The labels to assign to each item in the evaluation.
+        #   @param labels [Array<String>]
+        #     The labels to assign to each item in the evaluation.
         #
-        #   @param model [String] The model to use for the evaluation. Must support structured outputs.
+        #   @param model [String]
+        #     The model to use for the evaluation. Must support structured outputs.
         #
-        #   @param name [String] The name of the grader.
+        #   @param name [String]
+        #     The name of the grader.
         #
-        #   @param passing_labels [Array<String>] The labels that indicate a passing result. Must be a subset of labels.
+        #   @param passing_labels [Array<String>]
+        #     The labels that indicate a passing result. Must be a subset of labels.
         #
-        #   @param type [Symbol, :label_model] The object type, which is always `label_model`.
-
+        #   @param type [Symbol, :label_model]
+        #     The object type, which is always `label_model`.
         class Input < OpenAI::Internal::Type::BaseModel
           # @!attribute content
           #   Inputs to the model - can contain template strings. Supports text, output text,
@@ -77,20 +81,22 @@ module OpenAI
           optional :type, enum: -> { OpenAI::Graders::LabelModelGrader::Input::Type }
 
           # @!method initialize(content:, role:, type: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Graders::LabelModelGrader::Input} for more details.
-          #
           #   A message input to the model with a role indicating instruction following
           #   hierarchy. Instructions given with the `developer` or `system` role take
           #   precedence over instructions given with the `user` role. Messages with the
           #   `assistant` role are presumed to have been generated by the model in previous
           #   interactions.
           #
-          #   @param content [String, OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Graders::LabelModelGrader::Input::Content::OutputText, OpenAI::Models::Graders::LabelModelGrader::Input::Content::InputImage, OpenAI::Models::Responses::ResponseInputAudio, Array<String, OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Graders::GraderInputItem::OutputText, OpenAI::Models::Graders::GraderInputItem::InputImage, OpenAI::Models::Responses::ResponseInputAudio>] Inputs to the model - can contain template strings. Supports text, output text,
+          #   @param content [String, OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Graders::LabelModelGrader::Input::Content::OutputText, OpenAI::Models::Graders::LabelModelGrader::Input::Content::InputImage, OpenAI::Models::Responses::ResponseInputAudio, Array<String, OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Graders::GraderInputItem::OutputText, OpenAI::Models::Graders::GraderInputItem::InputImage, OpenAI::Models::Responses::ResponseInputAudio>]
+          #     Inputs to the model - can contain template strings. Supports text, output text,
+          #     input images, and input audio, either as a single item or an array of items.
           #
-          #   @param role [Symbol, OpenAI::Models::Graders::LabelModelGrader::Input::Role] The role of the message input. One of `user`, `assistant`, `system`, or
+          #   @param role [Symbol, OpenAI::Models::Graders::LabelModelGrader::Input::Role]
+          #     The role of the message input. One of `user`, `assistant`, `system`, or
+          #     `developer`.
           #
-          #   @param type [Symbol, OpenAI::Models::Graders::LabelModelGrader::Input::Type] The type of the message input. Always `message`.
+          #   @param type [Symbol, OpenAI::Models::Graders::LabelModelGrader::Input::Type]
+          #     The type of the message input. Always `message`.
 
           # Inputs to the model - can contain template strings. Supports text, output text,
           # input images, and input audio, either as a single item or an array of items.
@@ -132,15 +138,13 @@ module OpenAI
               required :type, const: :output_text
 
               # @!method initialize(text:, type: :output_text)
-              #   Some parameter documentations has been truncated, see
-              #   {OpenAI::Models::Graders::LabelModelGrader::Input::Content::OutputText} for more
-              #   details.
-              #
               #   A text output from the model.
               #
-              #   @param text [String] The text output from the model.
+              #   @param text [String]
+              #     The text output from the model.
               #
-              #   @param type [Symbol, :output_text] The type of the output text. Always `output_text`.
+              #   @param type [Symbol, :output_text]
+              #     The type of the output text. Always `output_text`.
             end
 
             class InputImage < OpenAI::Internal::Type::BaseModel
@@ -164,17 +168,17 @@ module OpenAI
               optional :detail, String
 
               # @!method initialize(image_url:, detail: nil, type: :input_image)
-              #   Some parameter documentations has been truncated, see
-              #   {OpenAI::Models::Graders::LabelModelGrader::Input::Content::InputImage} for more
-              #   details.
-              #
               #   An image input block used within EvalItem content arrays.
               #
-              #   @param image_url [String] The URL of the image input.
+              #   @param image_url [String]
+              #     The URL of the image input.
               #
-              #   @param detail [String] The detail level of the image to be sent to the model. One of `high`, `low`, or
+              #   @param detail [String]
+              #     The detail level of the image to be sent to the model. One of `high`, `low`, or
+              #     `auto`. Defaults to `auto`.
               #
-              #   @param type [Symbol, :input_image] The type of the image input. Always `input_image`.
+              #   @param type [Symbol, :input_image]
+              #     The type of the image input. Always `input_image`.
             end
 
             # @!method self.variants