Xinghuo AI Gateway

Developer guides · API access

AI API error guide: 401, 403, 404, 429 and 503

Troubleshoot Xinghuo API authentication, model permissions, endpoint mistakes, rate limits and temporary service errors with a concise diagnostic checklist.

Xinghuo AI Gateway · Updated

Record the request time and time zone, HTTP status, endpoint, model and returned error code. Keep a request ID if available. Never publish the Authorization header or complete key.

Start with the status code

StatusCheck firstAction
401Missing, incorrect or expired keyCheck Bearer authentication, whitespace and stale client settings
403Group, model or policy permissionCompare key permissions with the response explanation
404Endpoint or model IDCheck duplicate /v1 and the exact model name
429Concurrency, request rate or quota limitRead the error, reduce concurrency and honor Retry-After when present
502 / 503Temporary service or network failureWait briefly, bound retries and contact support if persistent

What does SVC_1001 mean?

This site error signals temporary service unavailability. It does not by itself establish that your key balance is depleted. Check balance and usage, then share the time, model and request ID with support.

Endpoint errors versus model errors

Use GET /v1/models to inspect key model access. Chat Completions uses POST /v1/chat/completions. Claude Code uses Messages gateway configuration. If a request returns HTML instead of JSON, check for a web URL, login page or proxy error.

Streaming disconnects

Record the received output, duration and client timeout. A disconnect can occur in the client, network or server. Reproduce with shorter input and smaller output, then compare non-streaming behavior. Inspect usage before repeating a long task.

Useful support details

For first-time setup use the quickstart; for costs use the billing guide.

Choose a model. Connect your application.

Check current model access and account pricing, then register and buy the credits you need.

View models & pricing Buy credits Create an account →