List checkpoints for a fine-tune job

Retrieve all saved checkpoints for a fine-tune training run. Returns an empty list if the model branch has not been created yet (e.g. before training has produced checkpoints).

GET /api/repos/{namespace}/{repo_name}/fine_tunes/{id}/checkpoints

List checkpoints for a fine-tune job

cURL

curl --request GET \
  --url https://dev.hub.oxen.ai/api/repos/{namespace}/{repo_name}/fine_tunes/{id}/checkpoints \
  --header 'Authorization: Bearer <token>'

200

{
  "branch": "<string>",
  "checkpoints": [
    {
      "created_at": "<string>",
      "deployment_status": "<string>",
      "inference_samples": [
        {}
      ],
      "metrics": {
        "epoch": 123,
        "grad_norm": 123,
        "learning_rate": 123,
        "loss": 123,
        "mean_token_accuracy": 123
      },
      "model_id": "<string>",
      "model_name": "<string>",
      "path": "<string>",
      "size_bytes": 123,
      "step": 123
    }
  ],
  "fine_tune_id": "<string>",
  "status": "<string>",
  "status_message": "<string>",
  "total_checkpoints": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

Fine-tune ID

Response

200

application/json

Checkpoints list

Standard wrapper for the list-checkpoints response.

branch · string

Oxen branch where the model and its checkpoints are stored.

checkpoints · Checkpoint · object[]

Checkpoints saved during the fine-tune run, sorted by step ascending.

Show child attributes

fine_tune_id · string

ID of the fine-tune job these checkpoints belong to.

status · string

High-level status string (for example, 'success').

status_message · string

Human-readable status message (for example, 'resource_found').

total_checkpoints · integer

Total number of checkpoints returned.