What does model_unavailable mean?

The model is briefly unavailable. Retry after a short wait.

Code: model_unavailable · HTTP status: 502, 503 or 504

This is a temporary condition on our side, not a problem with your key or request.

Common causes#

• a brief interruption in model serving

How to fix it#

1. Retry after Retry-After if present, otherwise with backoff.
2. Check status.clatterlabs.com for an incident.
3. Subscribe to status emails if you run something important on the API.

Should my code retry?#

Retryable with backoff.

The error body uses the OpenAI shape, so OpenAI SDKs raise it as an exception you can catch:

{"error": {"message": "...", "type": "...", "code": "model_unavailable", "param": null}}

Every response also carries an X-Request-Id. Keep it in your logs; it's the quickest way for support to find a request.

See the full list in the Model API reference.

Good to know#

• New accounts get $5 of free credit; top up from $1 to $800 per purchase in Console › Billing › Credits. Billing
• Base URL: https://api.gateway.clatterlabs.xyz/v1, with Authorization: Bearer clsk_... and X-Clatter-Account: CL-... on every call. Quick reference
• Model ids: supercosmos-flash, supercosmos-max, supercosmos-heavy (SuperCosmos 1.1). Which to call

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.