# Models

Catalog of AI models available to the current API key. The catalog contents depend on the configured provider credentials: free Bitrix24 models are visible to everyone, the rest only to keys that have access to the provider credentials.

Scope: `vibe:ai`

## Operations

- [List models](./models/list.md) — `GET /v1/models`
- [Get model](./models/get.md) — `GET /v1/models/:modelId`

## Capabilities

- [Model lifecycle](./models/lifecycle.md) — `ACTIVE` / `DEPRECATED` / `DISABLED` states and response headers

## Typical scenario

1. Request the [list of models](./models/list.md) for the current key — you will see which of them are available without connecting BYOK.
2. If the model you need is missing, connect [your own provider key](/docs/ai/credentials/create).
3. Use the model `id` in a [chat completion](/docs/ai/chat/completions).

## See also

- [AI Router](/docs/ai)
- [Chat completions](/docs/ai/chat)
- [Your own keys (BYOK)](/docs/ai/credentials)