API 文档
积分
查询余额并理解预留机制
查询余额
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。
创建任务时余额不足会返回 HTTP 402 和 INSUFFICIENT_CREDITS,不会创建任务或预留。

API 文档