Errors & Status Codes
Every status code EasyJev returns: the unified error JSON shape with request_id, the full code table (400/401/402/403/404/413/422/429/502), retry guidance and upstream pass-through semantics.
The unified error shape
Gateway-originated failures (auth, quota, rate limit, upstream exhaustion…) all return this JSON envelope on /v1/* paths. Upstream validation errors are the exception — they pass through unchanged (see the systemone page).
{
"error": {
"message": "Balance is not enough to make this call",
"type": "insufficient_quota",
"code": "insufficient_quota"
},
"request_id": "8f14e45fceea167a5a36dedd4bea2543"
}Status codes
| HTTP | type | code | Meaning / what to do |
|---|---|---|---|
| 400 | invalid_request_error | upstream pass-through | Upstream rejected the request body. Read the upstream message; not billed. |
| 401 | authentication_error | invalid_api_key | Missing/wrong Bearer key. Check the sk- value; a disabled key also lands here. |
| 402 | insufficient_quota | insufficient_quota | Balance is zero/negative. Top up, then retry. |
| 403 | authentication_error | account_suspended / key_disabled | Account or key disabled — contact support. |
| 404 | invalid_request_error | model_not_found | Model not on sale (or typo). List valid names via GET /v1/models. |
| 413 | invalid_request_error | payload_too_large / media_too_large | Request over size limits — shrink the body or split the asset. |
| 422 | invalid_request_error | bad_request (gateway) / upstream pass-through | Missing model/state/questions, or upstream schema rejection. |
| 429 | rate_limit_error | rate_limit_exceeded | Per-key RPM/TPM hit. Back off (the limit resets inside a minute) and retry. |
| 502 | api_error | upstream_failed | All channel+key attempts failed after failover. Safe to retry with backoff; contact support with request_id if it persists. |
Retry guidance
RETRY
Retry safely on 429 (after backing off — the sliding window frees capacity within a minute) and 502 (failover was exhausted; transient upstream issues are common). Do not blind-retry 400/401/402/403/404/413/422 — the request itself must change first. Every retry carries a fresh request_id, so reconciliation stays clean.