Model ids
Which model ids to call, efforts, and the models endpoints.
- Can I keep using an OpenAI model name with the Model API?No. Only SuperCosmos ids work. Other names answer 404 model_not_found.FAQ
- Can I pin my code to SuperCosmos 1.0?No. The SuperCosmos ids now run 1.1 and there is no separate 1.0 id on the Model API.FAQ
- How do I get details for one model?GET /v1/models/{id} returns one model's details and price. Unknown ids answer 404, retired ids 410.How-to
- How does reasoning_effort map to SuperCosmos efforts?low maps to Flash, medium to Max and high to Heavy when you use the family id supercosmos.Reference
- What does GET /v1/models return?Every SuperCosmos 1.1 id with effort, capabilities, max output and price, plus the family details and retired ids.Reference
- What is the family id supercosmos and the effort parameter?Send model: supercosmos with effort flash, max or heavy instead of a specific id. No effort means Flash.Explainer
- Which features does each model support?All three support chat completions, streaming and tools. Max and Heavy reason; none take image input.Reference
- Which Model API model is the cheapest?supercosmos-flash: $1.60 per 1M input tokens and $3.40 per 1M output tokens.FAQ
- Which model can write the longest answer?supercosmos-heavy, with up to 49,152 output tokens (reasoning included). Flash and Max allow 32,768.FAQ
- Which model id should my app use?Start with supercosmos-flash. Move a request type to max or heavy only when Flash keeps missing.FAQ
- Which model ids can I call on the Model API?supercosmos-flash, supercosmos-max and supercosmos-heavy, or the family id supercosmos with an effort.Reference
- Why does GET /v1/models say version 1.1?Since Nov 2, 2026 the SuperCosmos ids run SuperCosmos 1.1. The version field tells you which version answers.FAQ
- Will the model ids change when SuperCosmos gets a new version?They didn't for 1.1: the same ids switched from 1.0 to 1.1 at the same prices. Check version in GET /v1/models.FAQ
Still need help?
Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.
Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyzFor deleting your whole account or the data of one service.