List Checkpoint Options - Archetype AI Documentation

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints?model=newton&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

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

response = requests.get(
    "https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"model": "newton", "limit": 20}
)

print(response.json())

const params = new URLSearchParams({ model: 'newton', limit: '20' });

const response = await fetch(
  `https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
    }
  }
);

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

{
  "object": "list",
  "data": [
    {
      "id": "ckp_...",
      "name": "newton/c:2.5.1-8b-base",
      "base_model": "newton/c:2.5.1-8b-base",
      "step": 1000,
      "metrics": {
        "loss": 0.123
      },
      "created_at": 1765201323
    }
  ],
  "has_more": false
}

GET

fine_tuning

checkpoints

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints?model=newton&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

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

response = requests.get(
    "https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"model": "newton", "limit": 20}
)

print(response.json())

const params = new URLSearchParams({ model: 'newton', limit: '20' });

const response = await fetch(
  `https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
    }
  }
);

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

{
  "object": "list",
  "data": [
    {
      "id": "ckp_...",
      "name": "newton/c:2.5.1-8b-base",
      "base_model": "newton/c:2.5.1-8b-base",
      "step": 1000,
      "metrics": {
        "loss": 0.123
      },
      "created_at": 1765201323
    }
  ],
  "has_more": false
}

Requires version 1.1.5 or later of the Archetype platform.

Overview

Lists checkpoints available to warm-start a new fine-tuning job. This returns the organization’s checkpoints, optionally filtered to a model family. The results are cursor-paginated and are sorted newest first. To list only checkpoints for a specific job, use the List Job Checkpoints endpoint.

This endpoint is used by the Fine-Tuning dashboard to build the list of checkpoints from which to start a job.

Request

model

string

Filters checkpoints to include only those of the specified model, e.g. newton. Omit to list all of the org’s checkpoints.

after

string

Forward cursor: return checkpoints older than the one with this ID. Mutually exclusive with before.

before

string

Backward cursor: return checkpoints newer than the one with this ID. Mutually exclusive with after.

limit

integer

The maximum number of options to return (1–100).

Response

Returns a page of checkpoint options.

object

string

The object type of a list response. Always list.

data

array

The selectable checkpoint options.

Show FineTuningCheckpointOption

A page of checkpoint options that match the specified options.

string

required

The checkpoint’s identifier. This is the value to submit as checkpoint_id when using the Create Job endpoint.

name

string

required

The human-readable registry name.

base_model

string

The base model variant the checkpoint was produced from. This is parsed from the registry name, such as newton/c:2.5.1-8b-base, and is null if not parseable. A warm-start only loads cleanly from a checkpoint of the same base.

step

integer

required

Training step at which the checkpoint was produced.

metrics

object

required

Structured metrics captured with the checkpoint (e.g. loss). This is useful for ranking options.

created_at

integer

required

The Unix timestamp (seconds) at which the checkpoint was produced.

has_more

boolean

Whether or not more options exist beyond this page.

curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints?model=newton&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

import requests
import os

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

response = requests.get(
    "https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"model": "newton", "limit": 20}
)

print(response.json())

const params = new URLSearchParams({ model: 'newton', limit: '20' });

const response = await fetch(
  `https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
    }
  }
);

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

{
  "object": "list",
  "data": [
    {
      "id": "ckp_...",
      "name": "newton/c:2.5.1-8b-base",
      "base_model": "newton/c:2.5.1-8b-base",
      "step": 1000,
      "metrics": {
        "loss": 0.123
      },
      "created_at": 1765201323
    }
  ],
  "has_more": false
}

List Job Metrics Create Job

⌘I

​Overview

​Request

​Response

Overview

Request

Response