---
title: "Список моделей"
method: GET
path: "/v1/models"
tags: ["Models"]
---

# Список моделей

`GET /v1/models`

## Request

- Base URL: `https://api.clipia.ai`
- URL: `https://api.clipia.ai/v1/models`
- Auth: API key in header `Authorization`

Возвращает каталог активных моделей Clipia — изображения и видео.
Доступно любому валидному ключу (scope не требуется).

## Response `200`

Каталог моделей.

- ModelList
  - `object` 'list': Присутствует при включённом LLM gateway.
  - `data` union[], required
    - union
      - ModelSummary
        - `slug` string, required: Slug модели для использования в `POST /v1/models/{model}`.
        - `type` 'image' | 'video', required: Тип выходного контента.
        - `name` string, required: Отображаемое имя модели.
        - `capabilities` string[]: Поддерживаемые возможности модели.
        - `pricing` ModelPricing: Reference quote through active billing, with character basis for TTS.
          - `credits` number: Quote for one unit; absent when pricing is unavailable.
          - `billing_unit` 'characters'
          - `unit_size` 1000
          - `character_count` 'spoken_text' | 'trimmed_text'
          - `rounding` 'ceil'
          - `minimum_credits` 1
          - `available` false: Present only when authoritative pricing is unavailable.
          - `estimate_required` true: Present when the model is available but its price depends on the submitted input (for example, the length of the source video or speech), so there is no reference quote and `credits` is absent. Call `POST /v1/models/{model}/estimate` with the actual input.
          - `note` string
      - LlmModelSummary: OpenAI-совместимая запись текстовой LLM.
        - `id` string, required
        - `canonical_slug` string, required
        - `object` 'model', required
        - `name` string, required
        - `created` integer, required
        - `owned_by` string, required
        - `description` string
        - `context_length` integer, required
        - `architecture` object, required
          - `modality` string, required
          - `input_modalities` string[], required
          - `output_modalities` string[], required
          - `tokenizer` string, required
        - `pricing` object, required: USD per token, encoded as decimal strings.
          - `prompt` string
          - `completion` string
        - `top_provider` object, required
          - `context_length` integer, required
          - `max_completion_tokens` integer, required
          - `is_moderated` boolean, required
        - `supported_parameters` string[], required
        - `per_request_limits` object, nullable

## Other responses

- `401`: Ключ отсутствует, неверный или отозван.
- `429`: Превышен лимит. `error.type` всегда `rate_limit_error`; различайте по `error.code`: - `rate_limit_exceeded` — запросов в минуту (RPM) или токенов в минуту (TPM) по ключу; - `concurrency_limit_exceeded` — слишком много генераций одновременно (по ключу или по аккаунту). Дождитесь завершения одной и повторите. В обоих случаях сервер отдаёт заголовок `Retry-After` и дублирует подсказку в `error.retry_after_seconds`.

---

[API](https://skmtc.dev/clipia/apis/clipia-api.md) · [All operations](https://skmtc.dev/clipia/apis/clipia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clipia/apis/clipia-api/revisions/cc55924a3381?raw)