Models

GET /v1/models

Returns the list of models available to the API key used in the request. Because inference keys are namespace-scoped, this endpoint returns only the models deployed in the key's namespace.

Request

curl https://api.cleverthis.com/v1/models \
  -H "Authorization: Bearer ct_live_YOUR_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-4o-mini",
      "object": "model",
      "created": 1720000000,
      "owned_by": "openai"
    },
    {
      "id": "anthropic/claude-3-5-haiku-20241022",
      "object": "model",
      "created": 1720000000,
      "owned_by": "anthropic"
    },
    {
      "id": "my-namespace/my-actor",
      "object": "model",
      "created": 1721000000,
      "owned_by": "cleveractors"
    }
  ]
}

Notes

• The id field in each model object is the string you pass as "model" in chat completion requests.
• Actor endpoints appear in this list alongside provider models — they are indistinguishable from the caller's perspective.
• owned_by is "cleveractors" for Actor endpoints and the upstream provider name for provider models.
• There is no GET /v1/models/{model} endpoint currently. To get details about a specific model, use the Dashboard Library or the management API.

Coming soon

A metadata extension field on each model object (context window, pricing, capability flags) is being added as a CleverThis extension to the OpenAI spec.