API Guide
CleverThis exposes two API surfaces with separate authentication:
Inference API — OpenAI-compatible endpoints for chat completions and model listing. Uses ct_live_ keys. This is the API your applications call to run inference.
Management API (A2A) — A JSON-RPC control plane at /a2a for programmatic management of workspaces, namespaces, API keys, providers, usage, and billing. Uses ct_mgmt_ keys. This is the API for automation, CI/CD pipelines, and building on top of CleverThis.
Base URLs
| Surface | Base URL |
|---|---|
| Inference API | https://api.cleverthis.com/v1 |
| A2A Control Plane | https://api.cleverthis.com/a2a |
For self-hosted deployments, replace api.cleverthis.com with your own domain.
What's in this guide
- Authentication — key types, how to send them, key scoping
- OpenAI-Compatible API — chat completions, models listing
- Actors API — calling Actor endpoints, Actor YAML configuration standard
- A2A Control Plane — management methods for workspaces, namespaces, keys, providers, usage, and billing
- Errors — error response shape, error codes
- Rate Limits — limits per plan tier
- SDKs & Clients — using the OpenAI SDK and curl with CleverThis