Create Fine-tuning Job

POST

fine_tuning

jobs

Train a Reflex

curl --request POST \
  --url https://api.morphllm.com/v1/fine_tuning/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "suffix": "support-classifier",
  "training_data": [
    {
      "text": "I need a refund for my order",
      "label": "billing"
    },
    {
      "text": "Charged me twice this month",
      "label": "billing"
    },
    {
      "text": "The app crashed on launch",
      "label": "bug"
    },
    {
      "text": "Submit button does nothing",
      "label": "bug"
    }
  ]
}
'

import requests

url = "https://api.morphllm.com/v1/fine_tuning/jobs"

payload = {
    "suffix": "support-classifier",
    "training_data": [
        {
            "text": "I need a refund for my order",
            "label": "billing"
        },
        {
            "text": "Charged me twice this month",
            "label": "billing"
        },
        {
            "text": "The app crashed on launch",
            "label": "bug"
        },
        {
            "text": "Submit button does nothing",
            "label": "bug"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    suffix: 'support-classifier',
    training_data: [
      {text: 'I need a refund for my order', label: 'billing'},
      {text: 'Charged me twice this month', label: 'billing'},
      {text: 'The app crashed on launch', label: 'bug'},
      {text: 'Submit button does nothing', label: 'bug'}
    ]
  })
};

