Models - ClearMaas

What’s available

ClearMaas routes to nine upstream providers. Models are addressed by provider-prefixed ID:

Prefix	Provider	Examples (call `/v1/models` for the live catalog)
`openai/`	OpenAI	`openai/gpt-4o-mini`, `openai/gpt-5`, `openai/o3-mini`, `openai/gpt-image-1`, `openai/tts-1`
`anthropic/`	Anthropic	`anthropic/claude-sonnet-4.6`, `anthropic/claude-opus-4.7`
`google/`	Google Gemini	`google/gemini-2.5-flash`, `google/gemini-3-pro-preview`, `google/imagen-4.0-generate-001`
`deepseek/`	DeepSeek	`deepseek/deepseek-chat`, `deepseek/deepseek-reasoner`
`grok/`	xAI Grok	`grok/grok-4-fast-reasoning`, `grok/grok-imagine-image`
`qwen/`	Alibaba Qwen	`qwen/qwen3.6-plus`, `qwen/qwen3-vl-235b-a22b-thinking`, `qwen/qwen3-max`
`kimi/`	Moonshot Kimi	`kimi/kimi-k2.5`, `kimi/kimi-k2.6`
`minimax/`	MiniMax	`minimax/minimax-m2.7`, `minimax/minimax-m2.5-highspeed`
`kling/`	Kling (video)	`kling/kling-v3-omni`, `kling/kling-v2-6` �?see Kling Video

Whichever model you’d call against the provider’s own API, you can call against ClearMaas under the prefixed ID. The catalog is exactly what each upstream publishes.

List all models programmatically

curl https://api.clearmaas.com/v1/models \
-H "Authorization: Bearer sk-..."

from openai import OpenAI

client = OpenAI(
  base_url="https://api.clearmaas.com/v1",
  api_key="sk-...",
)

models = client.models.list()
for m in models.data:
  print(m.id, m.owned_by)

import OpenAI from "openai";

const openai = new OpenAI({
baseURL: "https://api.clearmaas.com/v1",
apiKey: "sk-...",
});

const models = await openai.models.list();
for (const m of models.data) {
console.log(m.id, m.owned_by);
}

Response shape

{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-4o",
      "object": "model",
      "created": 1626777600,
      "owned_by": "openai",
      "supported_endpoint_types": ["openai"]
    },
    {
      "id": "anthropic/claude-sonnet-4.6",
      "object": "model",
      "owned_by": "anthropic",
      "supported_endpoint_types": ["anthropic", "openai"]
    }
  ]
}

The list only includes models your account has access to and that have a pricing ratio configured. See the API Reference / Models for the full endpoint spec.

Get one model

curl https://api.clearmaas.com/v1/models/openai/gpt-4o-mini \
-H "Authorization: Bearer sk-..."

client.models.retrieve("openai/gpt-4o-mini")

Naming conventions

Model IDs in ClearMaas are provider-prefixed by default. The prefix tells you (and your client-side logs) exactly which provider will serve the call before the request even leaves your machine. The bare upstream name (e.g. gpt-4o-mini) may also work if your administrator has configured it as an alias on a channel, but the default listing in /v1/models always uses the prefixed form �?code written against the prefixed names is portable across deployments.

Picking by capability

You need�?	Try
Cheapest chat	`openai/gpt-4o-mini`, `google/gemini-2.5-flash-lite`
Strongest reasoning	`openai/o3-mini-high`, `openai/gpt-5-pro`, `anthropic/claude-opus-4.7`
Long context + cheap	`google/gemini-2.5-flash`
Web search built-in	`openai/gpt-4o-search-preview` (chat completions), or any Grok model on `/v1/responses` with the `web_search` tool �?see Web search
Vision input	`openai/gpt-4o-mini`, `google/gemini-2.5-flash`, `grok/grok-4-fast-reasoning`
Image generation	`openai/gpt-image-1-mini`, `google/imagen-4.0-fast-generate-001`, `grok/grok-imagine-image`
Auto-pick cheapest	`clearmaas/auto` �?see Auto Router
Video generation	`kling/kling-v3-omni`, `kling/kling-v3` �?see Kling Video

​What’s available

​List all models programmatically

​Response shape

​Get one model

​Naming conventions

​Picking by capability