---
title: "Детали модели"
method: GET
path: "/v1/models/{model}"
tags: ["Models"]
---

# Детали модели

`GET /v1/models/{model}`

## Request

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

Для generation-модели возвращает схему входа (`input_schema`) и
reference quote (для TTS на 1000 символов). Для text LLM возвращает OpenAI-совместимые metadata,
лимиты контекста и токенные тарифы.
Доступно любому валидному ключу (scope не требуется).

## Path parameters

- `model` string, required

## Response `200`

Детали модели.

- union
  - ModelDetail
    - `slug` string, required
    - `type` 'image' | 'video' | 'audio', required
    - `name` string, required
    - `capabilities` string[]
    - `input_schema` object, nullable, required: Parameters are a list of descriptors; send their names as keys inside input.
      - `parameters` ModelInputParameter[]
        - `name` string, required
        - `type` string, required
        - `required` boolean
        - `default` unknown
        - `label` string
        - `hint` string
        - `options` object[]
          - `value` union
            - string
            - number
          - `label` string
        - `validation` object
          - `minLength` integer
          - `maxLength` integer
        - `min` number
        - `max` number
        - `step` number
        - `minLength` integer
        - `maxLength` integer
      - `parameterGroups` object[]
    - `text_limits` object: Границы длины текста в символах для моделей озвучки (text-to-speech). Текст передаётся в `input.prompt` и описан в `input_schema.parameters`; это поле дополнительно объявляет те же границы. Запрос вне границ отвергается кодом 400 ДО создания генерации, кредиты не резервируются. У не-TTS моделей поле отсутствует.
      - `min_chars` integer, required: Минимальная длина текста озвучки в символах.
      - `max_chars` integer, required: Максимальная длина текста озвучки в символах.
    - `pricing` ModelPricing, required: 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`: Ключ отсутствует, неверный или отозван.
- `404`: Неизвестный `request_id` или `model`.
- `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)