Troubleshooting

Error handling for the current MVP integration path.

Use this page when a request fails and you need a fast decision tree. Start with request path, key state, model status, and account balance before assuming a deeper platform bug.

Errors

Common failure categories

The MVP exposes a narrow surface, so most failures still cluster into a small number of causes.

401 Unauthorized

The request is missing a valid bearer token or the API key is invalid.

Check Authorization header format
Confirm the key was copied correctly
Confirm the key has not been revoked

403 Forbidden

The credential is valid but cannot perform the requested action.

Check whether the route is admin-only
Check current account role in the console
Retry with the expected account

404 Not Found

The request path is wrong or the model code is not exposed by the current route.

Confirm you are calling /chat/completions
Confirm the base URL is correct
Confirm the model code matches the exposed catalog exactly

429 / Balance rejection

The request cannot proceed because credit or limits do not permit it.

Check remaining balance in the console
Reduce request size for validation
Check whether trial credit has been exhausted

Model disabled

The model exists in the catalog but is not currently active.

Open the model catalog
Confirm the status field is active
Switch to another active model for test traffic

Upstream request failure

The request reached the platform but failed during upstream execution or routing.

Capture the request ID
Check Usage Logs in the console
Retry with a smaller prompt and simpler payload

Invalid request body

The JSON shape or required fields are malformed.

Confirm model is present
Confirm messages is a JSON array
Confirm Content-Type is application/json

Fast Path

Minimal troubleshooting order

Check the request path and base URL first.
Check whether the API key is still active.
Check whether the selected model is marked active.
Check remaining balance in the console.
Check Usage Logs for the matching request entry.

Console URL

https://console.anlinkai.com

Primary path

https://api.anlinkai.com/api/v1/chat/completions

https://www.anlinkai.com/faq