Skip to main content
OmniaKey returns protocol-compatible errors where possible, so your existing SDK error handling continues to work.

​
Common status codes

​
Base URL mistakes

Most setup errors come from using the wrong protocol suffix: If Claude Code calls a path like /v1/messages, the base URL should be the bare host. If an OpenAI SDK gets a 404, confirm it includes /v1.

​
Quota errors

A 403 can mean either:
  • the account balance is too low, or
  • the API key’s per-key cap has been reached.
Check both the account balance and the key cap in the Dashboard.

​
Rate limits

OmniaKey supports route-level and model-request throttling, and upstream providers can also return 429 through the relay. Public docs do not publish fixed thresholds because limits can vary by route, account/group configuration, and provider. Treat 429 as a retryable throttling signal: retry with exponential backoff, add jitter, and avoid sending the same burst again immediately.

​
Unsupported endpoints

If an endpoint is not documented in the API Reference, treat it as unsupported for public use. The most common examples are image generation, audio, embeddings, rerank, files, fine-tuning, and batches.