Créditos

Consultar o saldo

GET /api/v1/credits exige credits:read e retorna apenas o saldo disponível como número inteiro.

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

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

Ciclo de vida da reserva

Os créditos são reservados de forma atômica assim que um job é aceito pela primeira vez. Isso impede que duas requisições simultâneas gastem o mesmo saldo. Uma requisição idempotente repetida reaproveita a reserva original.

• Jobs bem-sucedidos liquidam exatamente uma vez o valor reservado.
• Falhas terminais liberam exatamente as alocações originais.
• Retentativas internas não criam uma nova reserva.
• credits_reserved e credits_consumed aparecem em todo job.

Se o saldo disponível for baixo demais na criação do job, a API retorna HTTP 402 com INSUFFICIENT_CREDITS; nenhum job nem reserva é criado.