---
title: "Create a fine tuning job"
method: POST
path: "/ai/fine_tuning/jobs"
tags: ["Fine Tuning"]
---

# Create a fine tuning job

`POST /ai/fine_tuning/jobs`

Create a new fine tuning job.

## Request body

- CreateFineTuningJobRequest
  - `model` string, required — The base model that is being fine-tuned.
  - `training_file` string, required — The storage bucket or object used for training.
  - `suffix` string — Optional suffix to append to the fine tuned model's name.
  - `hyperparameters` object — The hyperparameters used for the fine-tuning job.
    - `n_epochs` integer — The number of epochs to train the model for. An epoch refers to one full cycle through the training dataset. 'auto' decides the optimal number of epochs based on the size of the dataset. If setting the number manually, we support any number between 1 and 50 epochs.

## Response `200`

Successful Response

- FineTuningJob — The `fine_tuning.job` object represents a fine-tuning job that has been created through the API.
  - `id` string, required — The name of the fine-tuned model that is being created.
  - `created_at` integer, required — The Unix timestamp (in seconds) for when the fine-tuning job was created.
  - `finished_at` integer, nullable, required — 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.
  - `hyperparameters` object, required — The hyperparameters used for the fine-tuning job.
    - `n_epochs` integer, required — The number of epochs to train the model for. An epoch refers to one full cycle through the training dataset.
  - `model` string, required — The base model that is being fine-tuned.
  - `organization_id` string, required — The organization that owns the fine-tuning job.
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled', required — The current status of the fine-tuning job.
  - `trained_tokens` integer, nullable, required — 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, required — The storage bucket or object used for training.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/revisions/e32d46c5945b/schema)