Créditos

Leer el saldo

GET /api/v1/credits requiere credits:read y devuelve únicamente el saldo disponible como número entero.

curl https://sci-draw.com/api/v1/credits \
  -H 'Authorization: Bearer sd_YOUR_KEY'

{ "success": true, "data": { "balance": 125 } }

Ciclo de vida de la reserva

Los créditos se reservan de forma atómica en cuanto se acepta un trabajo por primera vez. Así se evita que dos peticiones simultáneas gasten el mismo saldo. Una petición idempotente repetida reutiliza la reserva original.

• Los trabajos correctos liquidan exactamente una vez el importe reservado.
• Los fallos terminales liberan exactamente las asignaciones originales.
• El trabajo reintentado internamente no crea una reserva nueva.
• credits_reserved y credits_consumed son visibles en cada trabajo.

Si el saldo disponible es insuficiente al crear el trabajo, la API devuelve HTTP 402 con INSUFFICIENT_CREDITS; no se crea ni trabajo ni reserva.