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 for the permissions each grants.