Billing and Credits
Billing behavior is predictable: balance is checked before dispatch and debited after completion.
Before a request is dispatched upstream, Sylica validates organization balance. If balance is insufficient, the API returns 402 insufficient_credits and no upstream model call is attempted.
Credits are deducted after successful request processing based on measured usage. This lets you show users accurate post-request balances and reason about cost per workflow.
Balance Endpoint Example
json
{
"balance_cents": 1250,
"balance_usd": 12.5
}Implementation Guidance
Poll credits periodically on dashboard views instead of on every navigation. Cache low-volatility balance responses briefly on the server to reduce backend pressure while keeping user-visible data fresh.