Resume Fine-tuning Job - Archetype AI Documentation

curl -X POST https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/resume \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

api_key = os.environ.get("ATAI_API_KEY")

job_id = "your-job-id"

response = requests.post(
    f"https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/{job_id}/resume",
    headers={"Authorization": f"Bearer {api_key}"}
)

print(response.json())

const jobId = 'your-job-id';

const response = await fetch(
  `https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/${jobId}/resume`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
    }
  }
);

const data = await response.json();
console.log(data);

{
  "object": "fine_tuning.job",
  "id": "your-job-id",
  "name": "my-tune",
  "model": "newton",
  "created_at": 1765201323,
  "org_id": "your-org",
  "status": "PENDING",
  "checkpoint_id": "ckp_...",
  "fine_tuned_model": null,
  "finished_at": null,
  "outcome": null,
  "seed": 42,
  "user_provided_suffix": "v2",
  "training_files": ["fil_..."],
  "validation_files": ["fil_..."],
  "errors": []
}

{
  "code": "not_found",
  "message": "Not found",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

{
  "code": "invalid_state_transition",
  "message": "Invalid state transition",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

POST

fine_tuning

jobs

{id}

resume

curl -X POST https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/resume \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

api_key = os.environ.get("ATAI_API_KEY")

job_id = "your-job-id"

response = requests.post(
    f"https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/{job_id}/resume",
    headers={"Authorization": f"Bearer {api_key}"}
)

print(response.json())

const jobId = 'your-job-id';

const response = await fetch(
  `https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/${jobId}/resume`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
    }
  }
);

const data = await response.json();
console.log(data);

{
  "object": "fine_tuning.job",
  "id": "your-job-id",
  "name": "my-tune",
  "model": "newton",
  "created_at": 1765201323,
  "org_id": "your-org",
  "status": "PENDING",
  "checkpoint_id": "ckp_...",
  "fine_tuned_model": null,
  "finished_at": null,
  "outcome": null,
  "seed": 42,
  "user_provided_suffix": "v2",
  "training_files": ["fil_..."],
  "validation_files": ["fil_..."],
  "errors": []
}

{
  "code": "not_found",
  "message": "Not found",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

{
  "code": "invalid_state_transition",
  "message": "Invalid state transition",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

Requires version 1.1.5 or later of the Archetype platform.

Overview

Resumes a paused or failed fine-tuning job, continuing from the most recent checkpoint.

Request

string

required

The ID of the fine-tuning job to resume. This is a TypeID-encoded identifier with the FineTuningJobId prefix.

Response

Returns a description of the fine-tuning job after resuming it.

string

required

The object type. Always fine_tuning.job.

string

required

The unique identifier of the fine-tuning job.

string

required

The human-readable name supplied when the job was created.

string

required

The base model being fine-tuned.

integer

required

The Unix timestamp (in seconds) at which the job was created.

string

required

The organization that owns the job.

string

required

The job’s current lifecycle stage. One of PENDING, ADMITTED, RUNNING, COMPLETED, FAILED, PREEMPTED, CANCELLED, PAUSED, INTERRUPTED.

null

Always null for resumed jobs. This property does not take on a value until the job’s status is COMPLETED. v1.1.5+

array

required

Identifiers of the files used to train the model.

array

required

Identifiers of the files used to evaluate the model during training.

array

required

Failure details when the job has failed, as the platform error envelope (a list of {code, message, suggestion, error_uid}). Empty while the job is queued or running, or on success.

string

The checkpoint ID of the checkpoint from which the job was started (not the checkpoint from which the job was resumed), or null if it trained from the base model.

string

The name of the model produced by the job, available once training has succeeded; null until then.

integer

The Unix timestamp (in seconds) at which the job finished, or null if it is not yet complete.

string

For a COMPLETED job, this indicates whether it succeeded fully (SUCCESS), partially (PARTIAL), or produced nothing (FAILED). This is null for any non-completed status.

integer

The random seed used for the job.

string

The suffix supplied on the request, applied to the fine-tuned model’s name.

curl -X POST https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/resume \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

api_key = os.environ.get("ATAI_API_KEY")

job_id = "your-job-id"

response = requests.post(
    f"https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/{job_id}/resume",
    headers={"Authorization": f"Bearer {api_key}"}
)

print(response.json())

const jobId = 'your-job-id';

const response = await fetch(
  `https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/${jobId}/resume`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
    }
  }
);

const data = await response.json();
console.log(data);

{
  "object": "fine_tuning.job",
  "id": "your-job-id",
  "name": "my-tune",
  "model": "newton",
  "created_at": 1765201323,
  "org_id": "your-org",
  "status": "PENDING",
  "checkpoint_id": "ckp_...",
  "fine_tuned_model": null,
  "finished_at": null,
  "outcome": null,
  "seed": 42,
  "user_provided_suffix": "v2",
  "training_files": ["fil_..."],
  "validation_files": ["fil_..."],
  "errors": []
}

{
  "code": "not_found",
  "message": "Not found",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

{
  "code": "invalid_state_transition",
  "message": "Invalid state transition",
  "suggestion": null,
  "error_uid": "err-xxxxxxxx"
}

⌘I

​Overview

​Request

​Response

Overview

Request

Response