Биллинг и цены
Модель предоплаты, расчёт токенов и стоимость запросов.
Модель предоплаты
Konergy использует модель prepaid wallet (предоплатный кошелёк), а не подписку. Вы пополняете баланс, и средства списываются за каждый успешный запрос. Неиспользованные средства остаются на балансе.
Если на балансе недостаточно средств для выполнения запроса, вы получите ошибку 402 PAYMENT_REQUIRED. Подробнее в разделе Обработка ошибок.
Тарификация
| Параметр | Значение |
|---|---|
| Тариф | 10 000 ₽ за 1 000 000 токенов (1 MTok) |
| Стоимость за токен | 0,01 ₽ (1 копейка) |
| Минимальный заряд | 1 копейка за запрос |
| Валюта | RUB (внутренний учёт в копейках) |
Расчёт токенов
Количество токенов рассчитывается на основе размера изображения:
tokens = ceil((width * height * 1.2) / 784)Например, для изображения 1024×768: ceil((1024 × 768 × 1.2) / 784) = ceil(1204.9) = 1205 токенов.
Расчёт стоимости
Стоимость запроса в копейках (1 копейка = 1 токен):
cost_kopecks = tokensДля 1205 токенов: 1205 копеек (12,05 ₽).
Процесс списания (billing flow)
- HOLD — при получении запроса система резервирует расчётную стоимость из баланса кошелька
- PROCESS — запрос обрабатывается системой Konergy
- CONSUME — при успехе: фактическая стоимость списывается, излишек возвращается на баланс
- RELEASE — при ошибке: вся зарезервированная сумма возвращается на баланс
Такая модель hold-then-consume гарантирует, что вы никогда не будете списаны за неудачные запросы, а параллельные запросы не смогут перерасходовать баланс.
Лимиты расходов организации
Для организаций можно установить ежемесячный лимит расходов (spend limit). При достижении лимита все ключи организации получат ошибку 402 SPEND_LIMIT_EXCEEDED.
| Действие | Endpoint | Доступ |
|---|---|---|
| Получить лимит | GET /organizations/:orgId/spend-limit | Пользователи с правом view_billing |
| Установить/обновить | PUT /organizations/:orgId/spend-limit | Owner, admin |
| Снять лимит | DELETE /organizations/:orgId/spend-limit | Owner, admin |
Минимальный лимит: 50 000 копеек (500 ₽). Можно установить порог предупреждения (warningThreshold) от 0.1 до 1.0.
Пополнение баланса
Баланс пополняется через личный кабинет. Платежи обрабатываются безопасно. После успешной оплаты средства зачисляются на баланс автоматически.