Resources
Troubleshooting
Practical checks for common API errors and client configuration issues.
401 / API error
Authentication
- Check that the Authorization header uses Bearer authentication.
- Check that the key is active.
- Remove additional spaces around the key.
- Confirm that you are using the correct Aonis endpoint.
503 / model_not_found
Model unavailable
- Check that the model ID is correct.
- Check the Models page for currently available models.
- Retry with backoff only if temporary availability is expected.
429 / API error
Rate limited
Wait before retrying, use exponential backoff, and avoid retrying the same request in a tight loop.
View error details →403 / insufficient_user_quota
Insufficient balance
Open the dashboard and verify your available balance before sending another request.
Billing guide →Client configuration
Tool and client setup issues are separate from API error responses.