# List models

> The model ids you can call, with their prices.

`GET https://api.gateway.clatterlabs.xyz/v1/models`

Returns every SuperCosmos 1.1 model id with its effort, capabilities and price per 1M tokens, plus retired ids. No key needed.

## Response

- `object` (string): Always `list`.
- `data` (Model[]): One entry per model id: `id`, `name`, `family`, `version`, `effort`, `capabilities`, `max_output_tokens` and `pricing` (`input` and `output` in USD per 1M tokens). The list shows only the first entry; the response has `supercosmos-flash`, `supercosmos-max` and `supercosmos-heavy`.
- `families` (object[]): The family id `supercosmos` with its version, context window, size, efforts and default effort.
- `retired` (object[]): Retired models: their ids, retirement date and replacement. Calling them answers `410 model_retired`.

## Example request

```bash
curl "https://api.gateway.clatterlabs.xyz/v1/models" \
  -H "Authorization: Bearer $CLATTER_API_KEY" \
  -H "X-Clatter-Account: $CLATTER_ACCOUNT_ID"
```

## Example response

```json
{
  "object": "list",
  "data": [
    {
      "id": "supercosmos-flash",
      "object": "model",
      "created": 1793232000,
      "owned_by": "clatter-labs",
      "name": "SuperCosmos Flash",
      "family": "SuperCosmos",
      "version": "1.1",
      "effort": "flash",
      "description": "Fastest SuperCosmos effort. Quick answers, tool loops and everyday tasks.",
      "capabilities": {
        "chat_completions": true,
        "streaming": true,
        "tools": true,
        "reasoning": false,
        "vision": false
      },
      "max_output_tokens": 32768,
      "pricing": {
        "currency": "USD",
        "unit": "1M tokens",
        "input": 1.6,
        "output": 3.4,
        "long_context": "Long-context input above 262K tokens: 1.5x"
      }
    }
  ],
  "families": [
    {
      "id": "supercosmos",
      "name": "SuperCosmos",
      "version": "1.1",
      "context_window": 1048576,
      "context_label": "1M",
      "parameters": {
        "total": "550B",
        "active": "55B",
        "architecture": "Mixture-of-Experts"
      },
      "efforts": [
        "flash",
        "max",
        "heavy"
      ],
      "default_effort": "flash"
    }
  ],
  "retired": [
    {
      "id": "line-code",
      "ids": [
        "line-code-fast",
        "line-code-ultra",
        "line-code-ultra-fast"
      ],
      "retired_at": "2026-11-01",
      "replacement": "supercosmos",
      "status": 410,
      "code": "model_retired"
    }
  ]
}
```