---
summary: Model types, formats, quantizations, statuses.
title: Formats, types & enums
path: reference/formats
status: published
---

# Formats, types & enums

The controlled vocabularies used across the API and SDK. The **live** list of
supported formats and quantizations for a deployment comes from
`GET /api/v1/options/formats` and `GET /api/v1/options/quantizations`.

## Model types {#model-types}

The `type` on a model (required at creation):

| Value | Meaning |
|---|---|
| `llm` | Text-in / text-out language model. |
| `embedding` | Produces vector embeddings. |
| `image_generation` | Text/image → image generation. |
| `stt` | Speech-to-text. |
| `tts` | Text-to-speech. |
| `multimodal` | Multiple input/output modalities. |
| `vision_language` | Image + text understanding. |
| `audio_language` | Audio + text understanding. |
| `video_language` | Video + text understanding. |
| `image_to_image` | Image → image. |
| `audio_to_audio` | Audio → audio. |

Use `modalities` (`{input: [...], output: [...]}`) to describe specifics.

## File formats {#formats}

The `format` of a version or variant. The catalog is deployment-configurable; the
built-in variant formats are:

| Value | Typical use |
|---|---|
| `safetensors` | Hugging Face safetensors (common original format). |
| `pytorch` | PyTorch checkpoints (`.pt`, `.bin`). |
| `gguf` | llama.cpp GGUF (quantized inference). |
| `onnx` | ONNX graphs. |
| `other` | Anything else. |

A version's `format` is a free string validated against the deployment's active
formats (1–32 chars, lowercased). Query `GET /api/v1/options/formats` for the live set
and their `file_extensions`.

## Quantizations {#quantizations}

Quantization is a free-text label (≤32 chars) attached to a version or variant, e.g.
`Q4_K_M`, `Q8_0`, `int4`, `awq-int4`. The deployment's catalog
(`GET /api/v1/options/quantizations`, optionally filtered by `format_name`) records
recognized labels along with a `bits` value.

## Version status {#version-status}

The lifecycle `status` on a version:

| Value | Meaning |
|---|---|
| `uploading` | Created; files being pushed. |
| `processing` | Server finalizing/validating. |
| `ready` | Available for download. |
| `available` | Legacy alias for `ready` (normalized to `ready` in responses). |
| `deprecated` | Downloadable but discouraged. |
| `deleted` | Soft-deleted. |
| `failed` | Upload/finalize failed. |

## Variant status {#variant-status}

| Value | Meaning |
|---|---|
| `pending` | Conversion requested, not started. |
| `converting` | Conversion in progress. |
| `available` | Ready for download. |
| `failed` | Conversion failed. |

## Namespace visibility {#visibility}

| Value | Read access |
|---|---|
| `public` | Anyone. |
| `tenant` | Users in the same ScaiKey tenant. |
| `private` | Explicit members only. |

## Namespace roles {#roles}

`owner` › `admin` › `member` › `viewer`. See
[Authentication](/docs/scaiatlas/concepts/authentication#permission-model) for the
permissions each grants.