API Reference

Fine Tuning

Jobs

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List fine-tuning jobs

fine_tuning.jobs.list(**kwargs) -> CursorPage<FineTuningJob { id, created_at, error, 16 more } >

GET/fine_tuning/jobs

List your organization’s fine-tuning jobs

ParametersExpand Collapse

after: String

Identifier for the last job from the previous pagination request.

limit: Integer

Number of fine-tuning jobs to retrieve.

metadata: Hash[Symbol, String]

Optional metadata filter. To filter, use the syntax metadata[k]=v. Alternatively, set metadata=null to indicate no metadata.

ReturnsExpand Collapse

class FineTuningJob { id, created_at, error, 16 more }

The fine_tuning.job object represents a fine-tuning job that has been created through the API.

id: String

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

created_at: Integer

The Unix timestamp (in seconds) for when the fine-tuning job was created.

formatunixtime

error: Error{ code, message, param}

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

fine_tuned_model: String

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_at: Integer

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.

formatunixtime

hyperparameters: Hyperparameters{ batch_size, learning_rate_multiplier, n_epochs}

The hyperparameters used for the fine-tuning job. This value will only be returned when running supervised jobs.

model: String

The base model that is being fine-tuned.

object: :"fine_tuning.job"

The object type, which is always “fine_tuning.job”.

organization_id: String

The organization that owns the fine-tuning job.

result_files: Array[String]

The compiled results file ID(s) for the fine-tuning job. You can retrieve the results with the Files API.

seed: Integer

The seed used for the fine-tuning job.

status: :validating_files | :queued | :running | 3 more

The current status of the fine-tuning job, which can be either validating_files, queued, running, succeeded, failed, or cancelled.

trained_tokens: Integer

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_file: String

The file ID used for training. You can retrieve the training data with the Files API.

validation_file: String

The file ID used for validation. You can retrieve the validation results with the Files API.

estimated_finish: Integer

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.

formatunixtime

integrations: Array[FineTuningJobWandbIntegrationObject { type, wandb } ]

A list of integrations to enable for this fine-tuning job.

metadata: Metadata

Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard.

Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.

method_: Method{ type, dpo, reinforcement, supervised}

The method used for fine-tuning.

List fine-tuning jobs

Ruby

HTTP

Python

TypeScript

Go

Ruby

Java

CLI Tool

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

page = openai.fine_tuning.jobs.list

puts(page)

{
  "object": "list",
  "data": [
    {
      "object": "fine_tuning.job",
      "id": "ftjob-abc123",
      "model": "gpt-4o-mini-2024-07-18",
      "created_at": 1721764800,
      "fine_tuned_model": null,
      "organization_id": "org-123",
      "result_files": [],
      "status": "queued",
      "validation_file": null,
      "training_file": "file-abc123",
      "metadata": {
        "key": "value"
      }
    },
    { ... },
    { ... }
  ], "has_more": true
}

Returns Examples

{
  "object": "list",
  "data": [
    {
      "object": "fine_tuning.job",
      "id": "ftjob-abc123",
      "model": "gpt-4o-mini-2024-07-18",
      "created_at": 1721764800,
      "fine_tuned_model": null,
      "organization_id": "org-123",
      "result_files": [],
      "status": "queued",
      "validation_file": null,
      "training_file": "file-abc123",
      "metadata": {
        "key": "value"
      }
    },
    { ... },
    { ... }
  ], "has_more": true
}