How do I see rate limit and request id headers with cURL?

-i prints the status line and headers before the body.

curl -i https://api.gateway.clatterlabs.xyz/v1/chat/completions \
  -H "Authorization: Bearer $CLATTER_API_KEY" \
  -H "X-Clatter-Account: $CLATTER_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{"model": "supercosmos-flash", "messages": [{"role": "user", "content": "Hi"}]}'

Look for x-request-id, x-ratelimit-limit, x-ratelimit-remaining, and on a 429 retry-after. If a request earned an abuse warning you'll also see x-clatter-notice: abuse_warning.

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#

• Every call shows in Console › Logs and Usage as Model API, with its price. See what you spent
• New accounts get $5 of free credit; top up from $1 to $800 per purchase in Console › Billing › Credits. Billing
• Keep keys on your server, never in a browser or mobile app. Why

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.