Skip to main content

Quickstart — the offering ladder

All rungs share the same plumbing: sign in at clara.paresium.com, create an API key, and point at the beta API (https://rc.dev.paresium.com during beta). Authentication is a Bearer token (ak_… API key, or your session JWT from the portal).

① Direct routing​

Quote first, execute with the quote — you always know the worst case before you spend:

curl -X POST $CLARA_API/v1/direct/quote \
  -H "Authorization: Bearer $CLARA_API_KEY" -H "Content-Type: application/json" \
  -d '{"task": "summarize", "content": "…", "quality": "economy"}'
# → { "quote_id": "…", "hold_credits": 25 }

curl -X POST $CLARA_API/v1/direct/execute \
  -H "Authorization: Bearer $CLARA_API_KEY" -H "Content-Type: application/json" \
  -d '{"task": "summarize", "content": "…", "quality": "economy", "quote_id": "…"}'
# → { "output": "…", "actual_credits": 2, "provenance_tier": "direct" }

Direct responses carry provenance_tier: "direct" — fast and metered, but not governance-attested. That's what the higher rungs add.

② Compliance check​

A fast pass / warn / block verdict with named reasons, callable on every message via MCP (tool compliance_check) or HTTP. See the BriefingDocument and Verdict shapes.

③ Briefing packet​

Clara reads the situation — tone, urgency, what's unsaid — and returns a briefing plus a clean prompt your own model can safely answer. Request shape: PrepareAndBriefRequest.

④ Governed execution​

The full pipeline: checks, briefing, a governed answer with your brand rules applied, and a settlement-stamped Record. Request shape: RunServicesRequest; settlement shape: Settlement.

Every rung leaves a Record

Whatever rung you're on, each run produces an immutable Record you can retrieve and audit — see The Record.