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

## Курс

**1 кредит = 1 цент США ($0.01).** Все цены в API и каталоге — в кредитах. Баланс пополняется и отслеживается в [дашборде](https://dash.souz.ai).

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

Цена зависит от модели и параметров запроса. Актуальные тарифы — в [каталоге моделей](/models) и в `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` — программная проверка баланса (для мониторинга и алертов «кредиты кончаются»):

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

```json
{
  "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` в ответе (и в последнем чанке при стриминге).

```json
{ "usage": { "prompt_tokens": 16, "completion_tokens": 120, "cost": 3 } }
```

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

Полная история запросов и график расходов по дням и моделям — в [дашборде](https://dash.souz.ai), раздел «История».