Кредиты

Чтение баланса

GET /api/v1/credits требует права credits:read и возвращает только доступный баланс целым числом.

curl https://sci-draw.com/api/v1/credits \
  -H 'Authorization: Bearer sd_YOUR_KEY'

{ "success": true, "data": { "balance": 125 } }

Жизненный цикл резерва

Кредиты резервируются атомарно в момент первого приёма задачи. Это не даёт двум одновременным запросам потратить один и тот же баланс. Повторный идемпотентный запрос переиспользует исходный резерв.

• Успешные задачи списывают зарезервированную сумму ровно один раз.
• Окончательные сбои освобождают ровно исходные начисления.
• Внутренние повторы не создают нового резерва.
• Поля credits_reserved и credits_consumed видны у каждой задачи.

Если при создании задачи доступного баланса не хватает, API возвращает HTTP 402 с кодом INSUFFICIENT_CREDITS; ни задача, ни резерв при этом не создаются.