Skip to content
CCautus
Live demo

API documentation

Cautus Intelligence is OpenAI-compatible. Point your SDKs at the gateway, use an mg_ key, and pick any marketplace slug you are allowed to call. Hosts keep compute private; gated models require prior approval. Every billable completion can be verified on the Litheum ledger.

Guided demoPlayground

Base URL + model slug

https://api.cautusintelligence.com

Use marketplace slug as model, e.g. aegis/pop-rpc-scorer. Interactive OpenAPI: https://api.cautusintelligence.com/docs

Happy path

  1. Register or sign in · create mg_ key
  2. List models · request access if gated
  3. POST /v1/chat/completions
  4. Read modelgov receipt · open Litheum explorer

1. Create an account key

Sign in at /login, open Account, and create a key. Or use admin bootstrap:

curl https://api.cautusintelligence.com/v1/keys \
  -H "X-Admin-Key: $ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"demo","owner_email":"you@company.com"}'

2. List models

curl https://api.cautusintelligence.com/v1/models
curl "https://api.cautusintelligence.com/marketplace/models?online_only=true"

3. Request access (gated hosts)

curl https://api.cautusintelligence.com/marketplace/models/aegis/pop-rpc-scorer/access-requests \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Internal R&D, not a competitor","requester_org":"Northstar"}'

Hosts approve or deny. Competitor email domains configured on the listing are rejected automatically.

4. Chat completions

curl https://api.cautusintelligence.com/v1/chat/completions \
  -H "Authorization: Bearer mg_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aegis/pop-rpc-scorer",
    "messages": [{"role":"user","content":"Score this runner's last 50 critical RPCs for PoP credit"}]
  }'

Response includes standard OpenAI fields plus a modelgov object: cost, host share, platform fee, Litheum tx hashes.

5. Host heartbeat

curl https://api.cautusintelligence.com/marketplace/models/community/my-specialist/heartbeat \
  -H "Content-Type: application/json" \
  -d '{"compute_status":"online","compute_region":"us-east-1"}'

6. Verify on Litheum

curl https://api.cautusintelligence.com/chain/tx/0x...
curl https://api.cautusintelligence.com/chain/stats
Open explorer UI

Fees

Hosts set input/output $/1M prices. Cautus Intelligence takes a 2.5–6% rail fee by contribution mode; the remainder splits to the model owner and (on matched jobs) the compute provider. See pricing.