Skip to main content
Microsoft Foundry
Start building
View as Markdown
Fine-tuning

Get a fine-tuning job

GET
/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}

Retrieves the specified fine-tuning job and its current status.

Path Parameters
fine_tuning_job_idstringrequired
The ID of the fine-tuning job.
Responses
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.
errorOpenAI.FineTuningJobError | nullrequired
One of the following:
OpenAI.FineTuningJobError
null
fine_tuned_modelstring | nullrequired
finished_atstring | nullrequired
hyperparametersOpenAI.FineTuningJobHyperparametersrequired
The hyperparameters used for the fine-tuning job. This value will only be returned when running supervised jobs.
batch_sizeenum
auto
learning_rate_multiplierenum
auto
n_epochsenum
auto
modelstringrequired
The base model that is being fine-tuned.
objectenumrequired
The object type, which is always "fine_tuning.job".
fine_tuning.job
organization_idstringrequired
The organization that owns the fine-tuning job.
result_filesstring[]required
The compiled results file ID(s) for the fine-tuning job. You can retrieve the results with the Files API.
statusenumrequired
The current status of the fine-tuning job, which can be either validating_files, queued, running, succeeded, failed, or cancelled.
validating_filesqueuedrunningsucceededfailedcancelled
trained_tokensinteger | nullrequired
training_filestringrequired
The file ID used for training. You can retrieve the training data with the Files API.
validation_filestring | nullrequired
integrationsOpenAI.FineTuningIntegration[] | null
One of the following:
OpenAI.FineTuningIntegration[]
null
seedintegerrequired
The seed used for the fine-tuning job.
estimated_finishstring | null
methodOpenAI.FineTuneMethod
The method used for fine-tuning.
typeenumrequired
The type of method. Is either supervised, dpo, or reinforcement.
superviseddporeinforcement
supervisedOpenAI.FineTuneSupervisedMethod
Configuration for the supervised fine-tuning method.
dpoOpenAI.FineTuneDPOMethod
Configuration for the DPO fine-tuning method.
reinforcementOpenAI.FineTuneReinforcementMethod
Configuration for the reinforcement fine-tuning method.
metadataOpenAI.Metadata | null
View as Markdown
Request
curl https://api.openai.com/v1/fine_tuning/jobs/ft-AF1WoRqd3aJAHsqc9NY7iL8F \
  -H "Authorization: Bearer $OPENAI_API_KEY"
Response
{
  "object": "fine_tuning.job",
  "id": "ftjob-abc123",
  "model": "davinci-002",
  "created_at": 1692661014,
  "finished_at": 1692661190,
  "fine_tuned_model": "ft:davinci-002:my-org:custom_suffix:7q8mpxmy",
  "organization_id": "org-123",
  "result_files": [
      "file-abc123"
  ],
  "status": "succeeded",
  "validation_file": null,
  "training_file": "file-abc123",
  "hyperparameters": {
      "n_epochs": 4,
      "batch_size": 1,
      "learning_rate_multiplier": 1.0
  },
  "trained_tokens": 5768,
  "integrations": [],
  "seed": 0,
  "estimated_finish": 0,
  "method": {
    "type": "supervised",
    "supervised": {
      "hyperparameters": {
        "n_epochs": 4,
        "batch_size": 1,
        "learning_rate_multiplier": 1.0
      }
    }
  }
}