▓ full surface— every gateway route, tiered by complexity
SIMPLE
MODERATE
COMPLEX
ESOTERIC
ping the surface — no spend · LIVE callable with this key · LOCKED needs a scope this key lacks (returns 401/403)
// Meta
GET/v1/health— HealthLIVE▸
Liveness + version + endpoint map. No auth.
scope:public
GET/v1/models— List modelsLIVE▸
The four virtual models: cognitum-auto / -low / -mid / -high.
scope:public
GET/v1/catalog— Product catalogLIVE▸
Public product/pricing catalog. No auth.
scope:public
GET/v1/openapi— OpenAPI specLIVE▸
The machine-readable spec the gateway serves.
scope:public
// Auth
POST/v1/verify— Verify keyLIVE▸
Introspect the current key: scopes, account, active/expiry.
scope:public · Send with no body — the key rides in the header. Great first call.
// Completions
POST/v1/messages/count_tokens— Count tokensLIVE▸
Token accounting for a message payload — no generation, no spend.
scope:completions:*