Guides
Error codes
This guide includes an overview on error codes you might see from both the API and our official Python library. Each error code mentioned in the overview has a dedicated section with further guidance.
API errors
| Code | Overview | |
|---|---|---|
| 400 - Bad Request | Cause: The request body is invalid. Solution: Ensure your request body is valid. | |
| 401 - No API key provided | Cause: Missing Authorization header.Solution: Ensure you are sending an Authorization header using the Bearer scheme. | |
| 401 - Invalid API key provided | Cause: Incorrect API key inputted. Solution: Make sure your key is prefixed with shuttle- and exact, clear your browser cache, or re-generate your key. | |
| 402 - Premium plan required | Cause: You are trying to access a premium model without a premium plan. Solution: Upgrade your plan to access this model. | |
| 423 - Banned | Cause: You have been banned from accessing the ShuttleAI API. Solution: Contact us for information or if you wish to make an appeal. | |
| 429 - Rate limit exceeded | Cause: You have exceeded your rate limit. Solution: Wait until the next minute to continue using the API. | |
| 429 - Daily limit exceeded | Cause: You have exceeded your daily limit. Solution: Wait until the next day to continue using the API. | |
| 500 - Internal server error | Cause: Server/provider issues. Solution: Retry your request after a brief wait and contact us if the issue persists. Check the status page. | |
| 503 - Service overloaded | Cause: Our servers are experiencing high traffic. Solution: Retry your request after a brief wait and contact us if the issue persists. Check the status page. |