Your privacy choices

We use essential storage to operate Lexel Translate. With your permission, we also use analytics, advertising, and marketing technologies. Read our Cookie Policy.

Errors & rate limits

Status codes, error envelopes, request throttling, and quota behavior for Lexel Translate API clients.

Common status codes

Field	Type	Required	Description
200	OK	No	Successful request.
201	Created	No	Resource created, such as webhook profile or glossary.
202	Accepted	No	Async job accepted for background processing.
400	Bad Request	No	Invalid payload, unsupported public field, or malformed JSON.
401	Unauthorized	No	Missing or invalid session/API key.
403	Forbidden	No	Authenticated but not allowed for the requested scope or action.
404	Not Found	No	Missing resource or inaccessible resource hidden from caller.
409	Conflict	No	Idempotency mismatch, result not ready, or cancel-state conflict.
410	Gone	No	Expired async job result.
413	Payload Too Large	No	Request body exceeds the route payload limit.
415	Unsupported Media Type	No	Unsupported Content-Type or document upload MIME type.
422	Unprocessable	No	Async job failed without a usable stored result.
429	Too Many Requests	No	Rate limit, quota, or character-limit violation.
500	Server Error	No	Unexpected service failure.

Error response object

json

{
  "ok": false,
  "error": "Premium characters exhausted.",
  "status": 429,
  "request_id": "req_translate_demo_001",
  "quota": {
    "creditType": "premium",
    "membership": "premium",
    "monthlyCharacterQuota": 5000000,
    "monthlyCharacterUsage": 5000000,
    "monthlyBillableCharacterUsage": 0,
    "perRequestCharacterLimit": null
  }
}

Error fields

Field	Type	Required	Description
ok	false	Yes	Error responses set ok to false when using JSON error envelopes.
error	string	Yes	Human-readable error summary.
status	number	No	HTTP status code, repeated in the body.
request_id	string	No	Trace ID when available.
quota	object	No	Quota state included for some limit failures.
trial	object	No	Quota-window state included for applicable browser requests.
missingEnvVars	string[]	No	Service-specific setup errors may include missing environment variables.

API key rate limits

Tier	Max requests	Window
Referral	90	60s
Premium	600	60s

API key rate-limit overrides

Field	Type	Required	Description
apiRateLimitWindowMs	number	No	Optional per-key override for the rate-limit window in milliseconds.
apiRateLimitMaxRequests	number	No	Optional per-key override for max requests per window.
apiRateLimitBonusRequests	number	No	Optional bonus requests added on top of the resolved max for the window.
apiRateLimit.windowMs	number	No	Nested alias for apiRateLimitWindowMs.
apiRateLimit.maxRequests	number	No	Nested alias for apiRateLimitMaxRequests.
apiRateLimit.bonusRequests	number	No	Nested alias for apiRateLimitBonusRequests.

Limits

API translation requires a Premium API key and Premium characters; a request can pass rate limits and still fail quota admission.
Free browser translation is limited to 1,500 characters per 10 seconds.
Signed-out guest browser trial: 10,000 characters total and 1,500 characters per request.
429 responses may include a Retry-After header with the number of seconds to wait before retrying. Back off exponentially when the header is absent.