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.