# Model API

> Call SuperCosmos 1.1 from your own code with any OpenAI SDK. Pay as you go per token, from credits; new accounts get $5 of free credit.

The **Model API** lets you call **SuperCosmos 1.1**, Clatter Labs' model, straight from your own code. It speaks the OpenAI Chat Completions format, so any OpenAI SDK works by changing the base URL: streaming, tool calling and token usage included. You pay as you go per token from your credits, and every new account starts with **$5 of free credit**.

<CardGroup cols={2}>
<Card title="Quickstart" icon="rocket" href="/model-api/quickstart">Create a key and make your first call in two minutes.</Card>
<Card title="API reference" icon="code" href="/api-reference/model-api/introduction">`GET /v1/models` and `POST /v1/chat/completions`.</Card>
</CardGroup>

## At a glance

| | |
| --- | --- |
| Base URL | `https://api.gateway.clatterlabs.xyz/v1` |
| Format | OpenAI Chat Completions (stream and non-stream, tools, `usage`) |
| Auth | `Authorization: Bearer clsk_...` (permission `models:invoke`) + `X-Clatter-Account: CL-...` |
| Billing | Pay as you go per token, at the price of the model id you call |
| Free credit | $5 for every new account |
| Input | Text only |

## Models and prices

Each effort is its own model id:

| Model id | Model | Effort | Input / 1M tokens | Output / 1M tokens |
| --- | --- | --- | --- | --- |
| `supercosmos-flash` | SuperCosmos | Flash | $1.60 | $3.40 |
| `supercosmos-max` | SuperCosmos | Max | $1.80 | $3.80 |
| `supercosmos-heavy` | SuperCosmos | Heavy | $2.00 | $4.40 |

**Long-context input above 262K tokens: 1.5×** (SuperCosmos): a request whose prompt is over 262K tokens bills its whole input at 1.5× the rate above.

Output includes reasoning tokens. Prices are the same as everywhere else on Clatter Labs (see [Models](/models)). `GET /v1/models` returns the same list with prices.

You can also send the family id with an effort: `"model": "supercosmos"` plus `"effort"` (`flash` / `max` / `heavy`). `reasoning_effort` works too: `low`, `medium` and `high` map to the three efforts. Without an effort, the family id uses Flash.

Line Code ids (`line-code-fast`, `line-code-ultra`, `line-code-ultra-fast`) were retired on Nov 1, 2026 and answer `410 model_retired` ([details](/models/line-code-retired)).

## Billing

- **Credits only.** Model API calls are paid from your [credits](/billing/credits), pay as you go. Plans (Free included) don't cover API calls; they cover app usage like Line CLI, Cosmos Agent and Telegram. Buy credits in any amount from $1 to $800 per purchase.
- **$5 free credit.** Every new account starts with $5 of credit. Accounts that received the earlier one-time Model API trial spend what's left of it first.
- **Every model on every plan.** You pay the model's price.
- **Pay as you go.** Each call costs `input tokens × input price + output tokens × output price` for the model id you called, rounded up to the next millionth of a dollar. The `usage` in every response is what's billed. Input tokens include a short Clatter Labs instruction block added to every request.
- **Out of credits** answers `402 out_of_credits`.
- **Abuse policy.** Your API key acts for your account, so your end users' text counts against it. See the [Abuse policy](/policies/abuse).

Every call shows in the Console under **Logs** and **Usage** as *Model API*.

## Limits

- **Rate limit:** the key's own limit, 10 to 120 requests per minute, set when you create it (`429 rate_limited` with `Retry-After`).
- **Request size:** up to 3 MB and 800 messages; up to 64 tools.
- **Not supported:** image input, `n` > 1, `logprobs`, and the other OpenAI endpoints (embeddings, images, audio, files, responses).