Error Code Reference
When you encounter errors while calling the API or using the website, check this reference.
401 Unauthorized
Meaning: invalid API Key.
Check:
- Is the Key copied completely (starts with
sk-, no extra spaces) - Has the Key been deleted? Verify at API Key Management
- Is the environment variable active? (reopen the terminal)
403 Forbidden
Meaning: no permission to access the resource.
Check: the Key may be disabled or the IP is restricted. Check Key status at API Key Management.
404 Not Found
Meaning: model not found or wrong path.
Check:
- Does the model name exactly match the model marketplace (case-sensitive)
- Does the Base URL include the
/v1suffix
429 Too Many Requests
Meaning: too many requests — rate limited.
Fix: wait a few seconds and retry; for high-frequency scenarios, add retry logic in your code.
Insufficient Balance
Meaning: your account balance is not enough for this call.
Fix: top up at the recharge page.
500 / 502 / 503
Meaning: temporary server error.
Fix: retry later. If persistent, submit a ticket via My Forms.