Credits

Guthaben lesen

GET /api/v1/credits verlangt credits:read und liefert ausschließlich das verfügbare Guthaben als ganze Zahl.

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

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

Lebenszyklus einer Reservierung

Credits werden atomar reserviert, sobald ein Job erstmals angenommen wird. So können zwei gleichzeitige Anfragen nicht dasselbe Guthaben ausgeben. Eine wiederholte idempotente Anfrage nutzt die ursprüngliche Reservierung weiter.

• Erfolgreiche Jobs rechnen den reservierten Betrag genau einmal ab.
• Endgültige Fehlschläge geben exakt die ursprünglichen Zuteilungen frei.
• Intern wiederholte Arbeit erzeugt keine neue Reservierung.
• credits_reserved und credits_consumed sind an jedem Job sichtbar.

Reicht das verfügbare Guthaben beim Anlegen des Jobs nicht aus, antwortet die API mit HTTP 402 und INSUFFICIENT_CREDITS; es entsteht weder ein Job noch eine Reservierung.