How do I list models with cURL?

No key is needed for the models list.

curl https://api.gateway.clatterlabs.xyz/v1/models

# one model
curl https://api.gateway.clatterlabs.xyz/v1/models/supercosmos-heavy

# just the ids and prices (with jq)
curl -s https://api.gateway.clatterlabs.xyz/v1/models | jq '.data[] | {id, pricing}'

A retired id such as line-code-fast answers 410 model_retired, and an unknown id answers 404 model_not_found.

Set CLATTER_API_KEY (a clsk_ key with models:invoke) and CLATTER_ACCOUNT_ID (your CL- Account ID from Console › Settings) first. Reference: 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
• Retry only 429 and 5xx errors, with backoff; honour Retry-After when it's sent. Which errors to retry
• 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.