# Models and model ids

> How model ids work: author/slug, aliases, bare slugs and dot/dash variants.

Set the `model` field of a request to a model id from the [catalogue](https://clonvo.com/models.md). Every model page shows its id with a copy button.

## The `author/slug` format

Canonical ids have two parts: the model’s author and the model’s slug.

```text
anthropic/claude-sonnet-5-5
openai/gpt-6.1-sol
google/gemini-3.8-flash
x-ai/grok-4-7
deepseek/deepseek-v4-pro
mistralai/mistral-large-4
moonshotai/kimi-k3.1-pro
qwen/qwen3.8-max
```

Authors use the same slugs as OpenRouter, so ids copied from OpenRouter usually work unchanged.

| Provider | Author |
| --- | --- |
| OpenAI | `openai` |
| Anthropic | `anthropic` |
| Google (Gemini) | `google` |
| xAI (Grok) | `x-ai` |
| DeepSeek | `deepseek` |
| Mistral | `mistralai` |
| Moonshot AI (Kimi) | `moonshotai` |
| Meta (Muse) | `meta` |
| Alibaba Cloud (Qwen) | `qwen` |

## Other forms Clonvo accepts

Clonvo resolves a few variations to the same model:

| You send | Resolves to | Why |
| --- | --- | --- |
| `xai/grok-4-7` | `x-ai/grok-4-7` | Author aliases: `xai`, `gemini`, `mistral`, `moonshot`, `kimi` and `alibaba` map to the canonical author. |
| `grok-4-7` | `x-ai/grok-4-7` | A bare slug works too. |
| `anthropic/claude-sonnet-5.5` | `anthropic/claude-sonnet-5-5` | `.` and `-` are treated the same. |
| `Anthropic/Claude-Sonnet-5-5` | `anthropic/claude-sonnet-5-5` | Ids are case-insensitive. |

The canonical id is the safest choice in code: it’s what the catalogue and your activity logs show. Responses always report the canonical id of the model that answered in `model`, not the variant you sent.

## Free models

Ids ending in `:free` are routed to OpenRouter’s free endpoints instead of the catalogue, for example `<author>/<model>:free`. The aliases above don’t apply to them. They have their own limits and data rules: see [Free models](https://clonvo.com/docs/free-models.md).

## Unknown ids

An id that doesn’t match any model returns `400` with the OpenAI error shape. This applies to every id in [`models`](https://clonvo.com/docs/fallbacks.md) too: one unknown id fails the whole request.

```json
{
  "error": {
    "message": "The model \"openai/gpt-0\" does not exist on Clonvo. List available models with GET /v1/models.",
    "type": "invalid_request_error",
    "code": "model_not_found",
    "param": "model"
  }
}
```

Models that a provider has retired (past their deactivation date) return `404` with the code `model_retired`, and models that are temporarily switched off return `404` with `model_unavailable`. If you listed fallback models, Clonvo skips these and tries the next one.

## Deprecations

When a provider announces that a model will be retired, its catalogue page shows the deprecation and the date requests stop working. Move to a newer model before that date.

## Listing models from code

`GET /v1/models` returns every model with its pricing and capabilities, including [peak-hour prices](https://clonvo.com/docs/other-endpoints.md#peak-hour-prices) for models that have them. See [Other endpoints](https://clonvo.com/docs/other-endpoints.md#get-v1-models).