Why does the Model API need both a key and X-Clatter-Account?

A key alone isn't enough: every request must also name the account that owns the key in X-Clatter-Account.

• A key that leaks without its Account ID can't be used.
• A key sent with someone else's Account ID is refused with 401 account_mismatch.
• No header at all answers 401 missing_account_id.

It's a small extra step that protects you if a key ends up in a log or a paste. Your Account ID isn't a secret in the same way as the key, but there's no reason to publish it either.

With the OpenAI SDKs, set it once as a default header. See Set up the Python SDK.

Good to know#

• Model ids: supercosmos-flash, supercosmos-max, supercosmos-heavy (SuperCosmos 1.1). Which to call
• If calls fail unexpectedly, check status.clatterlabs.com before debugging further.
• Retry only 429 and 5xx errors, with backoff; honour Retry-After when it's sent. Which errors to retry

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.