API Reference

Run a six-model deliberation from your own code. Every call returns a synthesized, attributed answer plus a public receipt. Base URL: https://xyntherium.com

Authentication

Create a key at /account/api-keys and send it as a Bearer token. The key is shown once — store it securely.

Authorization: Bearer xyn_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

POST/v1/verifyrequires API key

Run a full multi-AI verification. Returns the deliberation receipt.

curl -X POST https://xyntherium.com/v1/verify \
  -H "Authorization: Bearer $XYN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "What is the speed of light in a vacuum?"}'

{
  "id": "…", "tier": "master",
  "synthesized_answer": "The speed of light in a vacuum is exactly 299,792,458 m/s …",
  "confidence_band": "high", "consensus_score": 0.82,
  "attribution": { "spans": [ { "start": 0, "end": 38,
    "attribution_type": "provider_consensus",
    "supporting_providers": ["anthropic","openai","google"] } ] },
  "providers": [ { "provider": "anthropic", "model": "claude-opus-4-8",
    "latency_ms": 1840, "cost_cents": 0.31, "responded": true } ],
  "receipt": { "slug": "…", "url": "https://xyntherium.com/receipt/…" }
}

Optional body fields: providers (subset of the six, min 3). Tier is determined by your key.

POST/v1/verify/imagerequires API key

Verify a prompt about an image. The request contract is final; image routing ships in Phase 5.3 (returns 501 not_implemented until then). Body: prompt + image_url or image_base64.

GET/v1/usagerequires API key

Usage for the calling key in the current billing period.

curl https://xyntherium.com/v1/usage -H "Authorization: Bearer $XYN_KEY"

GET/v1/healthno auth

Provider availability snapshot. No authentication.

curl https://xyntherium.com/v1/health

Errors

Errors return { "error": { "code", "message" } } with standard status codes: 400 (malformed), 401 (missing/invalid key), 403 (revoked), 429 (rate limited — see Retry-After), 500/502 (server).