點數

讀取餘額

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，且不會 建立任何任務或預留。