fetch('https://api.morphllm.com/v1/fine_tuning/jobs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.morphllm.com/v1/fine_tuning/jobs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'suffix' => 'support-classifier',
    'training_data' => [
        [
                'text' => 'I need a refund for my order',
                'label' => 'billing'
        ],
        [
                'text' => 'Charged me twice this month',
                'label' => 'billing'
        ],
        [
                'text' => 'The app crashed on launch',
                'label' => 'bug'
        ],
        [
                'text' => 'Submit button does nothing',
                'label' => 'bug'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.morphllm.com/v1/fine_tuning/jobs"

	payload := strings.NewReader("{\n  \"suffix\": \"support-classifier\",\n  \"training_data\": [\n    {\n      \"text\": \"I need a refund for my order\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"Charged me twice this month\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"The app crashed on launch\",\n      \"label\": \"bug\"\n    },\n    {\n      \"text\": \"Submit button does nothing\",\n      \"label\": \"bug\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.morphllm.com/v1/fine_tuning/jobs")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"suffix\": \"support-classifier\",\n  \"training_data\": [\n    {\n      \"text\": \"I need a refund for my order\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"Charged me twice this month\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"The app crashed on launch\",\n      \"label\": \"bug\"\n    },\n    {\n      \"text\": \"Submit button does nothing\",\n      \"label\": \"bug\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.morphllm.com/v1/fine_tuning/jobs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"suffix\": \"support-classifier\",\n  \"training_data\": [\n    {\n      \"text\": \"I need a refund for my order\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"Charged me twice this month\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"The app crashed on launch\",\n      \"label\": \"bug\"\n    },\n    {\n      \"text\": \"Submit button does nothing\",\n      \"label\": \"bug\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "ftjob-a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "object": "fine_tuning.job",
  "model": "guardrail",
  "created_at": 1780107000,
  "finished_at": 1780107148,
  "fine_tuned_model": "support-classifier",
  "status": "succeeded",
  "labels": [
    "billing",
    "bug"
  ],
  "trained_examples": 10,
  "hyperparameters": {
    "n_epochs": 3,
    "batch_size": "auto",
    "learning_rate_multiplier": "auto"
  },
  "result": {
    "accuracy": 0.95,
    "f1_score": 0.94
  },
  "error": null,
  "suffix": "support-classifier"
}

{
  "error": {
    "code": "invalid_request_error",
    "message": "The request body is missing the `model` field."
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key provided."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry in 12 seconds."
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side."
  }
}

Overview

Creates a fine-tuning job that trains a custom Reflex from labeled examples. The resulting fine_tuned_model id is usable in POST /v1/reflex/predict when the job succeeds. Track progress with job events.

Authorizations

Authorization

string

header

required

Morph API key, passed as Authorization: Bearer sk-.... Create keys at https://www.morphllm.com/dashboard/api-keys.

Body

application/json

The training set (or the instructions to build one) plus the name to serve it under.

Provide exactly one input: training_data, generate, or label_data. The training set must end up with 2+ labels and 5+ examples per label.

model

string

What to train from (OpenAI-style). Omit for a from-scratch cold start, or pass a custom or default reflex to warm-start from its weights: a model you trained (its suffix or job id) or a built-in reflex name like guardrail.

Example:

"guardrail"

suffix

string

Names the served model. Becomes fine_tuned_model on success.

Example:

"support-classifier"

labels

string[]

The classes. 2+ required for generate and label_data; inferred from training_data if omitted.

One class name.

Example:

["billing", "bug"]

webhook_url

string

An https URL that receives a signed webhook when the job reaches succeeded, failed, or cancelled.

Example:

"https://example.com/webhooks/morph"

auto_train

boolean

default:true

Train as soon as data prep finishes. Set false to pause at prepared for review, then call POST /v1/fine_tuning/jobs/{job_id}/train.

Example:

true

training_data

object[]

Labeled rows you supply (input mode 1).

Show child attributes

Example:

[
  {
    "text": "I need a refund for my order",
    "label": "billing"
  },
  {
    "text": "Charged me twice this month",
    "label": "billing"
  },
  {
    "text": "The app crashed on launch",
    "label": "bug"
  },
  {
    "text": "Submit button does nothing",
    "label": "bug"
  }
]

generate

object

Input mode 2: synthesize training data from a description.

Show child attributes

Example:

{
  "description": "classify support tickets by topic",
  "examples_per_label": 25
}

label_data

object

Input mode 3: sort your unlabeled text into your classes.

Show child attributes

Example:

{
  "texts": [
    "Charged me twice this month",
    "Submit button does nothing"
  ],
  "description": "support tickets"
}

Response

The created job.

An OpenAI-compatible fine_tuning.job, with additive Reflex fields (labels, trained_examples, result, suffix).

string

required

Job id, prefixed ftjob-.

Example:

"ftjob-a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"

object

string

required

Always fine_tuning.job.

Example:

"fine_tuning.job"

model

string

required

What the job trained from: the reflex you warm-started from, or the from-scratch base for a cold start.

Example:

"guardrail"

created_at

integer

required

Unix timestamp (seconds) at creation.

Example:

1780107000

finished_at

integer | null

required

Unix timestamp at a terminal state, else null.

Example:

1780107148

fine_tuned_model

string | null

required

Served model name once succeeded (the suffix, or the job id if none).

Example:

"support-classifier"

status

enum<string>

required

validating_files is the data-prep phase for generate/label_data jobs.

Available options:

queued,

validating_files,

running,

succeeded,

failed,

cancelled

Example:

"succeeded"

labels

string[]

required

The classes this job trained on.

One class the model predicts.

Example:

["billing", "bug"]

trained_examples

integer

required

Number of training examples.

Example:

10

hyperparameters

object

required

Fully managed.

Show child attributes

Example:

{
  "n_epochs": 3,
  "batch_size": "auto",
  "learning_rate_multiplier": "auto"
}

result

object | null

required

{accuracy, f1_score} when succeeded, else null. Each value may be null.

Show child attributes

Example:

{ "accuracy": 0.95, "f1_score": 0.94 }

error

object | null

required

{code, message, param} when failed, else null.

Show child attributes

Example:

{
  "code": "invalid_training_data",
  "message": "Every label needs at least 5 examples.",
  "param": "training_data"
}

suffix

string | null

required

The suffix supplied at creation, else null.

Example:

"support-classifier"

Train a Reflex

curl --request POST \
  --url https://api.morphllm.com/v1/fine_tuning/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "suffix": "support-classifier",
  "training_data": [
    {
      "text": "I need a refund for my order",
      "label": "billing"
    },
    {
      "text": "Charged me twice this month",
      "label": "billing"
    },
    {
      "text": "The app crashed on launch",
      "label": "bug"
    },
    {
      "text": "Submit button does nothing",
      "label": "bug"
    }
  ]
}
'

import requests

url = "https://api.morphllm.com/v1/fine_tuning/jobs"

payload = {
    "suffix": "support-classifier",
    "training_data": [
        {
            "text": "I need a refund for my order",
            "label": "billing"
        },
        {
            "text": "Charged me twice this month",
            "label": "billing"
        },
        {
            "text": "The app crashed on launch",
            "label": "bug"
        },
        {
            "text": "Submit button does nothing",
            "label": "bug"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    suffix: 'support-classifier',
    training_data: [
      {text: 'I need a refund for my order', label: 'billing'},
      {text: 'Charged me twice this month', label: 'billing'},
      {text: 'The app crashed on launch', label: 'bug'},
      {text: 'Submit button does nothing', label: 'bug'}
    ]
  })
};

fetch('https://api.morphllm.com/v1/fine_tuning/jobs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.morphllm.com/v1/fine_tuning/jobs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'suffix' => 'support-classifier',
    'training_data' => [
        [
                'text' => 'I need a refund for my order',
                'label' => 'billing'
        ],
        [
                'text' => 'Charged me twice this month',
                'label' => 'billing'
        ],
        [
                'text' => 'The app crashed on launch',
                'label' => 'bug'
        ],
        [
                'text' => 'Submit button does nothing',
                'label' => 'bug'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.morphllm.com/v1/fine_tuning/jobs"

	payload := strings.NewReader("{\n  \"suffix\": \"support-classifier\",\n  \"training_data\": [\n    {\n      \"text\": \"I need a refund for my order\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"Charged me twice this month\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"The app crashed on launch\",\n      \"label\": \"bug\"\n    },\n    {\n      \"text\": \"Submit button does nothing\",\n      \"label\": \"bug\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.morphllm.com/v1/fine_tuning/jobs")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"suffix\": \"support-classifier\",\n  \"training_data\": [\n    {\n      \"text\": \"I need a refund for my order\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"Charged me twice this month\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"The app crashed on launch\",\n      \"label\": \"bug\"\n    },\n    {\n      \"text\": \"Submit button does nothing\",\n      \"label\": \"bug\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.morphllm.com/v1/fine_tuning/jobs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"suffix\": \"support-classifier\",\n  \"training_data\": [\n    {\n      \"text\": \"I need a refund for my order\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"Charged me twice this month\",\n      \"label\": \"billing\"\n    },\n    {\n      \"text\": \"The app crashed on launch\",\n      \"label\": \"bug\"\n    },\n    {\n      \"text\": \"Submit button does nothing\",\n      \"label\": \"bug\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "ftjob-a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "object": "fine_tuning.job",
  "model": "guardrail",
  "created_at": 1780107000,
  "finished_at": 1780107148,
  "fine_tuned_model": "support-classifier",
  "status": "succeeded",
  "labels": [
    "billing",
    "bug"
  ],
  "trained_examples": 10,
  "hyperparameters": {
    "n_epochs": 3,
    "batch_size": "auto",
    "learning_rate_multiplier": "auto"
  },
  "result": {
    "accuracy": 0.95,
    "f1_score": 0.94
  },
  "error": null,
  "suffix": "support-classifier"
}

{
  "error": {
    "code": "invalid_request_error",
    "message": "The request body is missing the `model` field."
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key provided."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry in 12 seconds."
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side."
  }
}

Get Started

Models

API Reference

Integrations

Overview

Authorizations

Body

Response

​Overview

Authorizations

Body

Response

Overview