LogoLogoAPI 文档
LogoLogoAPI 文档
首页
概览鉴权与幂等图片生成图片编辑图片转换任务与有限等待积分错误速率与并发限制API 更新日志
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,不会创建任务或预留。

任务与有限等待

轮询异步任务并读取经过清理的结果

错误

稳定的错误包装、错误码和 HTTP 状态

目录

查询余额
预留生命周期