---
title: "Оценить стоимость генерации"
method: POST
path: "/v1/models/{model}/estimate"
tags: ["Models"]
---

# Оценить стоимость генерации

`POST /v1/models/{model}/estimate`

## Request

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

Возвращает детерминированную стоимость генерации в кредитах для
переданного `input` без постановки в очередь и без списания. Удобно,
чтобы показать цену пользователю до `submit`. Доступно любому валидному
ключу (scope не требуется).

Ключ `input`, который модель не применит, перечисляется в `warnings` —
так же, как в ответе `submit`. Оценка — удобный способ проверить набор
параметров до запуска.

## Path parameters

- `model` string, required

## Request body

- EstimateRequest
  - `input` object, required: Параметры генерации, для которых считается стоимость. Тот же формат, что и `input` в `POST /v1/models/{model}` — см. `input_schema` модели.

## Response `200`

Оценка стоимости в кредитах.

- EstimateResponse: Детерминированная оценка стоимости генерации в кредитах.
  - `credits` number, required: Стоимость переданного `input` на этой модели, в кредитах.
  - `warnings` InputWarning[]: Параметры `input`, которые модель не применит: по элементу на ключ, не больше 20 элементов. Поле присутствует, только когда такие параметры есть.
    - `code` string, required: Машинная причина: - `unknown_parameter` — ключ серверу неизвестен (например, опечатка) и отбрасывается у любой модели; - `unsupported_parameter` — ключ существует, но эта модель его не объявляет и не использует; - `audio_dropped` — звук был включён, но звуковая дорожка не прошла проверку безопасности модели: ролик создаётся без звука, стоимость запроса не меняется. Приходит только в ответах о состоянии запроса (`RequestWarnings`), `parameter` равен `generate_audio`. Список причин может пополняться: незнакомое значение обрабатывайте как «параметр не применён».
    - `parameter` string, required: Имя ключа из `input` (длинное имя обрезается до 64 символов).
    - `message` string, required: Пояснение на английском: называет параметр и перечисляет параметры, которые модель объявляет в `input_schema`. Для `audio_dropped` — сообщает, что ролик создаётся без звука.

## Other responses

- `401`: Ключ отсутствует, неверный или отозван.
- `404`: Неизвестный `request_id` или `model`.
- `422`: Параметры `input` не подходят выбранной модели.
- `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)