What is the models:invoke permission?
models:invoke is the key permission that allows calling models through the Model API (POST /v1/chat/completions). The Model API preset in the Console sets it for you.
| Permission | Allows |
|---|---|
models:invoke | Call models through the Model API |
runs:write | Create and cancel Agent API runs |
runs:read | Read Agent API runs, events and results |
account:read | Read credit balance and usage |
A key without models:invoke gets 403 insufficient_scope on the Model API. Give each key only what it needs. Listing models (GET /v1/models) doesn't need any key.
Good to know#
- Retry only
429and 5xx errors, with backoff; honourRetry-Afterwhen it's sent. Which errors to retry - Model ids:
supercosmos-flash,supercosmos-max,supercosmos-heavy(SuperCosmos 1.1). Which to call - Every response has an
X-Request-Id; log it so a request can be found later. Why log it
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.