What's the difference between the Model API and the Agent API?
Both are paid from credits and use the same kind of key, but they do different jobs.
| Model API | Agent API | |
|---|---|---|
| What you get | A model reply (chat completion) | A full agent run that uses tools and a cloud computer |
| Format | OpenAI Chat Completions | Clatter Labs runs: create, stream events, get results, cancel |
| Base URL | https://api.gateway.clatterlabs.xyz/v1 | https://api.agent.clatterlabs.xyz |
| Key permission | models:invoke | runs:write, runs:read |
| Choose the tier | Model id | tier on the run |
| You pay for | Tokens | Tokens plus computer time, actions, browser time and storage writes |
Pick the Model API when you want to control the loop yourself: your prompts, your tools, your app. Pick the Agent API when you want Cosmos to do a task end to end and hand you the result.
See the Model API overview and the Cosmos Agent API.
Still need help?#
- General support: support@clatterlabs.com or team@clatterlabs.xyz
- Infrastructure questions, or permanent deletion of your data (your whole account or one service): infrastructure@clatterlabs.xyz
We usually reply within the first hour, and always within 24 hours. A full support team is with you.
Related articles
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.