Skip to main content

OpenAI-Compatible API

CleverThis implements a subset of the OpenAI Chat Completions API. Any tool, SDK, or application built against the OpenAI API can point at CleverThis with minimal or no code changes — just swap the base URL and the API key.

The OpenAI-compatible surface is the only endpoint used for inference. Management operations (namespace creation, key management, billing, etc.) are handled separately by the A2A control plane and require a ct_mgmt_ key.

Base URL

https://api.cleverthis.com/v1

Supported endpoints

MethodPathDescription
POST/v1/chat/completionsCreate a chat completion
GET/v1/modelsList available models

CleverThis does not currently expose /v1/embeddings, /v1/images, or /v1/audio endpoints. These are on the roadmap.

OpenAI SDK compatibility

The CleverThis inference API is compatible with OpenAI client libraries in Python, TypeScript/JavaScript, Go, and others. Set base_url to https://api.cleverthis.com/v1 and api_key to your ct_live_ key.

See SDKs & Clients for ready-to-run examples.

What's in this section

  • Chat CompletionsPOST /v1/chat/completions full reference with examples
  • ModelsGET /v1/models reference
Coming soon

Embeddings (/v1/embeddings) and response streaming documentation are being added.