Docs / Errors

Errors & Troubleshooting

Error	Cause	Fix
`401 Unauthorized`	API key invalid / expired / disabled	Check the key status in Console, recreate if needed
`403 Forbidden`	Quota exhausted or key blocked	Check usage; wait for reset or upgrade
`404 Not Found`	Wrong Base URL (extra/missing /v1)	Claude Code: no /v1; others: with /v1
`429 Too Many Requests`	Concurrency or window limit hit	Slow down, wait for reset, or upgrade / enable API billing
`500 / 502 / 503`	Transient upstream issue	Usually clears fast; retry
`Connection dropped / Socket closed`	Network jitter or oversized request	Check network, lower concurrency, retry

Most setup issues are a wrong /v1 in the Base URL or a bad key. Check those two first.