catalog

Get one published template (public)

get/api/v1/templates/{templateId}

Request

  • Base URL: https://amplerun-api.spiry.org
  • URL: https://amplerun-api.spiry.org/api/v1/templates/{templateId}
  • Auth: none declared

Path parameters

templateIdstring required

Template UUID or its slug (spec.template_id, e.g. qwen3-8b-awq); unpublished -> 404.

Response

Template.

idstring uuid required
publishedboolean required
template_idstring required
namestring required
template_versionstring required
image_digeststring required
launch_profile_versionstring required
kind'model' | 'classical' | 'custom' required
engine'vllm' | 'llamacpp' | 'comfyui' | 'faster-whisper' | 'pytorch' | 'jupyter' | 'ollama' | 'oci' required
quantizationstring
envobject required
min_gpu_countinteger required
required_runtime'cuda' | 'rocm-hip' | 'level-zero' | 'opencl' | 'xpu' required
setup_notesstring required
backendsstring[]

Additive. Backends with a built runtime, in preference order ("Works on" filter). Spec compatibility, not a hardware test.

works_onstring[]

Additive. Hardware vendors those backends cover. Spec compatibility only; a hardware report is what says "tested on".

Example response

{
  "id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40",
  "image_digest": "registry.amplerun.com/templates/pytorch-cuda@sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "model_ref": {
    "files": [
      {
        "size_bytes": "1"
      }
    ]
  },
  "vram_fit": {
    "min_vram_bytes": "1",
    "est_weights_bytes": "1",
    "est_kv_bytes_per_1k_tokens": "1"
  },
  "runtimes": {
    "cuda": {
      "image_digest": "registry.amplerun.com/templates/pytorch-cuda@sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
    },
    "rocm": {
      "image_digest": "registry.amplerun.com/templates/pytorch-cuda@sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
    },
    "sycl": {
      "image_digest": "registry.amplerun.com/templates/pytorch-cuda@sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
    },
    "vulkan": {
      "image_digest": "registry.amplerun.com/templates/pytorch-cuda@sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
    },
    "metal": {
      "image_digest": "registry.amplerun.com/templates/pytorch-cuda@sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.