Usage & Billing

Credits

coSPEC uses a credit system. 1 credit = $1.

Beta accounts start with $25 in free credits.

What Uses Credits

Sandbox compute time — $0.10 per minute, billed from sandbox start to sandbox stop.

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:

Terminal

curl https://api.cospec.io/v1/usage/credits \
  -H "Authorization: Bearer csk_live_..."

Usage Tracking

Get a breakdown of usage by run:

Terminal

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. When a guardrail triggers, the run stops and no further compute is billed.