Usage & Billing
How credits and costs work in coSPEC
Credits
coSPEC uses a credit system. 1 credit = $1.
Beta accounts start with $25 in free credits.
What Uses Credits
Sandbox compute time, billed from sandbox start to sandbox stop. The rate depends on the sandbox size configured on the template:
| Size | Rate |
|---|---|
Small (s) | $0.01 / min |
Medium (m) | $0.03 / min |
Large (l) | $0.06 / min |
Agent API costs (Anthropic tokens) are separate — you use your own Anthropic key.
Checking Your Balance
The dashboard home page shows your current credit balance.
You can also check via the API:
curl https://api.cospec.io/v1/usage/credits \
-H "Authorization: Bearer csk_live_..."Usage Tracking
Get a breakdown of usage by run:
curl https://api.cospec.io/v1/usage/detailed \
-H "Authorization: Bearer csk_live_..."For a line-item log with balance snapshots, use GET /v1/usage/logs.
Non-Billable Errors
Platform failures — like sandbox creation errors or internal errors — are not charged. You only pay for successful sandbox compute time.
Guardrails as Cost Control
Set maxCostUsd and timeoutSeconds on templates or per-run to cap spend for agent cost. When a guardrail triggers, the run stops and no further compute is billed.