Endpoints & Rate Limits

Every request to SCX.ai goes to a single base URL over HTTPS — there's no per-region routing to configure.

https://api.scx.ai/v1

https://api.scx.ai/v1

API endpoints

All endpoints are relative to the base URL above.

Request size limits

Each endpoint enforces a maximum request body size. A request over its endpoint's limit is rejected with a 413 before it's processed — retrying the same body can never succeed, so shrink the payload first.

{
  "error": {
    "message": "request body is too large for this endpoint's limit",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "request body is too large for this endpoint's limit",
    "type": "invalid_request_error"
  }
}

Rate limits

Rate limits are enforced per organization and, where a request resolves to a specific model, per model — not per API key or per IP. Three limits apply together:

Your actual RPM/TPM/TPD depend on your organization's plan and can change over time, so they aren't published as a fixed table here — check the usage page for your current limits, or read them straight off the response headers on any request:

Exceeding any of the three returns a 429:

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error"
  }
}

On a 429, back off and retry — the same request will succeed once the window resets.

Spend limits

Spend can be capped at three levels: an API key, a member of the organization, and the organization as a whole. A request is refused by whichever budget it reaches first, checked from the narrowest: the key, the key's budget for the requested model, the member, then the organization. Budgets count usage paid from your credit balance; they don't cap usage covered by a subscription or invoiced separately.

On a request that goes through, these headers report whichever of your own budgets has less left, your key's or your member budget:

They are omitted when neither your key nor your membership has a budget, and they never report the organization's budget on a request that goes through.

A request over a budget returns a 429 whose code names the budget that refused it, with the headers describing that budget:

{
  "error": {
    "message": "Member budget exceeded",
    "type": "quota_exceeded",
    "code": "member_budget_exceeded"
  }
}

{
  "error": {
    "message": "Member budget exceeded",
    "type": "quota_exceeded",
    "code": "member_budget_exceeded"
  }
}

Unlike a rate limit, retrying won't succeed until the budget's period resets or the budget is raised.

Errors and status codes

Every error response follows the same shape:

{
  "error": {
    "message": "human-readable description",
    "type": "error_type"
  }
}

{
  "error": {
    "message": "human-readable description",
    "type": "error_type"
  }
}