Skip to main content
POST

Authorizations

Authorization
string
header
default:default
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Fine-tune ID to cancel. A string that starts with ft-.

Response

Successfully cancelled the fine-tuning job.

A truncated version of the fine-tune response, used for POST /fine-tunes, GET /fine-tunes and POST /fine-tunes/{id}/cancel endpoints

id
string
required

Unique identifier for the fine-tune job

status
enum<string>
required
Available options:
pending,
queued,
running,
compressing,
uploading,
cancel_requested,
cancelled,
error,
completed
created_at
string<date-time>
required

Creation timestamp of the fine-tune job

updated_at
string<date-time>
required

Last update timestamp of the fine-tune job

user_id
string
required

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

started_at
string<date-time>

Start timestamp of the current stage of the fine-tune job

owner_address
string

Owner address information

total_price
integer

Total price for the fine-tuning job

token_count
integer

Count of tokens processed

events
object[]

Events related to this fine-tune job

training_file
string

File-ID of the training file

validation_file
string

File-ID of the validation file

packing
boolean

Whether sequence packing is being used for training.

max_seq_length
integer

Maximum sequence length to use for training. If not specified, uses the maximum allowed for the model and training method.

model
string

Base model used for fine-tuning

model_output_name
string
suffix
string

Suffix added to the fine-tuned model name

n_epochs
integer

Number of training epochs

n_evals
integer

Number of evaluations during training

n_checkpoints
integer

Number of checkpoints saved during training

batch_size
integer

Batch size used for training

training_type
object

Type of training used (full or LoRA)

training_method
object

Method of training used

learning_rate
number

Learning rate used for training

lr_scheduler
object

Learning rate scheduler configuration

warmup_ratio
number

Ratio of warmup steps

max_grad_norm
number

Maximum gradient norm for clipping

weight_decay
number

Weight decay value used

random_seed
integer | null

Random seed used for training. Integer when set; null if not stored (e.g. legacy jobs) or no explicit seed was recorded.

wandb_project_name
string

Weights & Biases project name

wandb_name
string

Weights & Biases run name

from_checkpoint
string

Checkpoint used to continue training

from_hf_model
string

Hugging Face Hub repo to start training from

hf_model_revision
string

The revision of the Hugging Face Hub model to continue training from

progress
object

Progress information for the fine-tuning job

early_stopped
boolean

Whether the early-stopping criterion triggered.

early_stopping_best_step
integer

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_metric
number | null

Best validation loss observed, corresponding to early_stopping_best_step. Null if no improving evaluation was recorded.