Models & checkpoints
Distinguish published weights, reference model choices, and executable runtime support.
Discover a model
The Models workspace and public inventory expose model metadata from published training checkpoints and qualified generation offerings. A model identity can include a repository and revision; preserve both when comparing results or preparing a request.
The reference training catalog supplies configuration choices. Its configurable label means a draft can be prepared. Execution still depends on the current account capabilities and qualified runtime.
Read the state in context
| State or identity | Meaning |
|---|---|
| Reference model choice | A supported configuration template. |
| Published checkpoint | An identified model artifact published by its producer. |
| Candidate checkpoint | An observed candidate that has not become a published checkpoint. |
| Qualified generation offering | A model/source pairing admitted to the generation catalog. |
| Available execution profile | A qualified runtime returned for an eligible training account. |
Pin the exact revision
Pinned-model generation and evaluation requests use a public Hugging Face repository and a full 40-character commit revision. The quote validates the selected snapshot, model support, and context limits before an order can be confirmed. A Batch API batch can instead name its commit in metadata.revision, or omit it to pin the commit main names when the batch is created.
Keep the original model card and license with your project records. Review the rights for model weights, input data, and generated outputs before using them in a downstream product.
Models you can pin
Batch API batches, pinned-model generation and evaluations accept a Hugging Face model when all of these hold at the pinned revision. The quote, or POST /batches, checks them and refuses with the code shown.
| Requirement | Refusal |
|---|---|
| A public, ungated repository in org/name form. | model_private (422), model_not_found (422) |
| Top-level safetensors weights. | model_unsupported (422) |
| config.json architectures[0] is one the subnet serves. Today: Qwen3ForCausalLM, Qwen3_5ForCausalLM and Qwen3_5ForConditionalGeneration. GET /api/v1/generation/catalog returns the current list as architectures. | architecture_unsupported (422), which lists the supported architectures |
| The prompt allowance plus max_new_tokens (max_tokens for a batch) fits the model’s context length. | context_too_long (422) |
| The weights × 1.3 plus the KV cache of eight sequences at that length fit one node of up to 8 GPUs; the quote shows gpu_count. | model_too_large (422) |
| The model’s size has a published price. | pricing_unavailable (409) |
Batch API — Offline completions on your own JSONL file.
Evaluations API — Evaluate a pinned model on catalog sets.
Explore further
Models — Inspect the model workspace.
Training — Check runtime support before a private run.
Public inventory — Read source and capability fields.