크레딧

잔액 조회

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를 반환하며, 작업도 예약도 만들어지지 않습니다.