Оценка стоимости

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

ПесочницаСкопировать ссылку на раздел

Authorization: Bearer <CLIPIA_API_KEY>

curl -X POST "https://example.com/v1/models/nano-banana-2/estimate" \  -H "Content-Type: application/json" \  -d '{    "input": {      "prompt": "a sunset over mountains, cinematic",      "aspect_ratio": "16:9"    }  }'

{  "credits": 40}

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

ЗапросСкопировать ссылку на раздел

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"
    }
  }'

Ответ 200

{
  "credits": 40
}

Если в input есть ключ, который модель не применит (опечатка, параметр другой модели), оценка перечисляет его в warnings — в том же виде, что и отправка. Так набор параметров можно проверить до запуска.

Зачем это нужноСкопировать ссылку на раздел

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

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

Та же логика расчёта используется при отправке: при тех же параметрах credits совпадает с cost в ответе POST /v1/models/{model}. Кредиты резервируются при отправке, списываются при успехе и полностью возвращаются при ошибке генерации.

ОшибкиСкопировать ссылку на раздел