Skip to content
Fous Docs
MarkdownStudio

Billing and credits

What search, runs, queries and builds cost, when credits are charged, and where to manage credits, limits and spending.

ActivityPrice
Search, method details, run and build status, the accountFree
A completed run1 credit
A query that answers5 credits
A public build within your plan's monthly allowanceFree
A public build beyond the allowance, or a private build100 credits
Repairs, and anything that fails or is cancelledFree

One credit is $0.01 at pay-as-you-go prices. Plans are on fous.com/pricing.

  • A query holds 5 credits and charges them for any answer, even partial. No answer gives them back.
  • A build holds 100 and charges only when it makes a method or a version. An in-place improvement is free and does not use the allowance. Changing your own private method is not charged as private again.

Limits and spending

GET /v1/account shows your balance, limits, free builds and prices:

Terminal
curl https://api.fous.com/v1/account \  -H "Authorization: Bearer $FOUS_API_KEY"
JSON
{  "organization": { "id": "org_01M4CD7TVHDBPFQHZD05XMW5PB", "name": "Agent Test" },  "credits": { "balance": 585, "balance_usd": 5.85 },  "limits": {    "requests_per_minute": 60,    "concurrent_runs": 8,    "monthly_spend_limit_credits": null  },  "builds": { "free_per_month": 20, "used_this_month": 9 },  "prices": {    "search": 0,    "run": 1,    "query": 5,    "build_after_allowance": 100,    "private_build": 100  },  "key": {    "kind": "user",    "name": "Server",    "client_name": null,    "expires_at": null,    "last_used_at": "2026-10-23T09:11:15.000Z"  }}

In Studio, Billing holds credits, plans and auto-recharge. Usage shows spending, and its Limits tab sets a monthly spend limit and alerts. A call your credits or spend limit do not cover is refused, free:

JSON
{  "error": {    "code": "insufficient_credits",    "message": "This run costs 1 credit, and your organization has 0.",    "next_step": "Add credits at https://app.fous.com/billing. Nothing was charged.",    "required_credits": 1,    "available_credits": 0,    "billing_url": "https://app.fous.com/billing",    "doc_url": "https://docs.fous.com/guides/errors#insufficient_credits",    "request_id": "req_mh7c2k9xQ1v3Zt8LbN0pRwY4"  }}

Negotiated agreements are managed in Studio under Billing. Questions: billing@fous.com.