Fine-tuning

List job

Changed on

List the metadata for a single fine-tuning job.

get/v1/fine-tunes/{id}

Request

  • Base URL
    https://api.together.ai
  • URL
    https://api.together.ai/v1/fine-tunes/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The ID of the job to retrieve

Response

Fine-tune job details retrieved successfully

idstring uuid required
training_filestring
validation_filestring
modelstring
model_output_namestring
model_output_pathstring
tokenized_dataset_pathstring

Storage path for the tokenized dataset archive generated for this fine-tune job.

tokenized_dataset_uploaded_atstring date-time

Timestamp when the tokenized dataset archive was uploaded.

model_object_idstring

Together model registry object ID for the final model weights (e.g. ml_...).

model_object_namestring

Together model registry name for the final model weights, formatted as <project_slug>/<model_name>.

model_object_revision_idstring

Together model registry revision ID for the final model weights (e.g. rv_...).

adapter_object_idstring

Together model registry object ID for the final adapter weights on LoRA jobs.

adapter_object_namestring

Together model registry name for the final adapter weights on LoRA jobs, formatted as <project_slug>/<model_name>-adapter.

adapter_object_revision_idstring

Together model registry revision ID for the final adapter weights on LoRA jobs.

user_idstring required

ID of the user who created the fine-tune job.

trainingfile_numlinesinteger
trainingfile_sizeinteger
created_atstring date-time
updated_atstring date-time
started_atstring date-time
n_epochsinteger
n_checkpointsinteger
n_evalsinteger
learning_ratenumber
warmup_rationumber
max_grad_normnumber
weight_decaynumber
eval_stepsinteger
status'pending' | 'queued' | 'running' | 'compressing' | 'uploading' | 'cancel_requested' | 'cancelled' | 'error' | 'completed' required
job_idstring
token_countinteger
param_countinteger
total_priceinteger
epochs_completedinteger
queue_depthinteger
wandb_project_namestring
wandb_urlstring
from_checkpointstring
from_hf_modelstring
hf_model_revisionstring
early_stoppedboolean

Whether the early-stopping criterion triggered.

early_stopping_best_stepinteger

Step associated with the selected early-stopping artifact. When early_stopping_best_metric is null, no finite best metric was recorded; this is the halt step, not a best-checkpoint step.

early_stopping_best_metricnumber nullable

Best validation loss observed, corresponding to early_stopping_best_step. Null if no improving evaluation was recorded (for example, a non-finite first evaluation).

Changes