openai 0.91.0 → 0.93.0

data/sig/openai/models/fine_tuning/fine_tuning_job_wandb_integration.rbs

@@ -12,16 +12,41 @@ module OpenAI
         }
 
       class FineTuningJobWandbIntegration < OpenAI::Internal::Type::BaseModel
+        # The name of the project that the new run will be created under.
         attr_accessor project: String
 
+        # 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.
         attr_accessor entity: String?
 
+        # A display name to set for the run. If not set, we will use the Job ID as the
+        # name.
         attr_accessor name: 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}".
         attr_reader 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}".
         def tags=: (::Array[String]) -> ::Array[String]
 
+        # @param project
+        #   The name of the project that the new run will be created under.
+        # @param entity
+        #   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
+        #   A display name to set for the run. If not set, we will use the Job ID as the
+        #   name.
+        # @param tags
+        #   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}".
         def initialize: (
           project: String,
           ?entity: String?,

data/sig/openai/models/fine_tuning/fine_tuning_job_wandb_integration_object.rbs

@@ -10,10 +10,22 @@ module OpenAI
         }
 
       class FineTuningJobWandbIntegrationObject < OpenAI::Internal::Type::BaseModel
+        # The type of the integration being enabled for the fine-tuning job
         attr_accessor type: :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.
         attr_accessor wandb: OpenAI::FineTuning::FineTuningJobWandbIntegration
 
+        # @param 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 type
+        #   The type of the integration being enabled for the fine-tuning job
         def initialize: (
           wandb: OpenAI::FineTuning::FineTuningJobWandbIntegration,
           ?type: :wandb

data/sig/openai/models/fine_tuning/job_create_params.rbs

@@ -19,32 +19,148 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # 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).
         attr_accessor model: OpenAI::Models::FineTuning::JobCreateParams::model
 
+        # 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.
+        #
+        # 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://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.
+        #
+        # See the
+        # [fine-tuning guide](https://developers.openai.com/api/docs/guides/model-optimization)
+        # for more details.
         attr_accessor training_file: String
 
+        # 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.
         attr_reader hyperparameters: OpenAI::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.
         def hyperparameters=: (
           OpenAI::FineTuning::JobCreateParams::Hyperparameters
         ) -> OpenAI::FineTuning::JobCreateParams::Hyperparameters
 
+        # A list of integrations to enable for your fine-tuning job.
         attr_accessor integrations: ::Array[OpenAI::FineTuning::JobCreateParams::Integration]?
 
+        # 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?
 
+        # The method used for fine-tuning.
         attr_reader method_: OpenAI::FineTuning::JobCreateParams::Method?
 
+        # The method used for fine-tuning.
         def method_=: (
           OpenAI::FineTuning::JobCreateParams::Method
         ) -> OpenAI::FineTuning::JobCreateParams::Method
 
+        # 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.
         attr_accessor seed: Integer?
 
+        # 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`.
         attr_accessor suffix: String?
 
+        # 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.
         attr_accessor validation_file: String?
 
+        # @param 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 training_file
+        #   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.
+        #
+        #   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://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.
+        #
+        #   See the
+        #   [fine-tuning guide](https://developers.openai.com/api/docs/guides/model-optimization)
+        #   for more details.
+        # @param 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 integrations
+        #   A list of integrations to enable for your fine-tuning job.
+        # @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 method_
+        #   The method used for fine-tuning.
+        # @param seed
+        #   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
+        #   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
+        #   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.
         def initialize: (
           model: OpenAI::Models::FineTuning::JobCreateParams::model,
           training_file: String,
@@ -97,24 +213,45 @@ module OpenAI
           }
 
         class Hyperparameters < OpenAI::Internal::Type::BaseModel
+          # Number of examples in each batch. A larger batch size means that model
+          # parameters are updated less frequently, but with lower variance.
           attr_reader batch_size: OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::batch_size?
 
+          # Number of examples in each batch. A larger batch size means that model
+          # parameters are updated less frequently, but with lower variance.
           def batch_size=: (
             OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::batch_size
           ) -> OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::batch_size
 
+          # Scaling factor for the learning rate. A smaller learning rate may be useful to
+          # avoid overfitting.
           attr_reader learning_rate_multiplier: OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::learning_rate_multiplier?
 
+          # Scaling factor for the learning rate. A smaller learning rate may be useful to
+          # avoid overfitting.
           def learning_rate_multiplier=: (
             OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::learning_rate_multiplier
           ) -> OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::learning_rate_multiplier
 
+          # The number of epochs to train the model for. An epoch refers to one full cycle
+          # through the training dataset.
           attr_reader n_epochs: OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::n_epochs?
 
+          # The number of epochs to train the model for. An epoch refers to one full cycle
+          # through the training dataset.
           def n_epochs=: (
             OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::n_epochs
           ) -> OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::n_epochs
 
+          # @param batch_size
+          #   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
+          #   Scaling factor for the learning rate. A smaller learning rate may be useful to
+          #   avoid overfitting.
+          # @param n_epochs
+          #   The number of epochs to train the model for. An epoch refers to one full cycle
+          #   through the training dataset.
           def initialize: (
             ?batch_size: OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::batch_size,
             ?learning_rate_multiplier: OpenAI::Models::FineTuning::JobCreateParams::Hyperparameters::learning_rate_multiplier,
@@ -159,10 +296,24 @@ module OpenAI
           }
 
         class Integration < OpenAI::Internal::Type::BaseModel
+          # The type of integration to enable. Currently, only "wandb" (Weights and Biases)
+          # is supported.
           attr_accessor type: :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.
           attr_accessor wandb: OpenAI::FineTuning::JobCreateParams::Integration::Wandb
 
+          # @param 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 type
+          #   The type of integration to enable. Currently, only "wandb" (Weights and Biases)
+          #   is supported.
           def initialize: (
             wandb: OpenAI::FineTuning::JobCreateParams::Integration::Wandb,
             ?type: :wandb
@@ -182,16 +333,41 @@ module OpenAI
             }
 
           class Wandb < OpenAI::Internal::Type::BaseModel
+            # The name of the project that the new run will be created under.
             attr_accessor project: String
 
+            # 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.
             attr_accessor entity: String?
 
+            # A display name to set for the run. If not set, we will use the Job ID as the
+            # name.
             attr_accessor name: 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}".
             attr_reader 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}".
             def tags=: (::Array[String]) -> ::Array[String]
 
