Frequently Asked Questions

The API returns 401

Confirm the request includes Authorization: Bearer YOUR_API_KEY. Check whether the key is incomplete, deleted, or surrounded by extra whitespace.

The API returns 403

Check the key group, model permissions, and network policy. If the response is a security service block page instead of JSON, test again from a normal network.

The API returns 404

Verify the Base URL, endpoint path, exact model ID, and whether the model supports the selected protocol.

The API returns 429

Possible causes include insufficient balance, concurrency limits, rate limits, or temporary upstream load. Use backoff instead of retrying indefinitely and check dashboard usage.

A CLI ignores the new configuration

Environment variables usually apply only to the current terminal and its child processes. Open a new terminal and confirm the CLI is not loading another stale configuration file.

What should a support report include?

Provide the time, request path, HTTP status, error response, and client version. Remove API keys, account details, and sensitive request content.