Error Codes

HTTP Status Codes

StatusMeaningAction
200Success
400Bad requestCheck your request parameters
401UnauthorizedVerify your API key
403ForbiddenCheck your account permissions
404Not foundVerify the endpoint or model ID
429Rate limit exceededSlow down or upgrade tier
500Server errorRetry after a brief wait
503Service unavailableRetry after a brief wait

Error Types

TypeDescription
invalid_request_errorMalformed request or invalid parameters
authentication_errorInvalid or missing API key
rate_limit_errorExceeded your rate limit
model_not_found_errorSpecified model doesn't exist
context_length_exceededInput exceeds model's context window
content_filter_errorContent blocked by safety policies
server_errorInternal server error

Error Response Format

{
  "error": {
    "message": "Human-readable description",
    "type": "error_type",
    "code": "error_code",
    "param": "parameter_name"
  }
}

Common Errors

invalid_api_key

Status: 401
Message: "Invalid API key provided"

Contact support@linkwo.com to verify your API key.

context_length_exceeded

Status: 400
Message: "This model's maximum context length is 128000 tokens"

Reduce your input length or use max_tokens to limit output.

rate_limit_exceeded

Status: 429
Message: "Rate limit exceeded"

Implement exponential backoff. See Rate Limits.

model_not_found

Status: 404
Message: "Model 'gpt-5' not found"

Check available models at Model Overview.