+            # @param project
+            #   The name of the project that the new run will be created under.
+            # @param entity
+            #   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
+            #   A display name to set for the run. If not set, we will use the Job ID as the
+            #   name.
+            # @param tags
+            #   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}".
             def initialize: (
               project: String,
               ?entity: String?,
@@ -217,26 +393,41 @@ module OpenAI
           }
 
         class Method < OpenAI::Internal::Type::BaseModel
+          # The type of method. Is either `supervised`, `dpo`, or `reinforcement`.
           attr_accessor type: OpenAI::Models::FineTuning::JobCreateParams::Method::type_
 
+          # Configuration for the DPO fine-tuning method.
           attr_reader dpo: OpenAI::FineTuning::DpoMethod?
 
+          # Configuration for the DPO fine-tuning method.
           def dpo=: (
             OpenAI::FineTuning::DpoMethod
           ) -> OpenAI::FineTuning::DpoMethod
 
+          # Configuration for the reinforcement fine-tuning method.
           attr_reader reinforcement: OpenAI::FineTuning::ReinforcementMethod?
 
+          # Configuration for the reinforcement fine-tuning method.
           def reinforcement=: (
             OpenAI::FineTuning::ReinforcementMethod
           ) -> OpenAI::FineTuning::ReinforcementMethod
 
+          # Configuration for the supervised fine-tuning method.
           attr_reader supervised: OpenAI::FineTuning::SupervisedMethod?
 
+          # Configuration for the supervised fine-tuning method.
           def supervised=: (
             OpenAI::FineTuning::SupervisedMethod
           ) -> OpenAI::FineTuning::SupervisedMethod
 
