Errors

DevLens returns standard HTTP status codes and OpenAI-compatible error objects.

Status codes

Code	Meaning	Description
200	OK	Request succeeded
400	Bad Request	Malformed request — check parameters
401	Unauthorized	Invalid or missing API key
403	Forbidden	Insufficient permissions
404	Not Found	Endpoint does not exist
429	Too Many Requests	Rate limit exceeded or insufficient balance
500	Internal Server Error	Server-side failure
502	Bad Gateway	Upstream provider unavailable
503	Service Unavailable	Temporary outage

Error response format

{
  "error": {
    "message": "Human-readable description",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Common errors

401 — Invalid API Key

{"error": {"message": "Invalid API key", "type": "authentication_error"}}

1. Verify key starts with sk-
2. Confirm key is enabled in Console → API Keys
3. Check header format: Authorization: Bearer sk-xxx

429 — Insufficient Quota

{"error": {"message": "Insufficient quota", "type": "insufficient_quota"}}

1. Add credits via Console → Top Up
2. Check key-level quota limits

400 — Model Not Found

{"error": {"message": "Model not found: xxx", "type": "invalid_request_error"}}

1. Verify the model parameter spelling
2. Query GET /v1/models for available identifiers
3. Confirm the model is accessible with your key