Models

Models are fine-tuned versions of base models, automatically created when a training run completes successfully.

The Model Object

{
  "id": "96e9f0d9-81c1-41cb-b24e-5c85ea09e769",
  "name": "Qwen3.5-2B-ft-b3e2b918",
  "provider": "hosted",
  "provider_model_id": "s3://tuned-tensor-runs-artifacts-.../model.tar.gz",
  "base_model": "Qwen/Qwen3.5-2B",
  "fine_tune_job_id": "b3e2b918-...",
  "created_at": "2026-03-06T10:57:50.000Z"
}

Field	Description
`name`	Auto-generated from base model + job ID
`provider`	Public provider label; currently `hosted`
`provider_model_id`	Hosted model ID or downloadable artifact URI
`base_model`	Original model that was fine-tuned

The recommended way to work with models is the tt CLI — each endpoint below shows the tt command first, followed by the equivalent REST call.

List Models

GET /api/v1/models

CLI

tt models list

Equivalent REST call

curl https://tunedtensor.com/api/v1/models \
  -H "Authorization: Bearer tt_your_api_key"

Supports page and per_page query parameters.

Get a Model

GET /api/v1/models/:id

CLI

tt models get <model-id>

Equivalent REST call

curl https://tunedtensor.com/api/v1/models/:id \
  -H "Authorization: Bearer tt_your_api_key"

Download a Model Artifact

GET /api/v1/models/:id/download

CLI

tt models download <model-id> --output model.tar.gz

Equivalent REST call

curl https://tunedtensor.com/api/v1/models/:id/download \
  -H "Authorization: Bearer tt_your_api_key"

Returns a short-lived signed download URL for models that have a Tuned Tensor-hosted artifact. Provider-hosted models can still be used for inference through provider_model_id, but may not expose downloadable weights.

Delete a Model

DELETE /api/v1/models/:id

CLI

tt models delete <model-id>

Equivalent REST call

curl -X DELETE https://tunedtensor.com/api/v1/models/:id \
  -H "Authorization: Bearer tt_your_api_key"

Deletes the model record from Tuned Tensor. The model may still exist on the provider and would need to be deleted there separately.