+          # @param type
+          #   The type of method. Is either `supervised`, `dpo`, or `reinforcement`.
+          # @param dpo
+          #   Configuration for the DPO fine-tuning method.
+          # @param reinforcement
+          #   Configuration for the reinforcement fine-tuning method.
+          # @param supervised
+          #   Configuration for the supervised fine-tuning method.
           def initialize: (
             type: OpenAI::Models::FineTuning::JobCreateParams::Method::type_,
             ?dpo: OpenAI::FineTuning::DpoMethod,

data/sig/openai/models/fine_tuning/job_list_events_params.rbs

@@ -15,14 +15,22 @@ module OpenAI
 
         attr_accessor fine_tuning_job_id: String
 
+        # Identifier for the last event from the previous pagination request.
         attr_reader after: String?
 
+        # Identifier for the last event from the previous pagination request.
         def after=: (String) -> String
 
+        # Number of events to retrieve.
         attr_reader limit: Integer?
 
+        # Number of events to retrieve.
         def limit=: (Integer) -> Integer
 
+        # @param after
+        #   Identifier for the last event from the previous pagination request.
+        # @param limit
+        #   Number of events to retrieve.
         def initialize: (
           fine_tuning_job_id: String,
           ?after: String,

data/sig/openai/models/fine_tuning/job_list_params.rbs

@@ -13,16 +13,29 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # Identifier for the last job from the previous pagination request.
         attr_reader after: String?
 
+        # Identifier for the last job from the previous pagination request.
         def after=: (String) -> String
 
+        # Number of fine-tuning jobs to retrieve.
         attr_reader limit: Integer?
 
+        # Number of fine-tuning jobs to retrieve.
         def limit=: (Integer) -> Integer
 
+        # Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
+        # Alternatively, set `metadata=null` to indicate no metadata.
         attr_accessor metadata: ::Hash[Symbol, String]?
 
+        # @param after
+        #   Identifier for the last job from the previous pagination request.
+        # @param limit
+        #   Number of fine-tuning jobs to retrieve.
+        # @param metadata
+        #   Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
+        #   Alternatively, set `metadata=null` to indicate no metadata.
         def initialize: (
           ?after: String,
           ?limit: Integer,

data/sig/openai/models/fine_tuning/jobs/checkpoint_list_params.rbs

@@ -16,14 +16,22 @@ module OpenAI
 
           attr_accessor fine_tuning_job_id: String
 
+          # Identifier for the last checkpoint ID from the previous pagination request.
           attr_reader after: String?
 
+          # Identifier for the last checkpoint ID from the previous pagination request.
           def after=: (String) -> String
 
+          # Number of checkpoints to retrieve.
           attr_reader limit: Integer?
 
+          # Number of checkpoints to retrieve.
           def limit=: (Integer) -> Integer
 
+          # @param after
+          #   Identifier for the last checkpoint ID from the previous pagination request.
+          # @param limit
+          #   Number of checkpoints to retrieve.
           def initialize: (
             fine_tuning_job_id: String,
             ?after: String,

data/sig/openai/models/fine_tuning/jobs/fine_tuning_job_checkpoint.rbs

@@ -14,20 +14,41 @@ module OpenAI
           }
 
         class FineTuningJobCheckpoint < OpenAI::Internal::Type::BaseModel
+          # The checkpoint identifier, which can be referenced in the API endpoints.
           attr_accessor id: String
 
+          # The Unix timestamp (in seconds) for when the checkpoint was created.
           attr_accessor created_at: Integer
 
+          # The name of the fine-tuned checkpoint model that is created.
           attr_accessor fine_tuned_model_checkpoint: String
 
+          # The name of the fine-tuning job that this checkpoint was created from.
           attr_accessor fine_tuning_job_id: String
 
+          # Metrics at the step number during the fine-tuning job.
           attr_accessor metrics: OpenAI::FineTuning::Jobs::FineTuningJobCheckpoint::Metrics
 
+          # The object type, which is always "fine_tuning.job.checkpoint".
           attr_accessor object: :"fine_tuning.job.checkpoint"
 
+          # The step number that the checkpoint was created at.
           attr_accessor step_number: Integer
 
+          # @param id
+          #   The checkpoint identifier, which can be referenced in the API endpoints.
+          # @param created_at
+          #   The Unix timestamp (in seconds) for when the checkpoint was created.
+          # @param fine_tuned_model_checkpoint
+          #   The name of the fine-tuned checkpoint model that is created.
+          # @param fine_tuning_job_id
+          #   The name of the fine-tuning job that this checkpoint was created from.
+          # @param metrics
+          #   Metrics at the step number during the fine-tuning job.
+          # @param step_number
+          #   The step number that the checkpoint was created at.
+          # @param object
+          #   The object type, which is always "fine_tuning.job.checkpoint".
           def initialize: (
             id: String,
             created_at: Integer,

data/sig/openai/models/fine_tuning/reinforcement_hyperparameters.rbs

@@ -13,48 +13,85 @@ module OpenAI
         }
 
       class ReinforcementHyperparameters < OpenAI::Internal::Type::BaseModel
+        # Number of examples in each batch. A larger batch size means that model
+        # parameters are updated less frequently, but with lower variance.
         attr_reader batch_size: OpenAI::Models::FineTuning::ReinforcementHyperparameters::batch_size?
 
+        # Number of examples in each batch. A larger batch size means that model
+        # parameters are updated less frequently, but with lower variance.
         def batch_size=: (
           OpenAI::Models::FineTuning::ReinforcementHyperparameters::batch_size
         ) -> OpenAI::Models::FineTuning::ReinforcementHyperparameters::batch_size
 
+        # Multiplier on amount of compute used for exploring search space during training.
         attr_reader compute_multiplier: OpenAI::Models::FineTuning::ReinforcementHyperparameters::compute_multiplier?
 
+        # Multiplier on amount of compute used for exploring search space during training.
         def compute_multiplier=: (
           OpenAI::Models::FineTuning::ReinforcementHyperparameters::compute_multiplier
         ) -> OpenAI::Models::FineTuning::ReinforcementHyperparameters::compute_multiplier
 
+        # The number of training steps between evaluation runs.
         attr_reader eval_interval: OpenAI::Models::FineTuning::ReinforcementHyperparameters::eval_interval?
 
+        # The number of training steps between evaluation runs.
         def eval_interval=: (
           OpenAI::Models::FineTuning::ReinforcementHyperparameters::eval_interval
         ) -> OpenAI::Models::FineTuning::ReinforcementHyperparameters::eval_interval
 
+        # Number of evaluation samples to generate per training step.
         attr_reader eval_samples: OpenAI::Models::FineTuning::ReinforcementHyperparameters::eval_samples?
 
+        # Number of evaluation samples to generate per training step.
         def eval_samples=: (
           OpenAI::Models::FineTuning::ReinforcementHyperparameters::eval_samples
         ) -> OpenAI::Models::FineTuning::ReinforcementHyperparameters::eval_samples
 
+        # Scaling factor for the learning rate. A smaller learning rate may be useful to
+        # avoid overfitting.
         attr_reader learning_rate_multiplier: OpenAI::Models::FineTuning::ReinforcementHyperparameters::learning_rate_multiplier?
 
+        # Scaling factor for the learning rate. A smaller learning rate may be useful to
+        # avoid overfitting.
         def learning_rate_multiplier=: (
           OpenAI::Models::FineTuning::ReinforcementHyperparameters::learning_rate_multiplier
         ) -> OpenAI::Models::FineTuning::ReinforcementHyperparameters::learning_rate_multiplier
 
+        # The number of epochs to train the model for. An epoch refers to one full cycle
+        # through the training dataset.
         attr_reader n_epochs: OpenAI::Models::FineTuning::ReinforcementHyperparameters::n_epochs?
 
+        # The number of epochs to train the model for. An epoch refers to one full cycle
+        # through the training dataset.
         def n_epochs=: (
           OpenAI::Models::FineTuning::ReinforcementHyperparameters::n_epochs
         ) -> OpenAI::Models::FineTuning::ReinforcementHyperparameters::n_epochs
 
+        # Level of reasoning effort.
         attr_reader reasoning_effort: OpenAI::Models::FineTuning::ReinforcementHyperparameters::reasoning_effort?
 
+        # Level of reasoning effort.
         def reasoning_effort=: (
           OpenAI::Models::FineTuning::ReinforcementHyperparameters::reasoning_effort
         ) -> OpenAI::Models::FineTuning::ReinforcementHyperparameters::reasoning_effort
 
+        # @param batch_size
+        #   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
+        #   Multiplier on amount of compute used for exploring search space during training.
+        # @param eval_interval
+        #   The number of training steps between evaluation runs.
+        # @param eval_samples
+        #   Number of evaluation samples to generate per training step.
+        # @param learning_rate_multiplier
+        #   Scaling factor for the learning rate. A smaller learning rate may be useful to
+        #   avoid overfitting.
+        # @param n_epochs
+        #   The number of epochs to train the model for. An epoch refers to one full cycle
+        #   through the training dataset.
+        # @param reasoning_effort
+        #   Level of reasoning effort.
         def initialize: (
           ?batch_size: OpenAI::Models::FineTuning::ReinforcementHyperparameters::batch_size,
           ?compute_multiplier: OpenAI::Models::FineTuning::ReinforcementHyperparameters::compute_multiplier,

data/sig/openai/models/fine_tuning/reinforcement_method.rbs

@@ -8,14 +8,21 @@ module OpenAI
         }
 
       class ReinforcementMethod < OpenAI::Internal::Type::BaseModel
+        # The grader used for the fine-tuning job.
         attr_accessor grader: OpenAI::Models::FineTuning::ReinforcementMethod::grader
 
+        # The hyperparameters used for the reinforcement fine-tuning job.
         attr_reader hyperparameters: OpenAI::FineTuning::ReinforcementHyperparameters?
 
+        # The hyperparameters used for the reinforcement fine-tuning job.
         def hyperparameters=: (
           OpenAI::FineTuning::ReinforcementHyperparameters
         ) -> OpenAI::FineTuning::ReinforcementHyperparameters
 
+        # @param grader
+        #   The grader used for the fine-tuning job.
+        # @param hyperparameters
+        #   The hyperparameters used for the reinforcement fine-tuning job.
         def initialize: (
           grader: OpenAI::Models::FineTuning::ReinforcementMethod::grader,
           ?hyperparameters: OpenAI::FineTuning::ReinforcementHyperparameters

data/sig/openai/models/fine_tuning/supervised_hyperparameters.rbs

@@ -9,24 +9,45 @@ module OpenAI
         }
 
       class SupervisedHyperparameters < OpenAI::Internal::Type::BaseModel
+        # Number of examples in each batch. A larger batch size means that model
+        # parameters are updated less frequently, but with lower variance.
         attr_reader batch_size: OpenAI::Models::FineTuning::SupervisedHyperparameters::batch_size?
 
+        # Number of examples in each batch. A larger batch size means that model
+        # parameters are updated less frequently, but with lower variance.
         def batch_size=: (
           OpenAI::Models::FineTuning::SupervisedHyperparameters::batch_size
         ) -> OpenAI::Models::FineTuning::SupervisedHyperparameters::batch_size
 
+        # Scaling factor for the learning rate. A smaller learning rate may be useful to
+        # avoid overfitting.
         attr_reader learning_rate_multiplier: OpenAI::Models::FineTuning::SupervisedHyperparameters::learning_rate_multiplier?
 
+        # Scaling factor for the learning rate. A smaller learning rate may be useful to
+        # avoid overfitting.
         def learning_rate_multiplier=: (
           OpenAI::Models::FineTuning::SupervisedHyperparameters::learning_rate_multiplier
         ) -> OpenAI::Models::FineTuning::SupervisedHyperparameters::learning_rate_multiplier
 
+        # The number of epochs to train the model for. An epoch refers to one full cycle
+        # through the training dataset.
         attr_reader n_epochs: OpenAI::Models::FineTuning::SupervisedHyperparameters::n_epochs?
 
+        # The number of epochs to train the model for. An epoch refers to one full cycle
+        # through the training dataset.
         def n_epochs=: (
           OpenAI::Models::FineTuning::SupervisedHyperparameters::n_epochs
         ) -> OpenAI::Models::FineTuning::SupervisedHyperparameters::n_epochs
 
+        # @param batch_size
+        #   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
+        #   Scaling factor for the learning rate. A smaller learning rate may be useful to
+        #   avoid overfitting.
+        # @param n_epochs
+        #   The number of epochs to train the model for. An epoch refers to one full cycle
+        #   through the training dataset.
         def initialize: (
           ?batch_size: OpenAI::Models::FineTuning::SupervisedHyperparameters::batch_size,
           ?learning_rate_multiplier: OpenAI::Models::FineTuning::SupervisedHyperparameters::learning_rate_multiplier,

data/sig/openai/models/fine_tuning/supervised_method.rbs

@@ -5,12 +5,16 @@ module OpenAI
         { ?hyperparameters: OpenAI::FineTuning::SupervisedHyperparameters }
 
       class SupervisedMethod < OpenAI::Internal::Type::BaseModel
+        # The hyperparameters used for the fine-tuning job.
         attr_reader hyperparameters: OpenAI::FineTuning::SupervisedHyperparameters?
 
+        # The hyperparameters used for the fine-tuning job.
         def hyperparameters=: (
           OpenAI::FineTuning::SupervisedHyperparameters
         ) -> OpenAI::FineTuning::SupervisedHyperparameters
 
+        # @param hyperparameters
+        #   The hyperparameters used for the fine-tuning job.
         def initialize: (
           ?hyperparameters: OpenAI::FineTuning::SupervisedHyperparameters
         ) -> void