Кредиты и оплата

.md

1 кредит = 1 цент. Как считается цена картинок, видео и чата, когда списываются кредиты, эндпоинт остатка GET /v1/credits и стоимость каждого запроса.

Курс

1 кредит = 1 цент США ($0.01). Все цены в API и каталоге — в кредитах. Баланс пополняется и отслеживается в дашборде.

Как считается цена

Цена зависит от модели и параметров запроса. Актуальные тарифы — в каталоге моделей и в GET /v1/models (поле pricing).

Модальность Формула Пример
Картинки цена за тир разрешения (1K / 2K / 4K) nano-banana-2: 1K = 8, 2K = 14, 4K = 24
Видео кредиты/сек × длительность × множитель режима + надбавки kling-3: 12/сек, режим pro ×1.4 → 5 сек = 84
Чат за 1М входных + за 1М выходных токенов (минимум 1 кредит за ответ) gpt-4o-mini: 25 вход / 90 выход за 1М

Остаток по API

GET /v1/credits — программная проверка баланса (для мониторинга и алертов «кредиты кончаются»):

curl https://api.souz.ai/v1/credits -H "Authorization: Bearer sk-souz-..."

{
  "object": "credits",
  "balance": 12345,
  "reserved": 84,
  "currency": "credits",
  "credit_value_usd": 0.01,
  "rate_limit": { "requests_per_minute": 100 }
}

balance — доступно к трате, reserved — временно удержано выполняющимися джобами (вернётся в balance при успехе/сбое). Бонусом — действующий лимит запросов твоего ключа.

Когда списываются кредиты

  1. При создании запроса резервируется ожидаемая стоимость.
  2. Успех → резерв списывается (для чата — пересчитывается по фактическим токенам).
  3. Сбой → полный возврат резерва автоматически. За неудачные генерации ты не платишь.

Если баланса не хватает, запрос сразу отклоняется с ошибкой insufficient_credits (HTTP 402).

Стоимость каждого запроса

  • Картинки и видео: поле price в объекте джобы (и в ответе создания, и при опросе GET /v1/jobs/{id}).
  • Чат: поле usage.cost в ответе (и в последнем чанке при стриминге).
{ "usage": { "prompt_tokens": 16, "completion_tokens": 120, "cost": 3 } }

История расходов

Полная история запросов и график расходов по дням и моделям — в дашборде, раздел «История».