Model API
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.
Quickstart
Create a key and make your first call in two minutes.
API reference
GET /v1/models and POST /v1/chat/completions.
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). 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).
Billing
- Credits only. Model API calls are paid from your 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 pricefor the model id you called, rounded up to the next millionth of a dollar. Theusagein 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.
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_limitedwithRetry-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).