# Start Training

Start model training. Training duration is typically 1-3 hours. The associated dataset must have a status of 'completed' before training can begin.


* The dataset must be in a 'completed' status.
* Advanced training parameters (, , , , ) are only supported when the model's  is set to 'expert'.


Endpoint: POST /tailored-gen/models/{model_id}/start_training

## Path parameters:

  - `model_id` (integer, required)
    Model ID

## Header parameters:

  - `api_token` (string, required)

## Request fields (application/json):

  - `lr_scheduler` (string)
    The learning rate scheduler used to adjust the learning rate throughout the training process. This parameter is only supported when  is 'expert'.
    Enum: "linear", "cosine", "cosine_with_restarts", "polynomial", "constant", "constant_with_warmup"

  - `learning_rate` (number)
    The initial learning rate used for optimizing the model weights during training. This parameter is only supported when  is 'expert'.

  - `total_training_steps` (number)
    The total number of training optimization steps the model will perform. This parameter is only supported when  is 'expert'. If both  and  are provided,  will be used.

  - `rank` (integer)
    The rank (latent dimension) for the model training. A higher rank value can lead to better fidelity but also increases training time and memory usage. This parameter is only supported when  is 'expert'.

  - `checkpoint_interval` (integer)
    The interval (in steps) at which model checkpoints are saved. can not be higher than the total training steps. Checkpoints are only saved when  is 'expert'.

  - `max_train_steps` (number)
    Deprecated. Please use  instead. The total number of training optimization steps the model will perform. This parameter is only supported when  is 'expert'.

## Response 200 fields (application/json):

  - `id` (integer)
    Unique identifier for the model.

  - `name` (string)
    Name of the model.

  - `description` (string)
    Description of the model.

  - `status` (string)
    Status of the model.
    Enum: "InProgress"

  - `dataset_id` (integer)
    ID of the dataset used for training.

  - `training_version` (string)
    The training version of the model.

  - `training_mode` (string)
    The training mode of the model.

  - `generation_prefix` (string)
    The text automatically prepended to generation prompts.

  - `project_id` (integer)
    ID of the project this model belongs to.

  - `created_at` (string)
    Timestamp when the model was created.

  - `updated_at` (string)
    Timestamp when the model was last updated.

  - `custom_metadata` (string)
    Custom metadata associated with the model.

  - `active_model_version` (string)
    The active version of the model.

  - `training_parameters` (object)
    The training parameters used for the model.

  - `training_parameters.learning_rate` (number)

  - `training_parameters.lr_scheduler` (string)

  - `training_parameters.rank` (integer)

  - `training_parameters.total_training_steps` (integer)

  - `training_parameters.checkpoint_interval` (integer)

  - `checkpoint_steps` (array)
    A list of checkpoint steps for the model.