catalog

List published templates (public)

D-19(c). Cursor paged; filters kind and min_vram_bytes (templates whose vram_fit.min_vram_bytes <= the given value). Only published templates (bound to at least one admitted machine by a qualification record) are listed. No cached public responses.

get/api/v1/templates

Request

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

Query parameters

cursorstring

Opaque pagination cursor from a previous response.

limitinteger
kind'model' | 'classical' | 'custom'
min_vram_bytesstring

Unsigned base-10 integer as string; never a float.

Example:1

Return templates that fit a device with this much VRAM.

backend'cuda' | 'rocm' | 'sycl' | 'vulkan' | 'metal'

Only templates with a built runtime for this backend ("Works on").

Response

Page of templates.

next_cursorstring nullable required

Example response

{
  "items": [
    {
      "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.