Error Code Reference

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:

  1. Is the Key copied completely (starts with sk-, no extra spaces)
  2. Has the Key been deleted? Verify at API Key Management
  3. 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:

  1. Does the model name exactly match the model marketplace (case-sensitive)
  2. Does the Base URL include the /v1 suffix

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.