クレジット

残高を取得する

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 } }

確保のライフサイクル

クレジットは、ジョブが最初に受理された時点でアトミックに確保されます。これに より、同時に届いた 2 つのリクエストが同じ残高を二重に消費することを防ぎます。 冪等なリクエストを繰り返した場合は、最初の確保がそのまま再利用されます。

• 成功したジョブは、確保した額をちょうど一度だけ確定します。
• 終了状態の失敗では、元の割り当てをそのまま解放します。
• 内部で再試行が行われても、新たな確保は発生しません。
• credits_reserved と credits_consumed はどのジョブでも参照できます。

ジョブ作成時に利用可能な残高が不足している場合、API は HTTP 402 と INSUFFICIENT_CREDITS を返し、ジョブも確保も作成されません。