afterstring
Identifier for the last job from the previous pagination request.
limitinteger
Number of fine-tuning jobs to retrieve.
Default:20
List your organization's fine-tuning jobs
get
https://api.openai.com/v1/fine_tuning/jobs
Query Parameters
Response
200 application/json
Response
200 application/json
OK
ListPaginatedFineTuningJobsResponse
dataarray[object]required
The fine_tuning.job object represents a fine-tuning job that has been created through the API.
Show Child Parameters
has_morebooleanrequired
objectstringrequired
Allowed values:list
get/fine_tuning/jobs
Authentication
Query Parameters
200 application/json
Get info about a fine-tuning job. [Learn more about fine-tuning](/docs/guides/fine-tuning)
get
https://api.openai.com/v1/fine_tuning/jobs/{fine_tuning_job_id}
Path Parameters
fine_tuning_job_idstringrequired
The ID of the fine-tuning job.
Example:ft-AF1WoRqd3aJAHsqc9NY7iL8F
Response
200 application/json
Response
200 application/json
OK
FineTuningJob
The fine_tuning.job object represents a fine-tuning job that has been created through the API.
idstringrequired
The object identifier, which can be referenced in the API endpoints.
created_atintegerrequired
The Unix timestamp (in seconds) for when the fine-tuning job was created.
errorobject | nullrequired
For fine-tuning jobs that have failed, this will contain more information on the cause of the failure.
Show Child Parameters
fine_tuned_modelstring | nullrequired
The name of the fine-tuned model that is being created. The value will be null if the fine-tuning job is still running.
finished_atinteger | nullrequired
The Unix timestamp (in seconds) for when the fine-tuning job was finished. The value will be null if the fine-tuning job is still running.
hyperparametersobjectrequired
The hyperparameters used for the fine-tuning job. This value will only be returned when running supervised jobs.
Show Child Parameters
modelstringrequired
The base model that is being fine-tuned.
objectstringrequired
The object type, which is always “fine_tuning.job”.
Allowed values:fine_tuning.job
organization_idstringrequired
The organization that owns the fine-tuning job.
result_filesarray[string]required
The compiled results file ID(s) for the fine-tuning job. You can retrieve the results with the Files API.
Example:file-abc123
statusstringrequired
The current status of the fine-tuning job, which can be either validating_files, queued, running, succeeded, failed, or cancelled.
Allowed values:validating_filesqueuedrunningsucceededfailedcancelled
trained_tokensinteger | nullrequired
The total number of billable tokens processed by this fine-tuning job. The value will be null if the fine-tuning job is still running.
training_filestringrequired
The file ID used for training. You can retrieve the training data with the Files API.
validation_filestring | nullrequired
The file ID used for validation. You can retrieve the validation results with the Files API.
integrations
One Ofarray | null
A list of integrations to enable for this fine-tuning job.
<= 5 items
Fine-Tuning Job Integrationobject
Show Child Parameters
seedintegerrequired
The seed used for the fine-tuning job.
estimated_finishinteger | null
The Unix timestamp (in seconds) for when the fine-tuning job is estimated to finish. The value will be null if the fine-tuning job is not running.
methodobject
The method used for fine-tuning.
Show Child Parameters
get/fine_tuning/jobs/{fine_tuning_job_id}
Authentication
Path Parameters
200 application/json
Immediately cancel a fine-tune job.
post
https://api.openai.com/v1/fine_tuning/jobs/{fine_tuning_job_id}/cancel
Path Parameters
fine_tuning_job_idstringrequired
The ID of the fine-tuning job to cancel.
Example:ft-AF1WoRqd3aJAHsqc9NY7iL8F
Response
200 application/json
Response
200 application/json
OK
FineTuningJob
The fine_tuning.job object represents a fine-tuning job that has been created through the API.
idstringrequired
The object identifier, which can be referenced in the API endpoints.
created_atintegerrequired
The Unix timestamp (in seconds) for when the fine-tuning job was created.
errorobject | nullrequired
For fine-tuning jobs that have failed, this will contain more information on the cause of the failure.
Show Child Parameters
fine_tuned_modelstring | nullrequired
The name of the fine-tuned model that is being created. The value will be null if the fine-tuning job is still running.
finished_atinteger | nullrequired
The Unix timestamp (in seconds) for when the fine-tuning job was finished. The value will be null if the fine-tuning job is still running.
hyperparametersobjectrequired
The hyperparameters used for the fine-tuning job. This value will only be returned when running supervised jobs.
Show Child Parameters
modelstringrequired
The base model that is being fine-tuned.
objectstringrequired
The object type, which is always “fine_tuning.job”.
Allowed values:fine_tuning.job
organization_idstringrequired
The organization that owns the fine-tuning job.
result_filesarray[string]required
The compiled results file ID(s) for the fine-tuning job. You can retrieve the results with the Files API.
Example:file-abc123
statusstringrequired
The current status of the fine-tuning job, which can be either validating_files, queued, running, succeeded, failed, or cancelled.
Allowed values:validating_filesqueuedrunningsucceededfailedcancelled
trained_tokensinteger | nullrequired
The total number of billable tokens processed by this fine-tuning job. The value will be null if the fine-tuning job is still running.
training_filestringrequired
The file ID used for training. You can retrieve the training data with the Files API.
validation_filestring | nullrequired
The file ID used for validation. You can retrieve the validation results with the Files API.
integrations
One Ofarray | null
A list of integrations to enable for this fine-tuning job.
<= 5 items
Fine-Tuning Job Integrationobject
Show Child Parameters
seedintegerrequired
The seed used for the fine-tuning job.
estimated_finishinteger | null
The Unix timestamp (in seconds) for when the fine-tuning job is estimated to finish. The value will be null if the fine-tuning job is not running.
methodobject
The method used for fine-tuning.
Show Child Parameters
post/fine_tuning/jobs/{fine_tuning_job_id}/cancel
Authentication
Path Parameters
200 application/json
List checkpoints for a fine-tuning job.
get
https://api.openai.com/v1/fine_tuning/jobs/{fine_tuning_job_id}/checkpoints
Query Parameters
afterstring
Identifier for the last checkpoint ID from the previous pagination request.
limitinteger
Number of checkpoints to retrieve.
Default:10
Path Parameters
fine_tuning_job_idstringrequired
The ID of the fine-tuning job to get checkpoints for.
Example:ft-AF1WoRqd3aJAHsqc9NY7iL8F
Response
200 application/json
Response
200 application/json
OK
ListFineTuningJobCheckpointsResponse
dataarray[object]required
The fine_tuning.job.checkpoint object represents a model checkpoint for a fine-tuning job that is ready to use.
Show Child Parameters
objectstringrequired
Allowed values:list
first_idstring | null
last_idstring | null
has_morebooleanrequired
get/fine_tuning/jobs/{fine_tuning_job_id}/checkpoints
Authentication
Path Parameters
Query Parameters
200 application/json
Get status updates for a fine-tuning job.
get
https://api.openai.com/v1/fine_tuning/jobs/{fine_tuning_job_id}/events
Query Parameters
afterstring
Identifier for the last event from the previous pagination request.
limitinteger
Number of events to retrieve.
Default:20
Path Parameters
fine_tuning_job_idstringrequired
The ID of the fine-tuning job to get events for.
Example:ft-AF1WoRqd3aJAHsqc9NY7iL8F
Response
200 application/json
Response
200 application/json
OK
ListFineTuningJobEventsResponse
dataarray[object]required
Fine-tuning job event object
Show Child Parameters
objectstringrequired
Allowed values:list
has_morebooleanrequired
get/fine_tuning/jobs/{fine_tuning_job_id}/events
Authentication
Path Parameters
Query Parameters
200 application/json