---
title: Оценка стоимости
description: "POST /v1/models/{model}/estimate — узнать цену генерации до запуска."
---

Узнайте точную стоимость генерации в кредитах, ничего не запуская и не списывая.

## Песочница

<ApiPlayground path="/v1/models/{model}/estimate" method="post" />

`POST /v1/models/:model/estimate` возвращает детерминированную стоимость переданного `input` на выбранной модели. Генерация не ставится в очередь, кредиты не резервируются и не списываются. Эндпоинт доступен любому валидному ключу — scope не требуется.

<Method name="POST" path="/v1/models/:model/estimate" />

## Запрос

<TypeTable
  type={{
    model: { type: 'string', description: 'Slug модели (в пути). Список — GET /v1/models.', required: true },
    input: { type: 'object', description: 'Те же параметры, что и при submit. Точную схему смотрите в GET /v1/models/{model} → input_schema.', required: true }
  }}
/>

<Tabs items={['cURL', 'TypeScript', 'Python']}>
<Tab value="cURL">

```bash
curl -X POST https://api.clipia.ai/v1/models/seedance-2-fast-i2v/estimate \
  -H "Authorization: Bearer $CLIPIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "aerial shot over a neon city",
      "duration": 8,
      "resolution": "1080p"
    }
  }'
```

</Tab>
<Tab value="TypeScript">

```ts
const { credits } = await clipia.models.estimate('seedance-2-fast-i2v', {
  prompt: 'aerial shot over a neon city',
  duration: 8,
  resolution: '1080p',
});
console.log(`Эта генерация стоит ${credits} кредитов`);
```

</Tab>
<Tab value="Python">

```python
estimate = client.models.estimate(
    "seedance-2-fast-i2v",
    {"prompt": "aerial shot over a neon city", "duration": 8, "resolution": "1080p"},
)
print(f"Эта генерация стоит {estimate.credits} кредитов")
```

</Tab>
</Tabs>

**Ответ `200`**

```json
{
  "credits": 40
}
```

<TypeTable
  type={{
    credits: { type: 'number', description: 'Стоимость переданного input на этой модели, в кредитах' }
  }}
/>

## Зачем это нужно

Стоимость операции детерминирована: она вычисляется из модели и параметров, а не из фактического времени работы. Поэтому её можно узнать заранее и показать пользователю до запуска.

Типичные применения:

- подтверждение цены перед дорогой генерацией видео в высоком разрешении;
- сравнение стоимости разных параметров (4 с против 8 с, 720p против 1080p);
- предварительная проверка бюджета в сценариях автоматизации, где генерация запускается без участия человека.

<Callout type="info" title="Оценка и факт совпадают">
Значение `credits` из `estimate` равно полю `cost` в ответе `submit` при тех же параметрах. Кредиты резервируются в момент `submit` и окончательно списываются при успехе; при `FAILED` возвращаются полностью.
</Callout>

## Ошибки

| HTTP | `code` | Когда |
|------|--------|-------|
| `404` | `not_found` | неизвестный slug модели |
| `422` | `model_input_invalid` | параметры не подходят выбранной модели |
| `429` | `rate_limit_exceeded` | превышен лимит запросов |