# Как работать с /v1/models

> Список доступных моделей по API — формат ответа, семейства id, выбор модели под задачу и где смотреть возможности и цены.

Веб-версия: https://ai.trackly.one/developers/docs/models · Индекс документации: https://ai.trackly.one/llms.txt

`GET /v1/models` возвращает все модели, доступные по вашему ключу: текстовые,
картиночные, видео и TTS одним списком. Поле `id` (вида `провайдер/модель`,
например `google/gemini-2.5-flash`) подставляется в параметр `model`
остальных эндпоинтов. Запрос бесплатный и баланс не трогает. Описания,
возможности и цены — в каталоге и на странице цен.

## Как получить список?

**GET /v1/models**

```bash
curl https://api.trackly.one/v1/models \
  -H "Authorization: Bearer $TRACKLY_API_KEY"
```

```python
for model in client.models.list():
    print(model.id, "·", model.owned_by)
```

```javascript
const models = await client.models.list();
for (const model of models.data) {
  console.log(model.id, "·", model.owned_by);
}
```

Ответ — OpenAI-формат `{"object": "list", "data": [...]}`, каждая запись:

```json
{
  "id": "google/gemini-2.5-flash",
  "object": "model",
  "created": 0,
  "owned_by": "google"
}
```

`id` — единственное поле, которое понадобится в работе: именно его ждёт
параметр `model` в chat, images, videos и audio. Схема ответа целиком — в
[референсе /v1/models](https://ai.trackly.one/developers/docs/reference/models-list).

## Какие семейства моделей есть?

Префикс id — провайдер: `openai/*`, `anthropic/*`, `google/*`,
`deepseek/*`, `yandex/*`, `kling/*`. Семейство влияет на одну техническую
деталь — маппинг лимита токенов (`max_tokens` ↔ `max_completion_tokens`),
подробности в [гайде по тексту](https://ai.trackly.one/developers/docs/text). Всё остальное
(формат запросов, ключ, биллинг) для всех семейств одинаковое.

## Как понять, что умеет модель?

Сам список модальности не размечает — по `id` не всегда очевидно, чат это
или генератор видео. Источник правды о возможностях, лимитах и назначении —
[каталог моделей](https://ai.trackly.one/developers/models): там у каждой модели пометки
(текст, vision, изображения, видео, TTS) и актуальная цена.

Ошиблись эндпоинтом — API ответит честным 400 `unsupported_capability`
(например, text-only модель не примет картинку). Разбор кодов — в гайде
[«Ошибки API»](https://ai.trackly.one/developers/docs/errors).

## Почему модель может исчезнуть из списка?

Провайдеры снимают модели с поддержки, мы добавляем новые — список живой.
Поэтому:

- не хардкодьте id намертво: держите его в конфиге, чтобы менять без
  деплоя;
- обрабатывайте 404 `model_not_found` — это сигнал свериться со свежим
  `GET /v1/models`;
- при желании кешируйте список на своей стороне: он меняется редко,
  дёргать его на каждый запрос незачем.

## Где смотреть цены?

Цены в рублях — на странице [цен для разработчиков](https://ai.trackly.one/developers/pricing).
Единицы у модальностей разные: текст и TTS тарифицируются по токенам,
изображения — за картинку или по токенам (зависит от модели), видео — за
секунду ролика. Сами суммы в документации не дублируем — страница цен
всегда актуальнее.