XuanShu API

Errors and retry policy

Handle public API errors by status, request idempotency, and backoff policy.

Last verified:

Connection and authentication

Unified OpenAI-compatible Base URL: https://www.xuanshuapi.com/v1

OpenAI-compatible APIs use Authorization: Bearer <YOUR_API_KEY>; Claude Messages also accepts x-api-key: <YOUR_API_KEY>; Gemini v1beta uses x-goog-api-key: <YOUR_API_KEY>.

curl https://www.xuanshuapi.com/v1/models -H "Authorization: Bearer <YOUR_API_KEY>"

Errors and retry policy

Use jittered exponential backoff only for timeouts, 429, and recoverable 5xx responses; do not blindly retry authentication, validation, or balance errors.

Models, multipliers, quota, and usage depend on the current key and console data.

Next steps

Available models, multipliers, quotas, and some advanced capabilities depend on the current key and console configuration.