SeaLink
← Docs

Error codes

SeaLink's HTTP error codes and how to recover. Error body shape matches OpenAI's.

CodeTypeMeaningHow to fix
400invalid_request_errorMalformed request body or missing required field.Verify JSON validity and required fields (model, messages).
401auth_errorAPI key missing, malformed, or revoked.Re-copy the key from your dashboard. Confirm Authorization: Bearer <key>.
402insufficient_balanceAccount balance exhausted or per-key monthly budget reached.Top up via /pricing or raise the key's monthly budget in /dashboard/keys.
403model_not_allowedThe model is not in this key's whitelist.Edit the key whitelist to include the model, or use a key with broader access.
404model_not_foundUnknown model id.Check spelling on /models or via GET /v1/models.
408request_timeoutUpstream model didn't respond in time.Retry with exponential backoff. Consider switching to a faster model on retry.
413context_length_exceededInput too long for the model's context window.Trim history, switch to a longer-context model (kimi-k2, claude-opus-4-7).
429rate_limit_exceededToo many requests for this account or key per minute.Implement exponential backoff (start at 1s, jitter, cap at 60s). Upgrade plan for higher RPM.
500internal_errorUnexpected error inside SeaLink.Check status.sealink.asia. Retry once. If persistent, report to support.
502upstream_errorUpstream provider returned an error.SeaLink's automatic fallback usually kicks in. Manual retry; consider an alternative model.
503service_unavailableSeaLink proxy or LiteLLM tier temporarily unavailable.Check the status page. Most issues clear within minutes.
504gateway_timeoutSeaLink couldn't reach upstream within timeout.Retry. If repeated, switch to another model in the same tier.