How should my app degrade if Heavy is slow or busy?

• Stream Heavy replies so users see progress.
• Set a timeout that fits your product; if Heavy runs past it or answers model_overloaded, retry the same request on Max (or Flash).
• Tell the user when you've fallen back, if quality matters to them.
• Log fallbacks to see how often they happen.

All tiers share the same window and message format, so the fallback request is identical apart from the model id.

Good to know#

• If calls fail unexpectedly, check status.clatterlabs.com before debugging further.
• Your key's account is responsible for your end users' text under the Abuse policy. What it means for apps
• Base URL: https://api.gateway.clatterlabs.xyz/v1, with Authorization: Bearer clsk_... and X-Clatter-Account: CL-... on every call. Quick reference

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.