Download a training-run checkpoint

GET

https://api.fastino.ai

training

jobs

{job_id}

checkpoints

{checkpoint_id}

download

JOB_ID="YOUR_RUN_ID"
CHECKPOINT_ID="sampler_weights/step-100"

curl "https://api.fastino.ai/v1/training/jobs/$JOB_ID/checkpoints/$CHECKPOINT_ID/download" \
  -H "X-API-Key: $FASTINO_API_KEY"

{
  "success": true,
  "run_id": "YOUR_SESSION_ID:train:0",
  "checkpoint_id": "sampler_weights/step-100",
  "download_url": "https://api.fastino.ai/v1/training/archives/SIGNED_TOKEN",
  "expires_in_seconds": 900,
  "file_name": "YOUR_SESSION_ID_train_0-sampler_weights-step-100.tar"
}

GET /v1/training/jobs/{job_id}/checkpoints/{checkpoint_id}/download Returns a short-lived signed URL for a tar archive of one of your team’s checkpoints. For sampler checkpoints, the archive contains the PEFT adapter files. Fetch the returned URL separately to download the archive. The URL needs no API key and expires after 15 minutes. Downloading weights requires your team’s weights-download entitlement, the same entitlement that Download trained weights uses.

Request

string

required

Your Fastino API key.

string

required

Training-run ID.

string

required

Checkpoint ID as listed by List training-run checkpoints: weights/<name> or sampler_weights/<name>. Send it as is; the slash is part of the path.

JOB_ID="YOUR_RUN_ID"
CHECKPOINT_ID="sampler_weights/step-100"

curl "https://api.fastino.ai/v1/training/jobs/$JOB_ID/checkpoints/$CHECKPOINT_ID/download" \
  -H "X-API-Key: $FASTINO_API_KEY"

Response

boolean

Whether the URL was generated.

string

Training-run ID.

string

Checkpoint ID.

string

Signed URL of the checkpoint’s tar archive. It needs no credentials.

integer

URL lifetime in seconds. The value is 900.

string

Suggested download file name.

{
  "success": true,
  "run_id": "YOUR_SESSION_ID:train:0",
  "checkpoint_id": "sampler_weights/step-100",
  "download_url": "https://api.fastino.ai/v1/training/archives/SIGNED_TOKEN",
  "expires_in_seconds": 900,
  "file_name": "YOUR_SESSION_ID_train_0-sampler_weights-step-100.tar"
}

The signed URL is a temporary bearer credential. Do not log, commit, persist, or share it. Download the archive promptly and store it according to your data-handling policy.

To request the URL and download the archive in one workflow:

response=$(curl -fsS \
  "https://api.fastino.ai/v1/training/jobs/$JOB_ID/checkpoints/$CHECKPOINT_ID/download" \
  -H "X-API-Key: $FASTINO_API_KEY")

curl -fL \
  -o "$(jq -r '.file_name' <<<"$response")" \
  "$(jq -r '.download_url' <<<"$response")"

This example requires jq.

Status	Meaning
`400`	The checkpoint ID is not `weights/<name>` or `sampler_weights/<name>`.
`403`	Your team does not have the weights-download entitlement. Contact sales@fastino.ai.
`404`	The run or checkpoint is unknown, not visible to you, or has no downloadable files.

An expired or altered signed URL returns 403 when fetched. Request a new URL.

⌘I

JOB_ID="YOUR_RUN_ID"
CHECKPOINT_ID="sampler_weights/step-100"

curl "https://api.fastino.ai/v1/training/jobs/$JOB_ID/checkpoints/$CHECKPOINT_ID/download" \
  -H "X-API-Key: $FASTINO_API_KEY"

{
  "success": true,
  "run_id": "YOUR_SESSION_ID:train:0",
  "checkpoint_id": "sampler_weights/step-100",
  "download_url": "https://api.fastino.ai/v1/training/archives/SIGNED_TOKEN",
  "expires_in_seconds": 900,
  "file_name": "YOUR_SESSION_ID_train_0-sampler_weights-step-100.tar"
}

​Request

​Response

Request

Response