Models

List the models available to your account, with capabilities and current pricing. Both endpoints require authentication and work with the OpenAI SDKs' models.list() / models.retrieve() helpers.

List models#

GET/v1/models

Returns every public Claud model. Models outside your plan are still listed with available_on_plan: false so you can show upgrade paths in your own UI.

JSON

{
  "object": "list",
  "data": [
    {
      "id": "claud-5.1",
      "object": "model",
      "created": 1767225600,
      "owned_by": "fable",
      "display_name": "Claud 5.1",
      "description": "Our most capable general-purpose model.",
      "context_window": 128000,
      "max_output_tokens": 8192,
      "capabilities": { "vision": false, "tools": true, "json": true, "reasoning": false, "streaming": true },
      "pricing": {
        "input_per_million_usd": "0.5600",
        "output_per_million_usd": "1.6800",
        "cached_input_per_million_usd": "0.0700"
      },
      "available_on_plan": true,
      "deprecated": false
    }
  ]
}

idstring: The slug to pass as model in requests.
context_windowinteger: Maximum prompt plus completion tokens. Your plan's max_context_tokens may be lower.
max_output_tokensinteger: Hard cap on max_tokens for this model.
capabilitiesobject: Booleans for vision, tools, json, reasoning and streaming.
pricingobject | null: Current list prices in USD per million tokens. Off-peak discounts and cache hits are applied automatically at request time; see Tokens & billing.
available_on_planboolean: Whether your current plan can call this model.
deprecatedboolean: Deprecated models keep working until their retirement date but should not be used for new work.

Retrieve a model#

GET/v1/models/{id}

Accepts a slug or any alias (for example claud-latest) and returns the same object as above for that model. Unknown or private models return 404 model_not_found.

Examples#

curl https://api.claudkey.com/v1/models \
  -H "Authorization: Bearer $CLAUD_API_KEY"

curl https://api.claudkey.com/v1/models/claud-5.1 \
  -H "Authorization: Bearer $CLAUD_API_KEY"

For a human-readable comparison see Models; the table there is generated from the same catalogue.