POST
/
training
/
jobs
curl --request POST \
  --url https://api.bluesight.ai/training/jobs \
  --header 'Content-Type: application/json' \
  --data '{
  "task": "classification",
  "training_file": "file-lw3zjxrg"
}'
{
  "created_at": 1723402651,
  "finished_at": 1723402657,
  "id": "trainingjob-g0mos7xr",
  "status": "succeeded",
  "task": "classification",
  "trained_model": "model-3b05uri7",
  "training_file": "file-lw3zjxrg"
}

Body

application/json
​
task
enum<string>
required

The task type, which can be either classification or segmentation.

Available options:
classification,
segmentation
​
training_file
string
required

The ID of an uploaded file that contains training data.

See upload file for how to upload a file.

​
validation_file
string | null

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.

​
hyperparameters
object | null

The hyperparameters used for the training job.

Example:
{ "num_classes": 3 }

Response

200
application/json
Successful Response
​
task
enum<string>
required

The task type, which can be either classification or segmentation.

Available options:
classification,
segmentation
​
training_file
string
required

The ID of an uploaded file that contains training data.

See upload file for how to upload a file.

​
id
string
required

The object identifier, which can be referenced in the API endpoints.

​
created_at
integer
required

The Unix timestamp (in seconds) for when the training job was created.

​
status
enum<string>
required

The current status of the training job, which can be either initializing, downloading_files, validating_files, queued, running, succeeded, failed, or cancelled.

Available options:
initializing,
downloading_files,
validating_files,
queued,
running,
succeeded,
failed,
cancelled
​
validation_file
string | null

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.

​
hyperparameters
object | null

The hyperparameters used for the training job.

Example:
{ "num_classes": 3 }
​
error
string | null

For training jobs that have failed, this will contain more information on the cause of the failure.

​
trained_model
string | null

The name of the trained model that is being created.

The value will be null if the training job is still running.

​
finished_at
integer | null

The Unix timestamp (in seconds) for when the training job was finished.

The value will be null if the training job is still running.

Retrieve Training Job